G-Search MCP

基本能力

产品定位

G-Search MCP 是一个专注于 Google 搜索的并行处理服务器，旨在提供高效、智能的搜索解决方案。

核心功能

• 并行搜索：支持同时使用多个关键词在 Google 上进行搜索
• 浏览器优化：在单个浏览器实例中打开多个标签页进行高效并行搜索
• 自动验证处理：智能检测 CAPTCHA 并在需要时启用可见浏览器模式进行用户验证
• 用户行为模拟：模拟真实用户浏览模式，降低被搜索引擎检测的可能性
• 结构化数据：返回 JSON 格式的结构化搜索结果，便于处理和分析
• 可配置参数：支持多种参数配置，如搜索结果限制、超时设置、区域设置等

适用场景

• 需要同时搜索多个关键词的场景
• 需要获取结构化搜索结果的场景
• 需要绕过 CAPTCHA 验证的场景
• 需要模拟真实用户行为的搜索场景

工具列表

• search：执行 Google 搜索并返回结果
• 使用 Playwright 浏览器进行搜索
• 支持参数：
  • queries：要执行的搜索查询数组（必需参数）
  • limit：每个查询返回的最大结果数，默认为 10
  • timeout：页面加载超时（毫秒），默认为 60000（60 秒）
  • noSaveState：是否避免保存浏览器状态，默认为 false
  • locale：搜索结果的区域设置，默认为 en-US
  • debug：是否启用调试模式（显示浏览器窗口），覆盖命令行中的 --debug 标志

常见问题解答

• 如何获取更多搜索结果：可以设置 limit 参数来增加返回结果数量
• 如何处理慢速加载：可以调整 timeout 参数增加页面加载超时时间
• 如何更改搜索区域：可以通过设置 locale 参数来更改搜索结果的区域设置
• 如何启用调试模式：可以在命令行中使用 --debug 选项或设置 debug 参数为 true

使用教程

使用依赖

• Node.js 18 或更高版本
• NPM 或 Yarn

安装教程

1. 使用 npx 直接运行：

npx -y g-search-mcp

1. 首次设置 - 在终端中运行以下命令安装所需的浏览器：

npx playwright install chromium

1. 从源代码安装：

git clone https://github.com/jae-jae/g-search-mcp.git
cd g-search-mcp
npm install
npm run install-browser
npm run build

调试方式

1. 使用 --debug 选项在调试模式下运行（显示浏览器窗口）：

npx -y g-search-mcp --debug

1. 开发模式自动重建：

npm run watch

1. 使用 MCP 检查器进行调试：

npm run inspector

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。