web-search

# web-search Search the web and read pages. If the MCP tools (`web_search`, `web_fetch`, `web_open`, `arxiv_search`, `github_search`) are registered, prefer them; they take the same arguments and return the same output. Otherwise run the `websearch` CLI and read its stdout. Everything is keyless: no setup, no API key. Run `websearch <command>` if it is on PATH; otherwise `uvx websearch-skill <command>` (needs only [uv](https://docs.astral.sh/uv/)); from a clone, `uv run websearch <command>`. Default output is a compact human view; add `--json` for the structured Envelope `{ contract_version, ok, data, error, meta }`. Exit 0 on success, 1 on an error Envelope (`error.code`, `error.message`). ## Commands ### web-search: find pages ``` websearch web-search "<query>" [--max-results 8] [--detail concise|detailed] [--freshness any|day|week|month|year] [--site HOST] [--language en] [--country us] [--safesearch off|moderate|strict] [--offset 0] [--searxng-url URL] [--json] ``` Ranked, deduplicated results across many engines at once. Each result has a `url` and a human-readable `handle` (e.g. `en.wikipedia.org~3a1f9c2b5e6f`). `--detail detailed` adds contributing engines and the fused score. `--site HOST` restricts to one host, and is the only keyless way to find Reddit or X content (`--site reddit.com`, `--site x.com`). One ranked page per query: the keyless backends do not page reliably, so refine the query rather than paging. `--max-results 0` returns everything the ...