什么是 Kagi Search？

kagi-search 技能是一款专门设计的工具，旨在弥合 AI 代理与实时网络信息之间的差距。通过利用 Kagi Search API，它提供了高信号、简洁的数据，没有广告或追踪的干扰。对于需要通过终端或代理环境获取文档、验证事实或研究时事的 Openclaw Skills 用户来说，该工具是完美的补充。

它采用纯 Python 实现，零依赖，部署极其快速简便。输出结果针对人类阅读和机器解析进行了优化，确保无论您是在阅读结果还是将其输入自动化工作流，信息都是结构化且易于访问的。

下载入口:https://github.com/openclaw/skills/tree/main/skills/silversteez/kagi-search

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Kagi Search 应用场景

• 搜索超出 LLM 训练截止日期的最新编程文档或库更新。
• 在编码或写作任务中事实核查实时信息并验证引用。
• 通过将 JSON 搜索数据传递到二次分析工具来自动化研究流程。
• 在执行批量搜索操作时坚控 API 使用情况和剩余额度。

1. 用户或代理通过提供查询字符串以及可选的分页或格式标志来发起搜索。
2. 该技能使用安全的环境变量与 Kagi Search API 进行身份验证。
3. 获取搜索结果，包括标题、URL、摘要和元数据。
4. 工具处理原始 API 响应以计算剩余 API 余额和执行时间。
5. 最终输出根据用户的偏好以简洁易读的文本格式或结构化 JSON 对象呈现。

Kagi Search 配置指南

要在 Openclaw Skills 中使用此工具，您必须拥有 Kagi 订阅和活跃的 API 密钥。按如下方式设置您的环境：

# 设置您的 Kagi API 密钥
export KAGI_API_KEY="your_api_key"

# 使脚本可执行
chmod +x scripts/kagi-search.py

# (可选) 添加到 PATH 以实现全局访问
cp scripts/kagi-search.py ~/.local/bin/kagi-search

Kagi Search 数据架构与分类体系

kagi-search 技能将结果组织成可预测的结构，确保 Openclaw Skills 用户的高数据完整性：

name: kagi-search
description: Web search using Kagi Search API. Use when you need to search the web for current information, facts, or references. Requires KAGI_API_KEY in the environment.

Note: The Kagi Search API is currently in beta. To request API access, email support@kagi.com. You must be a Kagi subscriber to use the API.

Kagi Search CLI

Web search using the Kagi Search API with a clean, readable output format.

Quick Start

export KAGI_API_KEY="your_api_key"
kagi-search "your search query"
# or run directly:
python3 scripts/kagi-search.py "your search query"

Features

• Clean output - Title, URL, snippet, and metadata for each result
• Pagination support - Control result count and offset
• JSON mode - Raw JSON output for scripting
• Related searches - Shows related queries (can be hidden)
• API balance - Displays remaining API quota
• Fast & lightweight - Pure Python, no dependencies

Options

Examples

# Basic search
kagi-search "python async await tutorial"

# Limit results
kagi-search "AI news" --limit 5

# Pagination
kagi-search "recipes" --offset 10 --limit 5

# JSON for scripting
kagi-search "github stars" --json | jq '.data[].url'

# Hide related searches
kagi-search "rust programming" --no-related

Setup

Environment:

export KAGI_API_KEY="your_api_key"
# Add to ~/.bashrc or ~/.zshrc for persistence

PATH access:

# Make executable and add to PATH
chmod +x scripts/kagi-search.py
cp scripts/kagi-search.py ~/.local/bin/kagi-search

Requirements

• Python 3.7+
• KAGI_API_KEY environment variable
• Internet connection

Output Format

[Query: search terms]
[Results: 5]
[API Balance: $0.123]
[Time: 45ms]
----------------------------------------
=== Result Title ===
https://example.com
Snippet text here...
[2024-01-15]
---
Related: related query 1, related query 2