name: kagi description: Use the Kagi API (Search API + FastGPT) for web research when you want higher-quality results than Brave/Google, or when Brave Search is rate-limited. Triggers: “search with Kagi”, “Kagi search”, “use FastGPT”, “Kagi FastGPT”, “Kagi summarize”, or when you want programmatic web search via Kagi’s API token.

Kagi (API)

Use the bundled Python scripts to call Kagi’s API from the OpenClaw host.

Quick start

1. Create a token in https://kagi.com/settings/api
2. Export it for your shell/session:

export KAGI_API_TOKEN='…'

3. Run a search:

python3 scripts/kagi_search.py "haaps glass" --limit 10 --json

4. Or ask FastGPT (LLM + web search):

python3 scripts/kagi_fastgpt.py "Summarize the latest Haaps glass mentions" --json

Tasks

1) Web search (Kagi Search API)

Use when you need a normal ranked list of results (URLs/titles/snippets).

Command:

python3 scripts/kagi_search.py "<query>" [--limit N] [--json]

Notes:

• Defaults to printing a readable digest; use --json for raw API output.
• The script automatically sets Authorization: Bot <token>.

2) Answer/summarize with citations (FastGPT)

Use when you want a short answer grounded in web results, including reference URLs.

Command:

python3 scripts/kagi_fastgpt.py "<question>" [--cache true|false] [--json]

3) Using Kagi as a drop-in for web_search

If Brave Search is rate-limited (429) or you want better results:

• Use scripts/kagi_search.py to fetch results
• Then use the main agent model to synthesize / summarize based on the returned URLs/snippets

Files

• API reference snippets: references/kagi-api.md
• Python client + CLIs: scripts/kagi_client.py, scripts/kagi_search.py, scripts/kagi_fastgpt.py