AI导哈

搜索引擎自动化工具

一个基于Playwright的Google搜索自动化工具，能够绕过搜索引擎的反爬机制，提供实时搜索能力，适用于AI助手集成。

  • by modelcontextprotocol-servers
  • TypeScript
  • 本地部署
  • 24 星标
  • 更新于
在 GitHub 查看 modelcontextprotocol-servers/google-search-mcp

使用说明

谷歌搜索MCP

模型上下文协议 谷歌搜索服务器。 一种基于剧作家的模型上下文协议（MCP）工具，绕过搜索引擎反机器人机制，执行谷歌搜索并提取结果，为克劳德和Cursor等人工智能助手提供实时搜索功能。

特性

  • 反机器人绕过：使用浏览器指纹欺骗和真实用户行为模拟来避免检测
  • 自动验证码处理：遇到验证码时切换到头部模式，允许用户完成验证
  • 状态持久性：保存浏览器会话状态，以减少重复验证的需要
  • 适应性：使用多个选择器组合来适应谷歌搜索页面的变化
  • MCP集成：实现模型上下文协议，便于与人工智能助手集成
  • 多语言支持：支持不同语言和地区的搜索结果

与光标一起使用

安装-全球

使用npx运行MCP服务器：

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

在Cursor IDE中

  1. 首选 Cursor Settings > MCP
  2. 点击 + Add New MCP Server
  3. 填写表格：
    • 姓名： google-search （或您喜欢的任何名称）
    • 类型： command
    • 命令： npx -y @mcp-server/google-search-mcp@latest

安装-项目特定

添加一个 .cursor/mcp.json 文件到您的项目：

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

发展

yarn install

构建项目

yarn build

用法

作为MCP服务器运行

yarn start

与MCP检查器一起使用

要调试服务器，您可以使用 MCP检查员:

# First build the project
yarn build

# Start the MCP Inspector and server
npx @modelcontextprotocol/inspector node dist/index.js

参数

搜索工具接受以下参数：

  • query （必填）：搜索查询字符串
  • limit （可选）：要返回的搜索结果数，默认值为10
  • timeout （可选）：搜索操作超时（毫秒），默认值为60000
  • language （可选）：搜索结果的语言，例如zh-CN、en-US，默认为zh-CN
  • region （可选）：搜索结果的区域，例如cn、com、co.jp，默认为cn

运作原理

  1. 该工具使用Playwright控制Chromium浏览器执行谷歌搜索
  2. 它通过浏览器指纹欺骗和真实用户行为模拟避免了机器人检测
  3. 当遇到验证码验证时，它会自动切换到头部模式供用户完成
  4. 它提取搜索结果并以结构化格式返回
  5. 它保存浏览器状态，以便在后续搜索中重复使用

高级配置

浏览器状态文件

默认情况下，浏览器状态保存在 .google-search-browser-state.json 用户主目录中的文件。您可以通过参数修改此路径。

语言和地区设置

您可以通过参数指定搜索结果的语言和地区：

// English (US) search results
"language": "en-US", "region": "com"

// Japanese search results
"language": "ja-JP", "region": "co.jp"

// Chinese (Simplified) search results
"language": "zh-CN", "region": "cn"

备注

  • 首次使用时，如果您遇到验证码验证，系统将自动切换到头部模式，让您完成验证
  • 验证后，系统将保存状态文件，使后续搜索更加顺畅
  • 过于频繁的搜索请求可能会触发谷歌的限速机制
  • 此工具仅用于学习和研究目的，请遵守谷歌的服务条款

许可证

麻省理工学院

免责声明

此工具仅用于学习和研究目的。使用此工具访问谷歌或其他搜索引擎时，请遵守相关服务条款和法律法规。作者不对因使用此工具而产生的任何问题负责。

相关 MCP