mcpField
A
ask-search

ask-search

github.com/ythx-101Productivity53854 installsUpdated 31w ago
Repository

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

  1. 01Search across selected engines
  2. 02Filter by language and category
  3. 03Limit result count
  4. 04Output JSON or URLs

Use cases

  1. 01Find current web information for an agent
  2. 02Search news or science topics
  3. 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-search

After installing, type/ask-searchin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.gitignore
LICENSE
install.sh
README.md
mcp/
server.py
scripts/
core.py
searxng/
.env.example
searxng.yml
docker-compose.yml

Details

From the project README

ask-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

  1. Run ask-search "topic" to get candidates
  2. Check snippet — if enough, answer directly
  3. If snippet truncated, use web_fetch on the URL for full content

Parameters

FlagShortDescription
--num N-nMax results (default 10)
--engines-egoogle,bing,duckduckgo,brave
--lang-lzh-CN, en, ja, ko
--categories-cgeneral,news,images,science
--json-jRaw JSON output
--urls-only-uURLs only

Setup

Requires SearxNG running locally. Set SEARXNG_URL if not on default port 8080.

Comments

Markdown supported