SerpKite

SerpKite MCP

通过 SerpKite 远程 Model Context Protocol 服务，为 AI Agent 提供 Google 搜索、公开网页内容、带引用的答案和深度研究功能。由 SerpKite 团队维护。

此仓库包含托管服务的连接示例和注册表元数据。API 实现为专有内容；此仓库中的文档和配置采用 MIT 许可。

连接

• 端点： https://api.serpkite.com/v1/mcp
• 传输： 无状态 Streamable HTTP
• 身份验证： OAuth 2.1 登录（作用域 mcp），或 Authorization: Bearer <your-api-key>
• 协议： 2025-06-18、2025-03-26、2024-11-05

请阅读定价和 MCP 文档。额度永不过期；失败和无结果的搜索免费。无需安装 SerpKite npm MCP 包。

OAuth

此服务实现了 MCP 授权规范。支持 MCP OAuth 的客户端（Claude 和 ChatGPT 连接器、Claude Code）只需提供 URL：它们会打开 SerpKite 登录页面，供你批准连接。

• 受保护资源元数据：https://api.serpkite.com/.well-known/oauth-protected-resource/v1/mcp
• 授权服务器：https://app-api.serpkite.com（元数据）
• 动态客户端注册或客户端 ID 元数据文档、使用 PKCE（S256）的授权码、作用域 mcp 和 offline_access

已批准的连接会作为以应用名称命名的 API 密钥运行，例如 Claude (OAuth)，并显示在你的 API 密钥页面中。你可以设置每月额度上限，或撤销密钥以断开应用连接。

API 密钥

不支持 MCP OAuth 的客户端需在 Authorization 标头中发送来自 app.serpkite.com 的 API 密钥，如下方示例所示。请为专用密钥设置每月额度上限，以控制 Agent 的支出。

Claude Code

claude mcp add --transport http serpkite https://api.serpkite.com/v1/mcp

运行 /mcp，选择 serpkite，然后选择 Authenticate，通过 OAuth 登录。若要改用 API 密钥，请添加 --header "Authorization: Bearer $SERPKITE_API_KEY"。

Cursor

添加到 ~/.cursor/mcp.json 或项目的 .cursor/mcp.json：

{
  "mcpServers": {
    "serpkite": {
      "url": "https://api.serpkite.com/v1/mcp",
      "headers": { "Authorization": "Bearer ${env:SERPKITE_API_KEY}" }
    }
  }
}

Cursor 插件

此仓库也是一个 Cursor 插件（.cursor-plugin/plugin.json、mcp.json、一个网页研究技能和一条规则）。启动 Cursor 前，请在环境中设置 SERPKITE_API_KEY；插件通过 ${env:SERPKITE_API_KEY} 读取密钥，且绝不会存储密钥。

VS Code

添加到 .vscode/mcp.json。密码输入框可避免将 API 密钥写入已提交的文件：

{
  "inputs": [
    { "type": "promptString", "id": "serpkite-key", "description": "SerpKite API key", "password": true }
  ],
  "servers": {
    "serpkite": {
      "type": "http",
      "url": "https://api.serpkite.com/v1/mcp",
      "headers": { "Authorization": "Bearer ${input:serpkite-key}" }
    }
  }
}

Cline

请按照 llms-install.md 配置 Cline 的远程连接。

Claude Desktop 和 stdio 客户端

安装 Node.js 后，在客户端的 MCP 配置中使用第三方 mcp-remote 桥接工具：

{
  "mcpServers": {
    "serpkite": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.serpkite.com/v1/mcp", "--header", "Authorization: Bearer ${SERPKITE_API_KEY}"],
      "env": { "SERPKITE_API_KEY": "YOUR_API_KEY" }
    }
  }
}

请勿将 API 密钥提交到源代码管理中。

ChatGPT

启用开发者模式后，使用 URL https://api.serpkite.com/v1/mcp 和 OAuth 身份验证创建连接器。ChatGPT 会自行注册，并将你带到 SerpKite 审批页面。

工具

工具	用途
search	Google 网页结果、答案、知识图谱和相关问题
news	Google 新闻文章
maps	地点、评分、地址和坐标
place	单个地点的详细信息：地址、营业时间、电话、时区（使用 maps 中的 place_id、cid 或 fid）
scholar	学术论文、引用和 PDF 链接
patents	专利搜索
shopping	商品、价格和商家
images	图片搜索
videos	视频搜索
autocomplete	查询建议
webpage	将公开 HTML 或 PDF 转换为 Markdown
answer	根据 Google 实时结果回答问题，并附带编号引用
extract	读取最多 20 个 URL；可选查询相关段落、摘要，或按你的架构匹配 JSON
map	查找网站的 URL
crawl	开始抓取网站的公开页面
crawl_result	读取抓取状态和结果
research	启动异步深度研究任务，最终生成带引用的 Markdown 报告
research_result	读取研究状态和报告

工具结果为适合大模型使用的 Markdown。定价与对应的 REST 端点一致；答案或 AI 步骤失败时不收费，研究仅在报告写入时收费。仅抓取公开且无需登录的页面。请参阅工具输入和费用。

验证连接

这些元数据请求不会运行搜索：

curl https://api.serpkite.com/v1/mcp \
  -H "Authorization: Bearer $SERPKITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

curl https://api.serpkite.com/v1/mcp \
  -H "Authorization: Bearer $SERPKITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

远程端点和全部十八个工具名称已于 2026-10-24 验证。

支持

文档 · 状态 · [email protected]

Google 是 Google LLC 的商标。SerpKite 与 Google 无关联。