用途：通过 Kagi Search API 在命令行进行网页搜索，用于获取当前信息、事实或参考资料。API 目前为测试版，需是 Kagi 订阅用户并向 support@kagi.com 申请访问权限。
主要能力：输出每条结果的标题、URL、摘要和元数据；支持分页（结果数量与偏移）；支持原始 JSON 输出以便脚本处理；显示相关搜索（可隐藏）；显示剩余 API 配额；纯 Python 实现，无依赖，运行轻量。
使用方式：先设置环境变量，再运行命令。
export KAGI_API_KEY="your_api_key" kagi-search "your search query"
也可直接运行：
python3 scripts/kagi-search.py "your search query"
常用选项：query 为必填搜索词；-n, --limit 指定结果数（默认 10）；-s, --offset 指定分页偏移（默认 0）；--json 输出原始 JSON；--no-related 隐藏相关搜索；-h, --help 显示帮助。示例：kagi-search "AI news" --limit 5；kagi-search "github stars" --json | jq '.data[].url'。
安装与配置：将脚本设为可执行并放入 PATH，例如 chmod +x scripts/kagi-search.py 后复制到 ~/.local/bin/kagi-search；可将 export KAGI_API_KEY 加入 ~/.bashrc 或 ~/.zshrc 以持久化。要求 Python 3.7+、KAGI_API_KEY 环境变量和互联网连接。
限制：Kagi Search API 处于测试版，须为 Kagi 订阅用户且需申请 API 访问；费用、配额与具体定价资料暂未提供；输出格式示例中会显示查询、结果数、API 余额与耗时。