web-searchlisted
Install: claude install-skill hec-ovi/websearch-skill
# 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