Kagi Search

Web search and content extraction using the official Kagi Search API. No browser required.

Setup

Requires a Kagi account with API access enabled.

1. •Create an account at https://kagi.com/signup
2. •Navigate to Settings -> Advanced -> API portal: https://kagi.com/settings/api
3. •Generate an API Token
4. •Add funds to your API balance at: https://kagi.com/settings/billing_api
5. •Add to your shell profile (~/.profile or ~/.zprofile for zsh):
   bash

   export KAGI_API_KEY="your-api-key-here"
   

6. •Install dependencies (run once):
   bash

   cd {baseDir}
   npm install
   

Pricing

The Kagi Search API is priced at $25 for 1000 queries (2.5 cents per search).

Search

{baseDir}/search.js "query"                         # Basic search (10 results)
{baseDir}/search.js "query" -n 20                   # More results (max 100)
{baseDir}/search.js "query" --content               # Include page content as markdown
{baseDir}/search.js "query" -n 5 --content          # Combined options

Options

• •-n <num> - Number of results (default: 10, max: 100)
• •--content - Fetch and include page content as markdown

Extract Page Content

{baseDir}/content.js https://example.com/article

Fetches a URL and extracts readable content as markdown.

Output Format

--- Result 1 ---
Title: Page Title
Link: https://example.com/page
Published: 2024-01-15T00:00:00Z
Snippet: Description from search results
Content: (if --content flag used)
  Markdown content extracted from the page...

--- Result 2 ---
...

--- Related Searches ---
- related term 1
- related term 2

When to Use

• •Searching for documentation or API references
• •Looking up facts or current information
• •Fetching content from specific URLs
• •Any task requiring web search without interactive browsing

Notes

• •Search results inherit your Kagi account settings (personalized results, blocked/promoted sites)
• •Results may include related search suggestions at the end