Back to list
joelazar

kagi-search

by joelazar

Dotfiles for my macos setup

153🍴 5📅 Jan 22, 2026

SKILL.md


name: kagi-search description: Web search and content extraction via Kagi Search API. Use for searching documentation, facts, or any web content. Lightweight, no browser required.

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):
    export KAGI_API_KEY="your-api-key-here"
    
  6. Install dependencies (run once):
    cd {baseDir}
    npm install
    

Pricing

The Kagi Search API is priced at $25 for 1000 queries (2.5 cents per 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

Score

Total Score

70/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

+10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

+5
最近の活動

1ヶ月以内に更新

+10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

+5

Reviews

💬

Reviews coming soon