Google Search MCP

Google Search MCP

site icon
2025.03.09 1
TypeScript搜索工具浏览器自动化搜索工具浏览器自动化
Google Search MCP 是一个基于 Playwright 的 Model Context Protocol (MCP) 工具,旨在绕过搜索引擎的反爬机制,执行 Google 搜索并提取结果,为 AI 助手(如 Claude 和 Cursor)提供实时搜索能力。该工具通过浏览器指纹欺骗和真实用户行为模拟来避免检测,支持多语言和区域搜索,并能自动处理 CAPTCHA 验证。
View on GitHub

Overview

基本能力

产品定位

Google Search MCP 是一个用于绕过搜索引擎反爬机制并提供实时搜索能力的工具,特别适用于 AI 助手集成。

核心功能

  • Anti-Bot Bypass: 使用浏览器指纹欺骗和真实用户行为模拟来避免检测。
  • Automatic CAPTCHA Handling: 遇到 CAPTCHA 时自动切换到 headed 模式,允许用户完成验证。
  • State Persistence: 保存浏览器会话状态以减少重复验证的需求。
  • Adaptability: 使用多种选择器组合以适应 Google 搜索页面的变化。
  • MCP Integration: 实现 Model Context Protocol,便于与 AI 助手集成。
  • Multi-language Support: 支持不同语言和区域的搜索结果。

适用场景

  • 为 AI 助手提供实时搜索能力。
  • 需要绕过搜索引擎反爬机制的场景。
  • 多语言和区域搜索需求。

工具列表

  • Playwright: 用于控制 Chromium 浏览器执行 Google 搜索。
  • MCP Inspector: 用于调试服务器。

常见问题解答

  • 首次使用时可能会遇到 CAPTCHA 验证,系统会自动切换到 headed 模式供用户完成验证。
  • 过于频繁的搜索请求可能会触发 Google 的速率限制机制。
  • 该工具仅用于学习和研究目的,请遵守 Google 的服务条款。

使用教程

使用依赖

确保已安装 Node.js 和 yarn。

安装教程

全局安装

npx -y @mcp-server/google-search-mcp@latest

项目特定安装 在项目中添加 .cursor/mcp.json 文件:

{
  "mcpServers": {
    "google-search": {
      "command": "npx",
      "args": [
        "-y",
        "@mcp-server/google-search-mcp@latest"
      ]
    }
  }
}

调试方式

运行 MCP 服务器

yarn start

使用 MCP Inspector 调试

yarn build
npx @modelcontextprotocol/inspector node dist/index.js

许可证

该项目遵循 MIT 开源许可条款。