基本能力
产品定位
G-Search MCP 是一个专注于 Google 搜索的并行处理服务器,旨在提供高效、智能的搜索解决方案。
核心功能
- 并行搜索:支持同时使用多个关键词在 Google 上进行搜索
- 浏览器优化:在单个浏览器实例中打开多个标签页进行高效并行搜索
- 自动验证处理:智能检测 CAPTCHA 并在需要时启用可见浏览器模式进行用户验证
- 用户行为模拟:模拟真实用户浏览模式,降低被搜索引擎检测的可能性
- 结构化数据:返回 JSON 格式的结构化搜索结果,便于处理和分析
- 可配置参数:支持多种参数配置,如搜索结果限制、超时设置、区域设置等
适用场景
- 需要同时搜索多个关键词的场景
- 需要获取结构化搜索结果的场景
- 需要绕过 CAPTCHA 验证的场景
- 需要模拟真实用户行为的搜索场景
工具列表
search
:执行 Google 搜索并返回结果- 使用 Playwright 浏览器进行搜索
- 支持参数:
queries
:要执行的搜索查询数组(必需参数)limit
:每个查询返回的最大结果数,默认为 10timeout
:页面加载超时(毫秒),默认为 60000(60 秒)noSaveState
:是否避免保存浏览器状态,默认为 falselocale
:搜索结果的区域设置,默认为 en-USdebug
:是否启用调试模式(显示浏览器窗口),覆盖命令行中的 --debug 标志
常见问题解答
- 如何获取更多搜索结果:可以设置
limit
参数来增加返回结果数量 - 如何处理慢速加载:可以调整
timeout
参数增加页面加载超时时间 - 如何更改搜索区域:可以通过设置
locale
参数来更改搜索结果的区域设置 - 如何启用调试模式:可以在命令行中使用
--debug
选项或设置debug
参数为 true
使用教程
使用依赖
- Node.js 18 或更高版本
- NPM 或 Yarn
安装教程
-
使用 npx 直接运行:
bash
npx -y g-search-mcp -
首次设置 - 在终端中运行以下命令安装所需的浏览器:
bash
npx playwright install chromium -
从源代码安装:
bash
git clone https://github.com/jae-jae/g-search-mcp.git
cd g-search-mcp
npm install
npm run install-browser
npm run build
调试方式
-
使用
--debug
选项在调试模式下运行(显示浏览器窗口):
bash
npx -y g-search-mcp --debug -
开发模式自动重建:
bash
npm run watch -
使用 MCP 检查器进行调试:
bash
npm run inspector