@taylorsatula/pi-kagi-search

Kagi Search tools for Pi — high-quality web search with no ads and no tracking, exposed as first-class LLM tools.

What it does

Registers two tools:

• kagi_search — full web search via Kagi's premium Search API. Returns organic results with titles, URLs, and snippets. Intended as the agent's primary web research tool (people searches, business verification, public records, general lookup). Supports site: operators and a max_results parameter (default 10, max 50).
• kagi_quick_search — concise answers for factual lookups (dates, definitions, how-tos). Returns Kagi's direct-answer text when available, otherwise the top 5 search results.

Installation

pi install npm:@taylorsatula/pi-kagi-search

Or add to ~/.pi/agent/settings.json under packages:

{
  "packages": ["npm:@taylorsatula/pi-kagi-search"]
}

Authentication

The extension registers a credential-only kagi-search provider, so Pi's built-in login flow handles your API key:

/login kagi-search

You'll be prompted for your Kagi API key (get one at https://kagi.com/settings?p=api). The key is persisted to ~/.pi/agent/auth.json and resolved automatically on every tool call.

Usage

Once installed and authenticated, the agent uses the tools autonomously:

• "Search the web for ..." → kagi_search
• "What's the capital of ..." → kagi_quick_search

Notes

• Requires a Kagi account with API access (Kagi's Search API is a paid add-on — check your plan at kagi.com).
• The provider registers no models; it exists solely to carry the credential through Pi's standard auth machinery.