# Ask Search

> Web search via self-hosted SearxNG. Aggregates Google, Bing, DuckDuckGo, Brave. Returns title/url/snippet. Zero API key required. Use when this capability is needed.

- Skill: `tomevault-io/ask-search` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/ask-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/ask-search/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/ask-search

---


# ask-search

Web search powered by [SearxNG](https://github.com/searxng/searxng). Aggregates multiple search engines, zero API key, full privacy.

## Usage

```bash
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

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

---
> Source: [ythx-101/ask-search](https://github.com/ythx-101/ask-search) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-17 -->