Hermes Kagi Plugin

What Hermes Kagi Plugin does

Hermes Kagi Plugin registers a Kagi provider for Hermes's web search and extraction. web_search is routed through Kagi's v1 search API, and URL content extraction uses the v1 extract API, which returns full page content as markdown. Both can use Kagi through web.backend, or you can split them with search_backend and extract_backend. Kagi has no crawl endpoint, so crawl is not supported.

The extra kagi_enriched_search tool exposes data that the standard Hermes web_search contract strips out. It accepts a query, a workflow (search, images, videos, news or podcasts), a limit from 1 to 100 that defaults to 10, and an include_enrichment flag. The response includes web results plus infoboxes, adjacent questions, direct answers, related searches and other categories, and empty categories are omitted. The README explains that the official kagimcp server targets Kagi's v0 API with a separate key scope, whereas this plugin uses the v1 API and the same key used for /api/v1/extract.

Key features

• web_search routed through Kagi's v1 search API
• URL extraction through the v1 extract API, returning page content as markdown
• kagi_enriched_search tool with workflow, limit and include_enrichment parameters
• Separate search_backend and extract_backend settings
• Plugin manifest of kind backend with a KAGI_API_KEY environment variable

When to use it

• Using Kagi as the web search backend for Hermes Agent
• Pulling infoboxes, adjacent questions and related searches into an agent's research
• Searching images, videos, news or podcasts through a single enriched tool

Who it is for: Hermes Agent users with a Kagi API key who want Kagi to power web search and page extraction.

How it fits with Hermes Agent

A Hermes Agent plugin that replaces the default web search and extract backends and adds one extra tool.

How to install Hermes Kagi Plugin

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

cd ~/.hermes/plugins
git clone https://github.com/fastfinge/hermes-kagi-plugin.git web-kagi

Requirements: Hermes Agent (tested on 2025.x, should work on newer), a Kagi API key with v1 access, and httpx, which Hermes already pulls in

Note: Kagi does not expose a crawl endpoint, so the plugin supports search and extract but not crawl.

FAQ