← Back to Skills Marketplace
michaelasper

Kagi

by michaelasper · GitHub ↗ · v0.1.0
cross-platform ⚠ suspicious
1480
Downloads
0
Stars
5
Active Installs
1
Versions
Install in OpenClaw
/install kagi
Description
Perform web searches and generate summarized answers with citations using the Kagi API and FastGPT for higher-quality results or rate-limit fallback.
README (SKILL.md)

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='…'
  1. Run a search:
python3 scripts/kagi_search.py "haaps glass" --limit 10 --json
  1. 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 "\x3Cquery>" [--limit N] [--json]

Notes:

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

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 "\x3Cquestion>" [--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
Usage Guidance
This skill appears to be a legitimate Kagi API client, but the package metadata fails to declare the required API token. Before installing: 1) Treat the KAGI_API_TOKEN as a secret — the scripts will send it to https://kagi.com/api/v0, which is expected for this skill. 2) Prefer the author update the skill metadata to list KAGI_API_TOKEN (and mark it as the primary credential) so automated permission checks are accurate. 3) Review the included scripts yourself (they are short and readable) to confirm there are no extra endpoints or unexpected behavior. 4) Use a token with limited scope if possible and rotate it if you test the skill on sensitive systems. If you cannot or do not want to provide an API token, do not install/use the skill.
Capability Analysis
Type: OpenClaw Skill Name: kagi Version: 0.1.0 The skill bundle is benign. It provides Python scripts to interact with the Kagi API for search and FastGPT functionality. The code correctly retrieves the Kagi API token from environment variables (`KAGI_API_TOKEN` or `KAGI_API_KEY`) and makes network requests exclusively to the legitimate Kagi API endpoint (`https://kagi.com/api/v0`). There is no evidence of data exfiltration, malicious execution, persistence mechanisms, or prompt injection attempts in `SKILL.md` or other files. All actions are aligned with the stated purpose of using the Kagi API.
Capability Assessment
⚠ Purpose & Capability
The included Python scripts and SKILL.md clearly implement a Kagi Search + FastGPT client (calling https://kagi.com/api/v0). That matches the implied purpose, but the skill metadata declares no required environment variables or primary credential even though the code requires a KAGI_API_TOKEN (and also accepts KAGI_API_KEY as a fallback). The missing declaration is an incoherence between purpose and declared requirements.
ℹ Instruction Scope
SKILL.md instructs the user to export KAGI_API_TOKEN and run the provided scripts; the runtime instructions stay within the advertised scope (making HTTP calls to the Kagi API and printing/summarizing results). There is no instruction to read unrelated files or contact endpoints other than kagi.com. Note: the instructions assume an API token even though metadata doesn't list it.
✓ Install Mechanism
This is an instruction-only skill with small local Python scripts and no install spec or external downloads. No archive extraction or remote installers are used, which minimizes install risk.
⚠ Credentials
Although the only secret the code needs is the KAGI_API_TOKEN (reasonable for this purpose), the skill metadata lists zero required env vars and no primary credential. The code also accepts an alternate env name (KAGI_API_KEY). The omission in metadata is a discrepancy that could confuse users and permissioning systems; otherwise the requested credential is proportional to the skill's functionality and is only sent to Kagi's API.
✓ Persistence & Privilege
Skill flags are normal (not always:true). The skill does not request persistent system privileges, modify other skills, or write installers; it simply contains local scripts invoked at runtime.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install kagi
  3. After installation, invoke the skill by name or use /kagi
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Kagi skill v0.1.0 - Initial release: Integrates Kagi Search API and FastGPT for enhanced web research. - Provides Python scripts for both ranked search results and LLM-powered web answers with citations. - Supports programmatic web search and summarization via command-line interface. - Includes setup instructions for API token usage and example commands. - Suggested as an alternative when Brave Search is rate-limited or higher-quality results are needed.
Metadata
Slug kagi
Version 0.1.0
License —
All-time Installs 5
Active Installs 5
Total Versions 1
Frequently Asked Questions

What is Kagi?

Perform web searches and generate summarized answers with citations using the Kagi API and FastGPT for higher-quality results or rate-limit fallback. It is an AI Agent Skill for Claude Code / OpenClaw, with 1480 downloads so far.

How do I install Kagi?

Run "/install kagi" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Kagi free?

Yes, Kagi is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Kagi support?

Kagi is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Kagi?

It is built and maintained by michaelasper (@michaelasper); the current version is v0.1.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments