名称： kagi-search
描述： 使用 Kagi Search API 进行网络搜索。当需要搜索网络上的最新信息、事实或参考资料时使用。需要在环境中设置 KAGI_API_KEY。

> 注意： Kagi Search API 目前处于测试阶段。如需申请 API 访问权限，请发送邮件至 support@kagi.com。您必须是 Kagi 订阅用户才能使用此 API。

Kagi 搜索命令行工具

使用 Kagi Search API 进行网络搜索，并提供清晰易读的输出格式。

快速开始

export KAGI_API_KEY="your_api_key"
kagi-search "your search query"
# 或直接运行：
python3 scripts/kagi-search.py "your search query"

功能特性

• 清晰输出 - 每个结果包含标题、URL、摘要和元数据
• 分页支持 - 可控制结果数量和偏移量
• JSON 模式 - 提供原始 JSON 输出，便于脚本处理
• 相关搜索 - 显示相关查询（可隐藏）
• API 余额 - 显示剩余的 API 配额
• 快速轻量 - 纯 Python 实现，无额外依赖

选项参数

使用示例

# 基础搜索
kagi-search "python async await 教程"

# 限制结果数量
kagi-search "AI 新闻" --limit 5

# 分页查询
kagi-search "食谱" --offset 10 --limit 5

# JSON 输出供脚本处理
kagi-search "github stars" --json | jq '.data[].url'

# 隐藏相关搜索
kagi-search "rust 编程" --no-related

环境配置

环境变量设置：

export KAGI_API_KEY="your_api_key"
# 如需永久生效，可添加到 ~/.bashrc 或 ~/.zshrc 文件中

PATH 路径配置：

# 设为可执行文件并添加到 PATH
chmod +x scripts/kagi-search.py
cp scripts/kagi-search.py ~/.local/bin/kagi-search

运行要求

• Python 3.7 或更高版本
• 已设置 KAGI_API_KEY 环境变量
• 网络连接

输出格式

[查询：搜索关键词]
[结果数：5]
[API 余额：$0.123]
[耗时：45ms]
----------------------------------------
=== 结果标题 ===
https://example.com
此处为摘要文本...
[2024-01-15]
---
相关搜索：相关查询 1, 相关查询 2