# OSINT Search Query Builder

> Prepare focused public-web searches without submitting them. Create exact-phrase, PDF and optional domain-restricted search queries from a phrase and optional exclusion.

Part of usefulweb.app (https://usefulweb.app/). Results are deterministic calculations from the inputs and the listed assumptions; the API returns exactly what the web page shows.

## Use it
- Human interface: https://obscuriqsearchquerybuilder.usefulweb.app/ (interactive tool at https://obscuriqsearchquerybuilder.usefulweb.app/tool)
- JSON API: POST https://obscuriqsearchquerybuilder.usefulweb.app/api/v1/calculate with a JSON object of inputs (schema: https://obscuriqsearchquerybuilder.usefulweb.app/api/v1/tool)
- OpenAPI: https://obscuriqsearchquerybuilder.usefulweb.app/openapi.json
- MCP (Streamable HTTP): https://obscuriqsearchquerybuilder.usefulweb.app/mcp - tool `obscuriq_search_query_builder`

## Inputs
- subject (text): Exact phrase - Enter a phrase without quotation marks.
- domain (text): Restrict one query to this domain (optional)
- exclude (text): Exclude this phrase (optional)

## Method
- Wrap the phrase in quotation marks and optionally add a quoted exclusion.
- Produce exact phrase and filetype:pdf variations; add a site: query when a hostname is supplied.

## Limits
- Search engines differ in operator support and indexing. Results may be incomplete or stale; a query is a lead, not verification. Submitting a query to an external service reveals it to that service.