README.md

August 14, 2026 · View on GitHub

QueryTool

A standalone HTML tool for building OSINT queries and opening a hand-picked source catalogue.

Sources: 178 Single-file: HTML Installation: none Dependencies: none Last update: 2026-08-14

Quick start · Source catalogue · Development

About

QueryTool is a standalone HTML file for building queries, filtering sources, and opening links in new tabs.

It is not meant to be a huge OSINT catalogue. The selection is subjective and focused on sources useful in everyday work.

QueryTool interface with recently added OSINT sources

  • Build Google-style queries with site:, filetype:, intitle:, inurl: and exclusions.
  • Filter sources by category, target type, subcategory, access model, and availability.
  • Select several sources and open matching links in separate browser tabs.
  • Import or export a browser session as JSON.

Quick start

Download or clone the repository, then open querytool.html in a modern browser. No installation, build step, server, or configuration is needed.

The source catalogue is built into the HTML file, so it works offline until you open a source link.

Source catalogue

data/querytool_sources.xlsx is the main catalogue. It contains one Sources table with 178 records for filtering, sorting, and editing. data/querytool_sources.csv is its generated UTF-8 copy for other tools.

FieldPurpose
IDStable source identifier.
Category, Subcategory, SourceCatalogue organization and visible labels.
Target, AccessExpected input and access model.
URL Base, URL SuffixLink construction.
NotesMaintenance notes, excluded from the application.
Date AddedISO date (YYYY-MM-DD). Sources from the last 30 days receive a NEW marker in the app.

Set Date Added for every new row before synchronizing the catalogue.

After editing the catalogue, synchronize and validate:

npm run sync-sources && npm run check

Development

Run these commands only when editing the source catalogue or the interface:

CommandPurpose
npm run serveServe the local app on port 4173.
npm run sync-sourcesRegenerate the CSV copy and embed the catalogue in querytool.html.
npm run checkCheck XLSX, CSV, and application parity.