About ask-search
ask-search is a command-line web search skill for agents, powered by a locally running SearxNG instance. It aggregates search engines and supports language, category, result-count, and output-format options without an API key.
Key features
- 01Search across selected engines
- 02Filter by language and category
- 03Limit result count
- 04Output JSON or URLs
Use cases
- 01Find current web information for an agent
- 02Search news or science topics
- 03Pass result URLs to web_fetch
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ ythx-101/ ask-search --skill ask-searchAfter installing, type/ask-searchin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
.gitignoreLICENSEinstall.shREADME.mdmcp/server.pyscripts/core.pysearxng/.env.examplesearxng.ymldocker-compose.ymlDetails
From the project READMEask-search
Web search powered by SearxNG. Aggregates multiple search engines, zero API key, full privacy.
Usage
ask-search "your query" # top 10 results
ask-search "query" --num 5 # limit results
ask-search "AI news" --categories news # news only
ask-search "query" --lang zh-CN # Chinese results
ask-search "query" --urls-only # URL list (pipe to web_fetch)
ask-search "query" --json # raw JSON
Agent Workflow
- Run
ask-search "topic"to get candidates - Check snippet — if enough, answer directly
- If snippet truncated, use
web_fetchon the URL for full content
Parameters
| Flag | Short | Description |
|---|---|---|
--num N | -n | Max results (default 10) |
--engines | -e | google,bing,duckduckgo,brave |
--lang | -l | zh-CN, en, ja, ko |
--categories | -c | general,news,images,science |
--json | -j | Raw JSON output |
--urls-only | -u | URLs only |
Setup
Requires SearxNG running locally. Set SEARXNG_URL if not on default port 8080.
Comments
Markdown supported