用途:使用 Kagi Search API 在命令行中搜索网页,获取当前信息、事实或参考链接。Kagi Search API 目前处于 beta 阶段,需发邮件至 support@kagi.com 申请访问权限,且必须是 Kagi 订阅用户才能使用。
主要能力:为每条结果输出标题、URL、摘要和元数据;支持分页(结果数量与偏移量);支持原始 JSON 输出以便脚本处理;显示关联搜索(可隐藏);显示剩余 API 配额;纯 Python 实现,无依赖,轻量快速。
使用方式:先设置环境变量 export KAGI_API_KEY="your_api_key",可写入 ~/.bashrc 或 ~/.zshrc 持久化。直接运行 kagi-search "your search query",或 python3 scripts/kagi-search.py "your search query"。常用选项包括 -n/--limit 指定结果数(默认 10)、-s/--offset 分页偏移(默认 0)、--json 输出原始 JSON、--no-related 隐藏关联搜索、-h/--help 查看帮助。示例:kagi-search "AI news" --limit 5;kagi-search "recipes" --offset 10 --limit 5;kagi-search "github stars" --json | jq '.data[].url'。
环境要求:Python 3.7+、KAGI_API_KEY 环境变量、网络连接。如需 PATH 访问,可执行 chmod +x scripts/kagi-search.py 并复制到 ~/.local/bin/kagi-search。
限制:API 处于 beta 阶段,需申请且须为 Kagi 订阅用户;未提供具体价格与配额信息。