local-websearch · diff
git:20260208.f4dac20 to git:20260228.de55159
24 added, 47 removed. Audit A to A.
---
- name: searxng
- description: Search the web using a self-hosted SearXNG metasearch engine. Aggregates Google, Brave, DuckDuckGo, and more without API keys.
- homepage: https://docs.searxng.org
- metadata: {"cowork":{"emoji":"🔍","requires":{"bins":["python3"],"env":["SEARXNG_URL"]}}}
+ name: local-websearch
+ description: "Search the web privately via a self-hosted SearXNG metasearch engine."
---
- # SearXNG Web Search
-
- Privacy-respecting metasearch via your self-hosted SearXNG instance.
-
- ## When to use (trigger phrases)
+ # local-websearch
- Use this skill when the user asks:
- - "search the web for..."
- - "look up..." / "find information about..."
- - "what is..." (when current info needed)
- - "research..." / "search for..."
- - "google..." (redirect to privacy-respecting search)
+ ## Purpose
- ## Quick start
+ Search the web privately via a self-hosted SearXNG metasearch engine.
- ```bash
- python3 "$HOME/Library/Application Support/cowork-os/skills/searxng/scripts/searxng_search.py" "your query"
- python3 "$HOME/Library/Application Support/cowork-os/skills/searxng/scripts/searxng_search.py" "query" --count 10
- python3 "$HOME/Library/Application Support/cowork-os/skills/searxng/scripts/searxng_search.py" "query" --lang de
- ```
+ ## Routing
- ## Setup
+ - Use when: Use when users ask for web lookup, private browsing, or recent facts not in local files.
+ - Do not use when: Don't use for internal workspace-only questions already covered by local docs or files.
+ - Outputs: Structured search results with titles, URLs, and snippets.
+ - Success criteria: Returns concise results with enough context to support a cited answer.
- Set `SEARXNG_URL` environment variable:
- ```bash
- export SEARXNG_URL="http://your-searxng-host:8888"
- ```
+ ## Trigger Examples
- ## Flags
+ ### Positive
- | Flag | Default | Description |
- |------|---------|-------------|
- | `-n`, `--count` | 5 | Results to return (1-20) |
- | `-l`, `--lang` | auto | Language code (en, de, fr, es, etc.) |
+ - Use the local-websearch skill for this request.
+ - Help me with local-websearch.
+ - Use when users ask for web lookup, private browsing, or recent facts not in local files.
+ - local-websearch: provide an actionable result.
- ## Output
+ ### Negative
- Returns JSON:
- ```json
- {
- "query": "search terms",
- "count": 5,
- "results": [
- {"title": "...", "url": "...", "description": "...", "engines": ["google", "brave"], "score": 1.5}
- ]
- }
- ```
+ - Don't use for internal workspace-only questions already covered by local docs or files.
+ - Do not use local-websearch for unrelated requests.
+ - This request is outside local-websearch scope.
+ - This is conceptual discussion only; no tool workflow is needed.
- ## Notes
+ ## Runtime Prompt
- - No API keys needed—SearXNG aggregates upstream engines
- - Results include source engines for transparency
- - Scores indicate relevance (higher = better)
- - For news, add "news" to query or use `--lang` for regional results
+ - Current runtime prompt length: 1364 characters.
+ - Runtime prompt is defined directly in `../local-websearch.json`.