Free web search for your agent, if you'll run SearxNG
ask-search wraps a self-hosted SearxNG instance so Claude Code, OpenClaw or any shell can search Google, Bing and friends without paying for a search API.
What it does It’s a small Python CLI plus an MCP server that turns a SearxNG instance into a search tool for AI agents. SearxNG aggregates Google, Bing, DuckDuckGo, Brave and more; ask-search returns titles, URLs and snippets in a format agents can actually consume. It ships as a plain command for Claude Code and any shell, an MCP server for Antigravity, and a skill for OpenClaw. Tavily is available as an opt-in backend if you’d rather not run SearxNG.
The interesting bit The honest part of the README is the deep-dive section: search always works because SearxNG queries the engines’ indexes, not the target sites — but fetching full pages from a VPS gets blocked by Reddit, Zhihu and friends. The suggested workarounds (SSH SOCKS tunnels through a residential IP, archive caches, splitting search and fetch across machines) are more useful than the tool itself.
Key highlights
- No search API key or per-query fees in the default SearxNG mode; queries leave from your own server’s IP, not a third-party API’s.
- Flags for result count, news category, language, engine selection, URLs-only and raw JSON output.
- MCP tools:
web_search,web_search_news, andweb_search_tavily. - Bundled Docker Compose setup and
settings.ymlfor SearxNG, withjsonoutput pre-enabled. - Unit tests included, stdlib-only, no network required.
Caveats
- You’re maintaining a SearxNG container; SearxNG’s bot limiter can 403 your own requests until you whitelist your IP in
limiter.toml. - In Tavily mode,
--engines,--langand--categoriesare ignored. - Not tested on native Windows — the installer is bash, so it’s WSL territory.
Verdict Worth it if you already run your own infrastructure and want your agent’s searches off the metered API treadmill. If you want answers rather than result lists — or can’t be bothered running SearxNG — look elsewhere; this is deliberately a thin, minimal layer.
Frequently asked
- What is ythx-101/ask-search?
- ask-search wraps a self-hosted SearxNG instance so Claude Code, OpenClaw or any shell can search Google, Bing and friends without paying for a search API.
- Is ask-search open source?
- Yes — ythx-101/ask-search is open source, released under the MIT license.
- What language is ask-search written in?
- ythx-101/ask-search is primarily written in Python.
- How popular is ask-search?
- ythx-101/ask-search has 537 stars on GitHub.
- Where can I find ask-search?
- ythx-101/ask-search is on GitHub at https://github.com/ythx-101/ask-search.