kagi-tools-guide

Guides selection and usage of the 14 kagi-tools Hermes plugin tools with auth and fallback patterns.

10|2|Updated May 6, 2026
One-click install
npx skills add https://github.com/jcrabapple/hermes-skills --skill kagi-tools-guide-jcrabapple
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: kagi-tools-guide
Source: https://github.com/jcrabapple/hermes-skills/tree/main/kagi-tools-guide
Command: npx skills add https://github.com/jcrabapple/hermes-skills --skill kagi-tools-guide-jcrabapple

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? The kagi-tools Hermes plugin exposes 14 different tools, and choosing the wrong one wastes time or hits auth errors. This Skill maps each tool to its intended use case, documents the authentication model, and provides fallback patterns when tools fail or return no results. ## Core Features & Use Cases - Tool Selection Guidance: Explains when to use kagi_search, kagi_quick, kagi_ask_page, kagi_assistant, kagi_translate, kagi_summarize, kagi_news, and kagi_smallweb based on the task. - Auth Model Reference: Documents which tools need KAGI_SESSION_TOKEN, which need KAGI_API_TOKEN, and which are public. - Known Issues & Fallbacks: Covers deprecated v0 endpoints (kagi_fastgpt, kagi_enrich_web, kagi_enrich_news), the Bot vs Bearer auth header quirk, and step-by-step fallback chains when searches fail. - Use Case: When a search returns no results, follow the documented fallback chain: try kagi_quick for a synthesized answer, then kagi_assistant with web access, then browser tools. ## Quick Start Ask the agent to search Kagi for a topic and it will pick the right kagi-tools plugin tool based on this guide.

Frequently Asked Questions about kagi-tools-guide

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I choose between kagi_search and kagi_quick?▼

Use kagi_search as the primary search tool when you need filtered results by region, time window, lens, or verbatim matching. Use kagi_quick for single-answer factual queries where you want a concise AI answer with cited references.

What Kagi tools work without an API token?▼

kagi_news, kagi_news_categories, and kagi_smallweb are public and always available without authentication. All other tools require KAGI_SESSION_TOKEN set as an environment variable.

Why do kagi_fastgpt and kagi_enrich_web return errors?▼

These tools call deprecated Kagi v0 API endpoints that no longer accept new JWT-format API keys. Kagi's v1 API only offers /search and /extract, so use kagi_search or kagi_quick instead.

What should I do when kagi_search returns no results?▼

Follow the documented fallback chain: first try kagi_quick for a synthesized answer from live results, then kagi_assistant with web_access=true for a research conversation, and finally fall back to browser tools for direct page inspection.

How do I fix Kagi authentication errors?▼

Verify KAGI_SESSION_TOKEN is set in the environment for session-token tools, or KAGI_API_TOKEN in ~/.hermes/.env for API-token tools. Test the API token directly with a curl request to https://kagi.com/api/v1/search using a Bearer authorization header.