qry Search Skill

qry routes search queries through pluggable adapter binaries and always outputs JSON.

Check availability

qry --agent-info   # prints tool description + your current config as JSON

If qry is not found, install it and at least one adapter:

# Install qry
mise use -g go:github.com/justestif/qry@latest && mise reshim

# Install an adapter (no API key required)
mise use -g go:github.com/justestif/qry/adapters/ddg-scrape@latest && mise reshim

See the qry README for all available adapters and config.

Core usage

# Basic search
qry "your query here"

# Limit results (default from config, usually 5–10)
qry --num 5 "your query"

# Force a specific adapter (bypass routing)
qry --adapter ddg-scrape "your query"

# Merge results from all pool adapters
qry --mode merge "your query"

Output format

first mode (default) — array of results:

[
  { "title": "...", "url": "https://...", "snippet": "..." }
]

merge mode — object with results (and optional warnings):

{
  "results": [{ "title": "...", "url": "https://...", "snippet": "..." }],
  "warnings": ["brave-api failed: rate_limited — results may be incomplete"]
}

Tips

• Be specific — "python requests post json body example" beats "python http"
• Version lookups — "numpy latest release site:pypi.org"
• Error messages — wrap in quotes: qry '"ModuleNotFoundError: No module named X"'
• Docs — "site:docs.python.org pathlib" gives cleaner results
• After searching — fetch the most relevant URL for full content: curl -s <url> | cat
• Partial failures in merge mode are non-fatal — results from successful adapters are returned alongside warnings