AgentSkillsCN

Search

搜索

SKILL.md

search

Web search skill — query the web and get results back as text or JSON.

CLI

  • Type: custom script
  • Binary: skills/search/search.sh
  • Install: none — uses curl + python3

Infrastructure

  • SearXNG running in Docker on jacks-server, port 8888
  • Started with: docker run -d --name searxng -p 8888:8080 -v skills/search/searxng-config:/etc/searxng --restart unless-stopped searxng/searxng:latest
  • Config: skills/search/searxng-config/settings.yml

Backend

Swappable via --backend flag or SEARCH_BACKEND env var:

BackendDescriptionDefault
searxngSelf-hosted SearXNG at localhost:8888
ddgDuckDuckGo Lite scrape (fallback)

To swap the SearXNG instance:

bash
export SEARXNG_INSTANCE=http://localhost:8888  # default

To use DDG instead:

bash
search "query" --backend ddg
# or permanently:
export SEARCH_BACKEND=ddg

Commands

bash
# Basic search
search <query>

# Limit results (default: 5)
search <query> --results 3

# JSON output
search <query> --format json

# Use DDG fallback
search <query> --backend ddg

Depends On

  • Docker (for SearXNG container)
  • curl
  • python3 (stdlib only)

Notes

  • Public SearXNG instances rate-limit server IPs aggressively — self-hosting avoids this entirely
  • DDG also blocks server IPs, use only as last resort
  • SearXNG aggregates Google, Bing, DDG simultaneously