README.md
August 14, 2026 · View on GitHub
QueryTool
A standalone HTML tool for building OSINT queries and opening a hand-picked source catalogue.
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.
- 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.
| Field | Purpose |
|---|---|
ID | Stable source identifier. |
Category, Subcategory, Source | Catalogue organization and visible labels. |
Target, Access | Expected input and access model. |
URL Base, URL Suffix | Link construction. |
Notes | Maintenance notes, excluded from the application. |
Date Added | ISO 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:
| Command | Purpose |
|---|---|
npm run serve | Serve the local app on port 4173. |
npm run sync-sources | Regenerate the CSV copy and embed the catalogue in querytool.html. |
npm run check | Check XLSX, CSV, and application parity. |