keyapi-google-search

用途：该技能通过 KeyAPI MCP 服务提供 Google 搜索能力，适合内容调研、竞品分析、SERP 监测、视觉素材发现与品牌图片监测等场景。主要能力：web_search 返回排序后的网页结果，含标题、URL 和摘要；image_search 返回图片结果。参数方面，两个端点共用必填参数 q；web_search 支持 num（1–100，默认 10）和 lr（语言地区代码，如 en-US、zh-CN、de-DE，默认 en-US），无分页，单次返回全部结果；image_search 支持 num（每页 1–20，默认 10）、page（从 1 开始，默认 1）、gl（两位国家代码，如 us、cn、de，默认 us）和 lr（语言前缀格式，如 lang_en、lang_zh-CN，默认 lang_en）。注意两端的 lr 格式不同，不可混用，且 gl 仅适用于 image_search。使用方式：需 Node.js v18 或更高版本，在技能目录运行 npm install 安装 @modelcontextprotocol/sdk，并设置环境变量 export KEYAPI_TOKEN=your_token_here（可在 keyapi.ai 免费注册获取）。先通过 node scripts/run.js --platform google --list-tools 验证连接，可用 --schema 查看参数结构。调用示例：node scripts/run.js --platform google --tool web_search --params '{"q":"best noise cancelling headphones 2025","lr":"en-US","num":10}' --pretty。结果会按日期缓存在 .keyapi-cache/ 目录，默认优先读取缓存，可用 --no-cache 强制获取新数据。限制与错误处理：code=0 表示成功，其他值需按错误码处理——400 参数错误，401 令牌缺失或过期，403 配额超限或功能受限，429 触发限流需等待 60 秒重试，500 服务器错误可间隔 2–3 秒重试最多 3 次，否则记录完整请求响应并跳过。许可为 MIT，仓库位于 github.com/EchoSell/keyapi-skills，作者 KeyAPI。