Web Researcher MCP

web-researcher-mcp

你的 AI 研究助手。它会搜索、阅读你能打开的内容，并核查来源。

搜索网络和一手资料：SEC 文件、法院记录、专利、临床试验、全文论文。
阅读完整网页，包括需要使用你自己的账号登录才能查看的页面，例如 LinkedIn 和 X。
核查每条引文，在不同聊天中保留研究成果，并在你的机器上运行所有操作。
无需 API 密钥即可开始使用。

⭐ 如果你厌倦了 AI 编造信息，而 web-researcher-mcp 对你有所帮助，请给我们点个星 ⭐ — 这能帮助更多团队发现这个项目。

_{先展示问题的漫画，再呈现真实的工具输出。观看 43 秒视频。}

Python 用户 — uvx（无需编译，适用于任何操作系统）：

# One-time: install uv (skip if you already have it)
curl -LsSf https://astral.sh/uv/install.sh | sh        # macOS/Linux  (Windows: winget install astral-sh.uv)

claude mcp add --scope user web-researcher -- uvx web-researcher-mcp

uv 会为你的平台获取合适的预构建二进制文件并运行它 — 无需 Go、无需编译，也无需手动配置 PATH。将任何 MCP 客户端指向 uvx web-researcher-mcp 即可。也可使用 uv tool install web-researcher-mcp 或 pip install web-researcher-mcp。

macOS（Homebrew）：

brew install zoharbabin/tap/web-researcher-mcp
claude mcp add --scope user web-researcher -- web-researcher-mcp

macOS / Linux（无需包管理器）：

curl -fsSL https://raw.githubusercontent.com/zoharbabin/web-researcher-mcp/main/install.sh | sh

Windows（PowerShell）：

powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/zoharbabin/web-researcher-mcp/main/install.ps1 | iex"

无需开发工具 — 所有方法都会提供相同的签名二进制文件（PyPI wheel 会将其打包在内；其他方法会下载该文件并验证其校验和），并将其加入 PATH。如果存在 claude CLI，curl/PowerShell 安装程序还会自动将其注册到 Claude Code；Homebrew 会安装该二进制文件，因此请运行上面的 claude mcp add 命令来连接。

一键安装：

Cursor / VS Code / LM Studio 按钮会安装无需配置的 uvx 方案（编辑器会在添加前提示你确认；需要 uv — 见上文）。它会运行无需 API 密钥的 DuckDuckGo 网页搜索 — 非常适合立即试用；image_search/news_search 和更丰富的提供商则需要密钥（2 分钟即可完成，见配置）。**Claude Desktop：**下载适用于你平台的 .mcpb bundle 并双击它（设置 → 扩展），或者使用上面的 uvx 命令。

使用其他 MCP 客户端或想传入 API 密钥？请参阅连接到你的 AI 助手，了解各应用的配置；并参阅配置以选择搜索提供商。

现在，你的 AI 可以搜索网络和一手来源、阅读页面（包括需要登录才能访问的页面）、核查引用并开展多步骤研究。选择你信任的信息来源。

Python SDK

from web_researcher_mcp import WebResearcherClient

async with WebResearcherClient() as client:
    response = await client.web_search("CRISPR off-target effects 2024", num_results=5)
    for r in response.results:
        verified = await client.verify_citation(r.url)
        print(r.title, "—", "✓" if verified.exists else "?")

完整文档：docs/PYTHON_CLIENT.md

同步封装（适用于不使用异步的脚本和笔记本）：

with WebResearcherClient.sync() as client:
    response = client.web_search("climate change 2024")
    print(response.results[0].title)

它能做什么

为什么要做这个项目？

AI 的回答看起来有来源依据，但往往并非如此。

• 法院：Charlotin 数据库列出了超过 2,200 起涉及 AI 幻觉内容的法院判决。从 2027-01-01 起，加利福尼亚州 SB 574要求律师亲自核实法院文件中的每一条引用。
• **搜索：**2026 年的一项 WashU 审计发现，Google AI Overviews 中约每 9 条可核实的主张，就有 1 条未得到其引用页面的支持（作者称这是上限）。CJR 的 Tow Center测试了 8 款 AI 搜索引擎，发现它们在引用新闻来源方面都表现不佳。
• **你的工作：**如果内容会被引用、发表、提交或展示给客户，“可能是真的”远远不够。

**本项目的应对方式：**你的 AI 会从你选择的来源读取真实页面和记录，然后核查引用。每项主张都能追溯到你可以打开的链接。

兼容 Claude、Claude Desktop、Cursor、VS Code、Codex、Gemini CLI，以及任何支持 MCP 的 AI 助手。

适用人群

• 学术研究人员 — “我需要带有真实 DOI 的文献综述，而不是捏造的引文”
• 商业分析师 — “我的交付成果需要包含客户可以实际点击并核实的来源”
• 律师 — “如果我引用了不存在的案例，就会被罚款 50,000 美元”
• 记者 — “我需要交叉核对政府记录和法院文件，而不是 Perplexity 的摘要”
• 医学研究人员 — “依据健康博客做出的临床决策可能会伤害他人”
• 研究生 — “我花了 3 小时追查 AI 编造的一条引文”
• 市场与销售研究人员 — “最有价值的背景信息在我只有登录后才能打开的页面上”
• 企业团队 — “我们的竞争研究不能经过第三方服务器”
• 构建 Agent 的开发者 — “我希望搜索和阅读网页时无需按查询付费，也不受供应商锁定”

对比

根据各供应商截至 2026 年 10 月公开的文档整理。如果有内容已过时，请提交问题。

何时使用哪种工具

• 内置 AI 搜索 — 快速随意地查找信息，无需引用来源时
• 搜索 API — 只需要经过排序的链接时。将其中一种与此工具搭配使用（它们都可以作为提供方接入），还可阅读网页并核查引文
• 论文工具 — 浏览单个学术论文数据库时
• web-researcher-mcp — 研究成果关系到你的声誉时：客户工作、法院文件、出版物、拨款申请、医疗决策、新闻报道

AI 可以用它做什么

选择启用的工具。 这些工具在你开启相应功能前处于关闭状态。涉及个人数据的功能还需要记录同意。

权威且经 CI 验证的工具列表及完整架构，请参阅 docs/TOOLS.md。

现成的研究模板

此服务还提供引导式提示词模板，你的 AI 助手可以一键调用。这些模板会引导它完成经过验证的多步骤流程，让你无需逐条说明所有指令：

在大多数 AI 应用中，你可以在选择提示词或使用“/”命令的位置找到这些模板。此服务提供实时状态资源（stats://tools、stats://sessions、stats://rate-limits、stats://providers）、视角目录（lenses://catalog）、诊断信息（diagnostics://errors/recent、diagnostics://health、diagnostics://panel/spend），以及大负载内容的制品存储（research://artifact/{id}），以便你或你的 AI 查看用量、限额和当前启用的提供方。完整列表请参阅 docs/DEPLOYMENT.md。

快速开始

选项 1：Homebrew（macOS / Linux — 推荐）

brew install zoharbabin/tap/web-researcher-mcp
claude mcp add --scope user web-researcher -- web-researcher-mcp

Homebrew 会为你处理信任、更新和 PATH，无需担心签名警告。

选项 2：一键安装（适用于任何操作系统——无需开发工具）

macOS / Linux：

curl -fsSL https://raw.githubusercontent.com/zoharbabin/web-researcher-mcp/main/install.sh | sh

Windows（PowerShell）：

powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/zoharbabin/web-researcher-mcp/main/install.ps1 | iex"

下载二进制文件，根据已签名的发行版本验证其 SHA-256 校验和，将其添加到 PATH，并在已安装 Claude Code 的情况下完成注册。自定义安装位置：

INSTALL_DIR=/opt/tools curl -fsSL https://raw.githubusercontent.com/zoharbabin/web-researcher-mcp/main/install.sh | sh

# Using any AUR helper (yay, paru, etc.)
yay -S web-researcher-mcp

# Run without installing
nix run github:zoharbabin/web-researcher-mcp

# Add to your flake inputs
nix profile install github:zoharbabin/web-researcher-mcp

{
  "mcpServers": {
    "web-researcher": {
      "command": "uvx",
      "args": ["web-researcher-mcp"]
    }
  }
}

winget install zoharbabin.web-researcher-mcp

scoop bucket add zoharbabin https://github.com/zoharbabin/scoop-bucket
scoop install web-researcher-mcp

choco install web-researcher-mcp

brew install --cask zoharbabin/tap/web-researcher-mcp

go install github.com/zoharbabin/web-researcher-mcp/cmd/web-researcher-mcp@latest
claude mcp add --scope user web-researcher -- web-researcher-mcp

# STDIO mode needs -i so the container's stdin stays attached for MCP JSON-RPC
docker run -i --rm \
           -e SEARCH_PROVIDER=brave \
           -e BRAVE_API_KEY=YOUR_KEY \
           docker.io/zoharbabin/web-researcher-mcp:latest

git clone https://github.com/zoharbabin/web-researcher-mcp.git
cd web-researcher-mcp
go build -o web-researcher-mcp ./cmd/web-researcher-mcp

连接到 AI 助手

安装脚本会自动在 Claude Code 中注册。对于其他应用，请将以下内容添加到 AI 的配置文件中：

{
  "mcpServers": {
    "web-researcher": {
      "command": "web-researcher-mcp",
      "env": {
        "SEARCH_PROVIDER": "brave",
        "BRAVE_API_KEY": "YOUR_BRAVE_API_KEY"
      }
    }
  }
}

还没有密钥？省略 env 即可。DuckDuckGo 无需配置即可使用。

其他客户端：

通过设置 SEARCH_PROVIDER 和对应提供商的密钥，即可替换为 配置 表中的任意提供商。完成后，AI 助手便可使用所有研究工具。

配置

无需 API 密钥。 DuckDuckGo 是内置的零配置备用方案——安装后即可使用。若要提高结果质量并启用图片/新闻搜索，可添加以下任意一个提供商。它们均为可选且可互换——选择你已在使用或偏好的提供商即可；服务端会一视同仁地处理它们。

搜索提供商

设置 SEARCH_PROVIDER=<name>，并提供该提供商的密钥。所有提供商都支持搜索镜头，也可以组合使用，以便自动故障切换（参见搜索提供商）。

Google PSE 即将终止服务。 Google 已停止向新客户开放 Custom Search JSON API，并将于 2027-01-01 关闭该 API（Google）。现有密钥在此之前仍可使用。新配置请使用 Brave、Serper、SearXNG 或其他提供商。

每个提供商都有自己的免费层级、注册流程和功能组合（图片、新闻、时效性）。完整对比（索引分类、功能矩阵、快速选择指南）请参阅 docs/PROVIDERS.md，逐步配置密钥请参阅 docs/API_SETUP.md。配置多个提供商后，服务会自动进行故障切换，详见搜索提供商。

未设置 SEARCH_PROVIDER 时，如果存在 Google 密钥，服务会使用 Google；否则会回退到无需配置的 DuckDuckGo 提供商。因此，无论是否有密钥，都能开箱即用。

学术搜索（可选，无需注册）

学术搜索提供商（OpenAlex、CrossRef）接受联系邮箱，以通过 polite pool 获得更快的访问速度；无需注册，只需提供邮箱。配置方法请参阅 docs/API_SETUP.md，完整变量参考请参阅 docs/DEPLOYMENT.md。

设置这些变量后，academic_search 会返回真实论文及其 DOI、作者、引用次数和开放获取 PDF 链接。未设置时仍可使用，但会回退到网页搜索。

专利搜索（可选）

专利提供商（EPO、USPTO、The Lens）需要 API 密钥才能获取结构化专利数据。逐步配置说明请参阅 docs/API_SETUP.md，完整变量参考请参阅 docs/DEPLOYMENT.md。

设置这些变量后，patent_search 会返回包含分类代码、日期和发明人的结构化专利数据。未设置时会回退到网页搜索。

内部机制

搜索提供商

你可以选择为研究提供支持的搜索引擎。所有搜索引擎都能与搜索镜头配合使用。

多个提供商（推荐）

配置多个搜索引擎，这样即使某个引擎出现问题，你的研究也不会中断：

export SEARCH_ROUTING=brave,serper,duckduckgo

如果 Brave 出现故障，它会自动尝试 Serper。如果 Serper 遭遇速率限制，则会继续尝试 DuckDuckGo。研究工作始终顺畅进行。

请参阅 docs/PROVIDERS.md，了解完整的提供商比较（索引分类、功能、免费套餐）；高级路由选项（按主题路由、专利专用提供商等）请参阅 docs/DEPLOYMENT.md。

单个提供商

如果你只有一个搜索 API 密钥，也可以正常使用——只需完成配置即可。

export SEARCH_ROUTING=brave,serper
export BRAVE_API_KEY=BSAxxxxxxxxxx
export SERPER_API_KEY=...

export SEARCH_PROVIDER=brave
export BRAVE_API_KEY=BSAxxxxxxxxxx

export SEARCH_PROVIDER=searxng
export SEARXNG_URL=http://localhost:8080

export SEARCH_PROVIDER=exa
export EXA_API_KEY=...

export SEARCH_PROVIDER=brave
export BRAVE_API_KEY=BSA...

搜索镜头

搜索镜头可让你控制允许 AI 搜索哪些网站。与其搜索整个网络（从而搜到博客、垃圾内容和 AI 生成的低质内容），不如使用搜索镜头将结果限制为你信任的、适用于该主题的来源。

内置 Lens

你也可以针对任何领域创建自己的 Lens——只需列出你信任的域名。

工作原理

当你（或你的 AI）使用 Lens 时，结果只会来自该 Lens 中的网站。例如，使用 medical Lens 意味着你的 AI 会搜索 PubMed、WHO、NIH 和其他临床来源，而不会搜索健康博客或补充剂广告。

你的 AI 会在你提出要求时自动使用 Lens。例如：“使用 clinical Lens 搜索 SGLT2 抑制剂的最新研究结果。”

{
  "name": "my-industry",
  "description": "Only searches sources I trust for my field",
  "domains": [
    "trusted-source.com",
    "industry-journal.org",
    "official-database.gov"
  ],
  "cx": ""
}

export CUSTOM_LENSES_PATH=/path/to/my-lenses

隐私与安全

你的研究查询会直接从你的设备发送到你选择的搜索提供商，不会经过我们的服务器（我们没有服务器）。该工具完全在你的计算机上运行。

存储个人数据的功能（已保存的登录信息、记忆、分析数据、工作区）默认处于关闭状态。每项功能都需要主动选择启用、记录同意并进行加密存储。

各 AI 应用的设置

Claude Code

将以下内容添加到 MCP 配置文件（~/.claude.json）。设置 SEARCH_PROVIDER 以及对应服务提供商的密钥（参见配置表）——以下示例使用 Brave：

{
  "mcpServers": {
    "web-researcher": {
      "command": "/path/to/web-researcher-mcp",
      "env": {
        "SEARCH_PROVIDER": "brave",
        "BRAVE_API_KEY": "BSA..."
      }
    }
  }
}

Claude Desktop

将以下内容添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "web-researcher": {
      "command": "/path/to/web-researcher-mcp",
      "env": {
        "SEARCH_PROVIDER": "brave",
        "BRAVE_API_KEY": "BSA..."
      }
    }
  }
}

Cursor

将以下内容添加到项目根目录下的 .cursor/mcp.json：

{
  "mcpServers": {
    "web-researcher": {
      "command": "/path/to/web-researcher-mcp",
      "env": {
        "SEARCH_PROVIDER": "brave",
        "BRAVE_API_KEY": "BSA..."
      }
    }
  }
}

HTTP 模式（团队 / 共享服务）

适用于希望所有人连接到同一个共享实例的团队：

PORT=3000 \
OAUTH_ISSUER_URL=https://auth.example.com \
OAUTH_AUDIENCE=https://api.example.com \
./web-researcher-mcp

然后将任意 AI 应用连接到 http://localhost:3000/mcp/。

services:
  web-researcher:
    image: zoharbabin/web-researcher-mcp
    ports:
      - "3000:3000"
    environment:
      PORT: "3000"
      SEARCH_PROVIDER: brave
      BRAVE_API_KEY: ${BRAVE_API_KEY}

注意： 所有连接模式（STDIO 和 HTTP）下的工具行为完全相同。唯一的区别是身份验证（HTTP 需要 OAuth）和速率限制（HTTP 会强制执行每个租户的限制；STDIO 仅受上游 API 配额限制）。详情请参阅 docs/DEPLOYMENT.md。

性能

搜索结果可在一秒内返回。之前见过的结果会被缓存，重复搜索可即时返回。全文提取适用于 95% 以上的网站，包括试图拦截机器人的网站。对于大量使用 JavaScript 的网站，后台会自动启用真正的浏览器（无需设置）。

开发

go build -o web-researcher-mcp ./cmd/web-researcher-mcp   # Build
go test -race ./...                                        # Test (with race detector)
make verify                                                # Full CI gate (see Makefile for steps)

lint、gosec 和 govulncheck 工具已通过 go.mod 工具指令固定版本，因此 make verify 会使用 CI 所用的确切版本运行它们（无需全局安装）。分支保护要求 Lint、Test、Security 和 E2E 检查全部通过。

完整的开发工作流、代码风格指南和 PR 流程，请参阅 CONTRIBUTING.md。

故障排除

rm -f /path/to/web-researcher-mcp
cp /path/to/new-build /path/to/web-researcher-mcp
codesign --force -s - /path/to/web-researcher-mcp   # ad-hoc re-sign

贡献

欢迎贡献。请参阅 CONTRIBUTING.md，了解代码风格指南、开发工作流以及如何提交拉取请求。

文档

许可证

MIT

由 Zohar Babin 使用 Go 和 Model Context Protocol 构建