用途：kagi 是 Kagi 的 JSON 优先命令行界面，供智能体或脚本调用搜索、Quick Answer、Assistant、ask-page、翻译、摘要、可读页面提取、Kagi News、Small Web、付费 API 命令及账户设置（lens、自定义 bang、自定义助手、重定向）。
主要能力：搜索支持 --limit、--snap、--lens、--region、--time、--order、--verbatim、个性化与本地缓存等参数；--follow N 可先搜索再摘要前 N 个结果。extract 输出可读页面 markdown，需 KAGI_API_KEY。summarize 分订阅者路径（--subscriber）与旧版 API token 路径。quick 返回带引用的简洁答案；assistant 支持会话线程、附件、自定义助手与模型选择；ask-page 针对单个 URL 提问；translate 使用会话令牌。news 与 smallweb 无需凭据。batch 并行搜索，watch 监控结果变化，mcp 提供 stdio MCP 服务。
使用方式：先执行 kagi skills get kagi 获取版本匹配指引，再用 kagi auth status 检查凭据。凭据分级：KAGI_SESSION_TOKEN 解锁订阅搜索、quick、assistant、ask-page、translate 及 summarize --subscriber；KAGI_API_KEY 用于当前 /api/v1 搜索与提取 API；KAGI_API_TOKEN 用于旧版 /api/v0 摘要等；news、smallweb、auth status、skills、help 无需凭据。环境变量覆盖 .kagi.toml，--profile NAME 选择配置档。输出格式可选 json、toon、markdown、compact、csv、pretty，面向 LLM 建议 toon，程序解析建议 json。
适用场景：需要结构化搜索结果、页面正文提取、直接问答、多轮助手对话、批量查询或结果监控的自动化流程。
限制：--lens、--time、--order、--verbatim 及个性化参数需会话令牌；extract 需当前 KAGI_API_KEY 而非旧版 token；summarize --subscriber、quick、assistant、ask-page、translate 需 KAGI_SESSION_TOKEN。不要打印凭据值，auth 命令仅汇总存在性与来源。--local-cache 仅在可接受陈旧数据时使用，pretty 仅供人工终端显示。具体收费、价格与平台支持资料未提供。