SuperAPI AI 工具集

g-search-mcp

g-search-mcp 是一个用于 Google 搜索的 MCP 服务器,支持同时使用多个关键词进行并行搜索。它基于 Playwright 浏览器实现,可在单个浏览器实例中打开多个标签页以提升搜索效率,并能智能检测验证码、在需要时启用可见浏览器模式供用户验证,同时模拟真实用户浏览行为以降低被搜索引擎检测的可能。搜索结果以 JSON 结构化格式返回,便于后续处理与分析。该工具支持配置结果数量上限、超时时间、区域语言等参数,可通过 npx 直接运行,也可在 Claude Desktop 等 MCP 客户端中配置使用。

访问官网

工具介绍

用途

g-search-mcp 是一个面向 Google 搜索的 MCP(Model Context Protocol)服务器,主要解决需要同时用多个关键词进行搜索的场景。它允许一次提交多个查询词,并行执行搜索,从而提升搜索效率。该项目由 google-search 修改而来。

主要能力

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

使用方式

通过 npx 直接运行

首次设置时,需在终端中运行命令安装所需的浏览器。

可使用 --debug 选项以调试模式运行(显示浏览器窗口)。

在 Claude Desktop 中配置

配置文件位置:

  • MacOS:~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows:%APPDATA%/Claude/claude_desktop_config.json

search 工具

执行多关键词 Google 搜索并返回结果,使用 Playwright 浏览器进行搜索。支持以下参数:

  • queries:要执行的搜索查询数组(必填参数)
  • limit:每个查询返回的最大结果数,默认 10
  • timeout:页面加载超时时间(毫秒),默认 60000(60 秒)
  • noSaveState:是否避免保存浏览器状态,默认 false
  • locale:搜索结果的语言区域设置,默认 en-US
  • debug:是否启用调试模式(显示浏览器窗口),会覆盖命令行中的 --debug 标志

参数调整示例

  • 增加搜索结果数量:例如要求“每个关键词返回前 20 条搜索结果”,将设置 limit: 20 参数。
  • 增加超时时间:针对加载缓慢的情况,例如“将页面加载超时设置为 120 秒”,将把 timeout 参数调整为 120000 毫秒。
  • 更改搜索区域:指定不同的语言区域,例如“请使用中文区域(zh-CN)进行搜索”,将设置 locale: "zh-CN" 参数。

调试与故障排除

  • 动态启用调试:在特定搜索操作中显示浏览器窗口,例如“请为此搜索操作启用调试模式”,即使服务器启动时未加 --debug 标志,也会设置 debug: true。

环境要求与安装

  • 需要 Node.js 18 或更高版本。

从源码安装

  1. 克隆仓库
  2. 安装依赖
  3. 安装 Playwright 浏览器
  4. 构建服务器

自动重建(开发模式)

支持开发模式下的自动重建。

使用 MCP Inspector 进行调试

可使用 MCP Inspector 进行调试。

相关项目

  • fetcher-mcp:一个使用 Playwright 无头浏览器获取网页内容的 MCP 服务器,具备智能内容提取、并行处理、资源优化等特性,适合网页内容抓取。

许可

本项目基于 MIT 许可证授权。