Web Researcher MCP

MCP数据服务

提供方 zoharbabin

数据服务 未标注 OAuth 授权 社区 / 第三方 Claude DesktopClaudeCursorCodex
查看接入方式

Your AI research assistant that cites real sources and stays honest. Search the entire web or narrow it down to just the sites you trust; medical journals, court databases, news outlets, academic papers. Analyze the full source, not just snippets. Links that work, citations you c

一句话选型结论

按资料字段整理

Web Researcher MCP 属于数据服务类 MCP 服务器,传输方式未标注,OAuth 授权,可直接接入 Claude Desktop、Claude、Cursor 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类数据服务 传输方式未标注 鉴权OAuth 授权 部署方式未标注
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

数据服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

web search research citations academic patents news scraping privacy

支持客户端

适用场景

web searchresearchcitations

安装与配置

未标注 OAuth 授权
上游未给出传输方式
go install github.com/zoharbabin/web-researcher-mcp/cmd/web-researcher-mcp@latest\r

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
数据库查询

用自然语言查库、取数,不用手写 SQL。

数据同步与清洗

把多来源数据拉到一处做整理。

报表取数

按口径快速拉出统计结果。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在数据服务场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Web Researcher MCP当前 未标注 未标注 未标注 有 未标注
Memory 9d25f64e 9 未标注 未标注 无 2026-05-17
Getzep MCP 9 stdio · 本地进程 本地部署 有 2026-05-17
anything-llm 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Prisma MCP Server 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Astr Bot 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

数据服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方zoharbabin上游标注的维护方 zoharbabin
分类数据服务本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Cross-platform本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验未标注上游最后核验时间

详细介绍

36.9 KB
来自项目仓库与上游目录的原文,未做删改

web-researcher-mcp

Your AI research assistant. It searches, reads what you can open, and checks its sources.

Search the web and primary sources: SEC filings, court records, patents, clinical trials, full-text papers.
Read whole pages, including pages behind your own logins, like LinkedIn and X.
Check every citation, keep your research across chats, and run it all on your machine.
No API key needed to start.

⭐ If you're tired of AI making things up, and web-researcher-mcp helps you, give us a star ⭐ — it helps more teams discover the project.

A cartoon of the problem, then real tool output. Watch the 43-second video.

Get started in 30 seconds

Python users — uvx (no compile, any OS):```bash

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` fetches the right prebuilt binary for your platform and runs it — no Go, no compile, no manual PATH. Point any MCP client at `uvx web-researcher-mcp`. Also works with `uv tool install web-researcher-mcp` or `pip install web-researcher-mcp`.

**macOS (Homebrew):**```bash
brew install zoharbabin/tap/web-researcher-mcp
claude mcp add --scope user web-researcher -- web-researcher-mcp

macOS / Linux (no package manager):```bash
curl -fsSL https://raw.githubusercontent.com/zoharbabin/web-researcher-mcp/main/install.sh | sh


**Windows (PowerShell):**```powershell
powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/zoharbabin/web-researcher-mcp/main/install.ps1 | iex"

No dev tools needed — every method ships the same signed binary (the PyPI wheels vendor it; the others download it and verify its checksum) and puts it on your PATH. The curl/PowerShell installers also register it with Claude Code automatically when the claude CLI is present; Homebrew installs the binary, so run the claude mcp add line above to connect it.

One-click install:

The Cursor / VS Code / LM Studio buttons install the zero-config uvx setup (your editor prompts to confirm before adding it; needs uv — see above). It runs DuckDuckGo web search with no API key — great to try instantly; image_search/news_search and richer providers need a key (2 min, see Configuration). Claude Desktop: download the .mcpb bundle for your platform and double-click it (Settings → Extensions), or use the uvx line above.

Using a different MCP client or want to pass API keys? See Connect to Your AI Assistant for the per-app config, and Configuration to pick a search provider.

Your AI can now search the web and primary sources, read pages (including ones behind your logins), check citations, and run multi-step research. Pick the sources you trust.

Python SDK```python

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 "?")


Full documentation: docs/PYTHON_CLIENT.md

Sync wrapper (for scripts and notebooks that don't use async):```python
with WebResearcherClient.sync() as client:
    response = client.web_search("climate change 2024")
    print(response.results[0].title)

What it does

What it means for you
Search everywhere you'd look Web search that you can limit to sites you trust (lenses). Dedicated tools for SEC filings, US court records, patents, clinical trials, economic data and full-text papers. Works with no API key.
Work as you Opt-in site_login lets your AI read pages you can already open: LinkedIn, X, Facebook, Instagram, YouTube and more. You sign in yourself, 2FA included, in your own browser or a private login window. Your password is never saved. Logins are encrypted, per user, expire, and site_logout removes them. Some sites, such as LinkedIn, forbid automated access in their terms. Use it where yours allow.
Check before you rely verify_citation, audit_bibliography and verify_recommendation check that a source exists, was not retracted, has a live link, and says what is claimed. They return evidence, not a verdict. Accuracy is measured on a labeled gold set (docs/TRUST_EVAL.md).
Read the whole page PDFs, Word and PowerPoint files, YouTube transcripts and Hacker News threads, not just snippets.
Keep it and watch it Sessions survive context loss. research_panel compares answers from several models. Export citations as APA, MLA, BibTeX, RIS or CSL-JSON. Opt-in saved-query monitors flag new results, memory keeps findings across chats, and team workspaces share them.
Run it yourself Free, open source (MIT), no account. Your queries go only to the search providers you choose. Use one binary on your laptop, or a shared server for a team.
Always has a backup Several search engines work together. If one fails, the next takes over.
Paper trail An opt-in audit log records every tool call in a tamper-evident hash chain. Releases ship with signatures and SLSA provenance.

Why does this exist?

AI answers look sourced and often aren't.

  • Courts: the Charlotin database lists over 2,200 court decisions that involve AI-hallucinated content. From 2027-01-01, California SB 574 requires attorneys to personally verify every citation in a court filing.
  • Search: a 2026 WashU audit found that about 1 in 9 verifiable claims in Google AI Overviews was not backed by the page it cited (the authors call this an upper bound). The Tow Center at CJR tested eight AI search engines and found all of them bad at citing news.
  • Your work: if it gets cited, published, filed, or shown to a client, "probably real" is not enough.

What this does about it: your AI reads the real pages and records, from sources you choose, and then checks the citations. Every claim traces to a link you can open.

Works with Claude, Claude Desktop, Cursor, VS Code, Codex, Gemini CLI, and any AI assistant that supports MCP.

Who uses this

  • Academic researchers — "I need a literature review with real DOIs, not made-up citations"
  • Business analysts — "My deliverable needs sources a client can actually click and verify"
  • Lawyers — "If I cite a case that doesn't exist, I get fined $50,000"
  • Journalists — "I need to cross-check government records and court filings, not Perplexity summaries"
  • Medical researchers — "Clinical decisions based on a health blog could hurt someone"
  • Graduate students — "I spent 3 hours tracking down a citation my AI invented"
  • Market and sales researchers — "The best context is on pages I can only open when I'm signed in"
  • Enterprise teams — "Our competitive research can't go through a third party's servers"
  • Developers building agents — "I want search and page reading without a per-query bill or a vendor lock-in"


How It Compares

web-researcher-mcp Built-in AI search (Perplexity, ChatGPT, Google AI) Search APIs (Tavily, Exa, Brave) Paper tools (Scite, Consensus, Elicit)
Checks that citations exist, are not retracted, and say what is claimed Yes No No Papers only
You pick which sources are searched Yes (lenses) No Domain filters No
SEC filings, court records, patents, clinical trials Yes Web pages only Web pages only No
Reads full pages, PDFs, YouTube transcripts Yes Snippets and summaries Varies No
Runs on your machine, no account Yes No No (hosted API) No (hosted)
Works inside your existing AI client Yes Separate app Yes Partly
Cost Free, open source (MIT) Subscription or bundled Metered API key Subscription

Based on each vendor's public docs, October 2026. If something is out of date, open an issue.

When to use what

  • Built-in AI search — Quick casual lookups where you don't need to cite your sources
  • Search APIs — You only need ranked links. Pair one with this tool (any of them plugs in as a provider) to also read pages and check citations
  • Paper tools — Browsing one database of academic papers
  • web-researcher-mcp — Anything where your reputation is attached to the research: client work, court filings, publications, grant proposals, medical decisions, journalism

What your AI can do with this

Tool What it does
web_search Search the web — optionally restricted to only the sources you trust via lenses
scrape_page Read any URL in full — web pages, PDFs, Word docs, slideshows, YouTube transcripts, Hacker News threads (read natively via the HN API); supports mode: raw for verbatim, unsanitized source (e.g. inspecting JSON or HTML)
search_and_scrape Search and then read the best results — with quality scoring to surface the most reliable sources
image_search Find images by size, type, color, or format
news_search Search recent news with date controls and source filtering
academic_search Find real papers with real DOIs — authors, citation counts, open-access links
paper_fulltext Fetch a paper's full text in one call from its DOI, Semantic Scholar ID, or URL — no need to chain academic_search then scrape_page
citation_graph Walk a paper's citation neighborhood — works it cites and works that cite it, with intent/influence signals
patent_search Search patent offices (US, Europe, international) with classification codes
filing_search Search SEC EDGAR for US public-company filings (10-K, 10-Q, 8-K, …) — or pull structured XBRL company facts
legal_search Search US court opinions and dockets via CourtListener — real cases with real citations
econ_search Look up economic data — World Bank global development indicators, OECD economic indicators, Eurostat European statistics (all keyless), and FRED US macro series (GDP, CPI, unemployment, rates; requires FRED_API_KEY)
clinical_search Search ClinicalTrials.gov — clinical-trial registrations with status, phase, sponsor, and whether results are posted (discovery, not medical advice)
monarch_search Query the Monarch Initiative biomedical knowledge graph — rank diseases and genes by phenotype similarity, look up disease/gene/phenotype entities, traverse gene-disease-phenotype associations
awesome_list_search Search the ecosyste.ms Awesome API for community-curated "awesome-*" lists on a GitHub topic — structured, filterable coverage (stars, curated-entry count, topics) beyond free-text search
local_search Search for physical places (restaurants, shops, services, points of interest) by local intent query — structured POI details and descriptions. Requires BRAVE_API_KEY
brand_research Research a company's complete brand identity — colors (hex), logos, typography, tone of voice, and social handles — from any domain or company name. Returns structured JSON for AI content generation. No API key required; BrandFetch key optional for richer data
company_recon OSINT company reconnaissance — Certificate Transparency log SANs, Wayback Machine historical URL inventory, derived subdomains, and a web-search company summary. Each phase fails soft and is independently selectable
verify_citation Check a citation before you rely on it — does it exist, match a real record, and is it retracted or a dead link? Evidence, not a verdict
audit_bibliography Audit a whole reference list in one pass — paste a CSL-JSON/RIS/BibTeX file (or a session) and get per-entry + corpus-level flags for retracted, dead-link, and unverifiable citations
verify_recommendation Audit an AI-generated recommendation list (listicle, product ranking) for self-promotion, author conflicts of interest, domain reputation, and dead links — catches GEO-gamed picks. Evidence, not a verdict
archive_source Capture a fresh Internet Archive (Wayback Machine) snapshot of a URL via Save Page Now so a cited source stays verifiable if the page later changes or disappears — returns snapshot URL + timestamp (write tool)
sequential_search Multi-step deep research — your AI remembers what it already found and builds on it
get_research_session Recover a research session after context loss — picks up right where you left off
research_export Export a research session as a shareable report (markdown or JSON), with full per-step provenance
format_bibliography Turn collected sources into a formatted bibliography — APA, MLA, BibTeX, RIS, or CSL-JSON (Zotero/EndNote/Mendeley-ready)
research_panel Ask the same question to a panel of independently configured LLMs and compare answers — consensus, contradictions, and model-unique points, computed deterministically, never smoothed over by an arbiter model

Most tools above are always available. A few activate only when the right provider or config is present: citation_graph and research_panel require at least one configured backing provider; filing_search requires EDGAR_CONTACT_EMAIL; local_search requires BRAVE_API_KEY.

Opt-in tools. These stay off until you turn the feature on. Personal-data features also need recorded consent.

Tool What it does Turn on with
site_login, site_logout Save or remove a login (cookies or a browser profile) so scrape_page can read pages behind it. Encrypted, per user. COOKIE_VAULT_ENABLED=true
monitor_query_save, monitor_query_check Save a query, then ask later for only the results that are new MONITORING_ENABLED=true
memory_save, memory_recall Keep findings across sessions, per user, with a retention limit MEMORY_ENABLED=true
workspace_contribute, workspace_read Share findings into a team workspace, with provenance WORKSPACES_ENABLED=true
get_my_analytics See your own usage stats USER_ANALYTICS_ENABLED=true

See docs/TOOLS.md for the authoritative, CI-verified tool list and full schemas.

Ready-made research templates

The server also ships guided prompt templates your AI assistant can pull in with one click — they walk it through a proven, multi-step process so you don't have to spell out every instruction:

Template What it guides your AI to do
comprehensive-research Run a structured, multi-step deep dive on a topic
fact-check Verify a claim against multiple independent sources
competitive-analysis Size up a company and its market (news, patents, web)
literature-review Systematically review academic literature on a topic
brand-guidelines Research a brand and produce use-case-specific creative direction (landing page, email, video brief) — calls brand_research and interprets the structured JSON for you
company-recon Deep OSINT reconnaissance on a company — maps infrastructure, filings, personnel, and public footprint
rare-disease-research Rare-disease differential and gene-disease research over the Monarch knowledge graph, corroborated with literature and trials
research-panel-factcheck Fact-check a claim across a panel of LLMs and chase every disagreement
research-panel-synthesis Synthesize one answer across a panel of LLMs, treating contradictions as uncertainty
curriculum-research Research a subject's syllabus coverage, institutional climate, and academic-freedom context — calls web_search with the curriculum lens

In most AI apps these show up wherever you pick a prompt or "/" command. The server exposes live status resources (stats://tools, stats://sessions, stats://rate-limits, stats://providers), a lens catalog (lenses://catalog), diagnostics (diagnostics://errors/recent, diagnostics://health, diagnostics://panel/spend), and a large-payload artifact store (research://artifact/{id}) so you — or your AI — can check usage, limits, and which providers are active. See docs/DEPLOYMENT.md for the full list.


Quick Start

Option 1: Homebrew (macOS / Linux — recommended)```bash

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


Homebrew handles trust, updates, and PATH for you — no signing warnings.

### Option 2: One-command install (any OS — no dev tools needed)

**macOS / Linux:**```bash
curl -fsSL https://raw.githubusercontent.com/zoharbabin/web-researcher-mcp/main/install.sh | sh

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


Downloads the binary, verifies its SHA-256 checksum against the signed release, puts it on your PATH, and registers it with Claude Code if installed. Customize the install location:```bash
INSTALL_DIR=/opt/tools curl -fsSL https://raw.githubusercontent.com/zoharbabin/web-researcher-mcp/main/install.sh | sh

Other install methods

AUR (Arch Linux):```bash

Using any AUR helper (yay, paru, etc.)

yay -S web-researcher-mcp

Or manually: `git clone https://aur.archlinux.org/web-researcher-mcp.git && cd web-researcher-mcp && makepkg -si`

**Nix / NixOS:**```bash
# Run without installing
nix run github:zoharbabin/web-researcher-mcp

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

See packaging/nix/flake.nix for NixOS module usage.

Continue.dev:
Add to your Continue ~/.continue/config.json:```json
{
"mcpServers": {
"web-researcher": {
"command": "uvx",
"args": ["web-researcher-mcp"]
}
}
}

Or copy `packaging/continue/config.json` as a starting point.

**WinGet (Windows):**```powershell
winget install zoharbabin.web-researcher-mcp

Scoop (Windows):```powershell
scoop bucket add zoharbabin https://github.com/zoharbabin/scoop-bucket
scoop install web-researcher-mcp


**Chocolatey (Windows):**```powershell
choco install web-researcher-mcp

Homebrew Cask (macOS — Developer ID-signed + notarized binary):```bash
brew install --cask zoharbabin/tap/web-researcher-mcp

The cask ships the notarized darwin binary (Gatekeeper-clean). Most users want the formula above (`brew install zoharbabin/tap/web-researcher-mcp`), which the bare name resolves to; pass `--cask` explicitly for the notarized artifact.

**Go install** (if you have Go):```bash
go install github.com/zoharbabin/web-researcher-mcp/cmd/web-researcher-mcp@latest
claude mcp add --scope user web-researcher -- web-researcher-mcp

Docker:```bash

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


**Build from source:**```bash
git clone https://github.com/zoharbabin/web-researcher-mcp.git
cd web-researcher-mcp
go build -o web-researcher-mcp ./cmd/web-researcher-mcp

Connect to Your AI Assistant

The install script registers with Claude Code automatically. For other apps, add to your AI's config file:```json
{
"mcpServers": {
"web-researcher": {
"command": "web-researcher-mcp",
"env": {
"SEARCH_PROVIDER": "brave",
"BRAVE_API_KEY": "YOUR_BRAVE_API_KEY"
}
}
}
}


No key yet? Leave `env` out. DuckDuckGo works with no setup.

**Other clients:**

| Client | Where |
|---|---|
| Gemini CLI | `gemini mcp add web-researcher uvx web-researcher-mcp`, or the JSON block above in `~/.gemini/settings.json` |
| Codex | `~/.codex/config.toml`: `[mcp_servers.web-researcher]` with `command = "uvx"` and `args = ["web-researcher-mcp"]` |

Swap in any provider from the Configuration table by setting `SEARCH_PROVIDER` and that provider's key. Done — your AI assistant now has access to all research tools.

---

## Configuration

**No API key required.** DuckDuckGo is the built-in zero-config fallback — install and go. To raise result quality and unlock image/news search, add **any one** of the providers below. They're all optional and interchangeable — pick whichever you already use or prefer; the server treats them equally.

### Search providers

Set `SEARCH_PROVIDER=` and supply that provider's key. Every provider works with search lenses, and any of them can be combined for automatic failover (see Search Providers).

| Provider | `SEARCH_PROVIDER` | Key variable(s) | Get a key |
|----------|-------------------|-----------------|-----------|
| DuckDuckGo | `duckduckgo` | none | Built in — zero config |
| Google PSE | `google` | `GOOGLE_CUSTOM_SEARCH_API_KEY` + `GOOGLE_CUSTOM_SEARCH_ID` | cloud console + engine |
| Brave | `brave` | `BRAVE_API_KEY` | brave.com/search/api |
| Serper | `serper` | `SERPER_API_KEY` | serper.dev |
| SearchAPI.io | `searchapi` | `SEARCHAPI_API_KEY` | searchapi.io |
| You.com | `youcom` | `YOUDOTCOM_API_KEY` | you.com/docs/api-reference/search/v1-search |
| SearXNG | `searxng` | `SEARXNG_URL` | self-hosted |
| Tavily | `tavily` | `TAVILY_API_KEY` | app.tavily.com |
| Exa | `exa` | `EXA_API_KEY` | dashboard.exa.ai |
| Hacker News | `hackernews` | none | Built in — zero config (HN Algolia index) |
| Reddit | `reddit` | none | Built in — zero config (public RSS) |
| Bluesky | `bluesky` | none | Built in — zero config (public AT Protocol API) |
| GitHub | `github` | none (`GITHUB_TOKEN` optional, raises rate limit) | Built in — zero config (public REST Search API) |
| Xquik | `xquik` | `XQUIK_API_KEY` | dashboard.xquik.com |

> **Google PSE is ending.** Google closed its Custom Search JSON API to new customers and shuts it down on 2027-01-01 (Google). Existing keys work until then. For new setups, use Brave, Serper, SearXNG, or another provider.

> Each provider has its own free tier, signup flow, and capability mix (images, news, freshness). See **docs/PROVIDERS.md** for a full comparison (index classification, capability matrix, quick-pick guide) and **docs/API_SETUP.md** for step-by-step key setup. Set up more than one and the server fails over automatically — see Search Providers.

When `SEARCH_PROVIDER` is unset, the server uses Google if its keys are present and otherwise falls back to the zero-config DuckDuckGo provider — so it always works out of the box, with or without keys.

### Academic Search (Optional — no signup needed)

Academic search providers (OpenAlex, CrossRef) accept a contact email to unlock faster access via the polite pool — no registration, just an email. See docs/API_SETUP.md for setup and docs/DEPLOYMENT.md for the full variable reference.

> With these set, `academic_search` returns real papers with DOIs, authors, citation counts, and open-access PDF links. Without them, it still works but uses web search as a fallback.

### Patent Search (Optional)

Patent providers (EPO, USPTO, The Lens) require API keys for structured patent data. See docs/API_SETUP.md for step-by-step setup and docs/DEPLOYMENT.md for the full variable reference.

> With these, `patent_search` returns structured patent data with classification codes, dates, and inventors. Without them, it falls back to web search.

Advanced: HTTP mode, OAuth, and all other settings

HTTP mode, OAuth, rate limiting, cache, scraping, and observability settings are documented in docs/DEPLOYMENT.md.

---

## Under the Hood

Architecture (for developers and contributors)

The full per-package map and the layered diagram (MCP transports → tool dispatch → service layer → infrastructure) live in **ARCHITECTURE.md** — kept in one place to avoid drift.

Design Principles (for developers)

1. **Zero global state** -- all dependencies injected via constructors
2. **Interface-driven** -- every external dependency behind an interface for testing and swapping
3. **Bounded concurrency** -- explicit semaphores for external API calls
4. **Defense in depth** -- SSRF protection, rate limiting, content sanitization at every layer
5. **Fail loud** -- errors returned, never swallowed; validation at boundaries

---

## Search Providers

You choose which search engine powers your research. All of them work with lenses.

| Provider | Whole-Web | Images | News | Notes |
|----------|:---------:|:------:|:----:|-------|
| **DuckDuckGo** | Yes | — | — | Zero-config default (no API key needed); rate-limited for heavy use |
| **Google PSE** | Yes | Yes | Yes | Closed to new customers; ends 2027-01-01. Free tier: 100 queries/day |
| **Brave Search** | Yes | Yes | Yes | Independent index; free tier available |
| **Serper.dev** | Yes | Yes | Yes | Google-identical results |
| **SearXNG** | Yes | Yes | Yes | Self-hosted, privacy-first, air-gapped deployments |
| **SearchAPI.io** | Yes | Yes | Yes | Unified API with multiple engine backends |
| **You.com** | Yes | — | Yes | Web and news search via the You.com API |
| **Tavily** | Yes | — | Yes | AI-agent search; clean, LLM-ready content |
| **Exa** | Yes | — | Yes | Neural/semantic search; also backs `academic_search` and the optional paid scrape tier |
| **Hacker News** | HN only | — | Yes | Zero-config (HN Algolia index); searches HN threads, not the full web |
| **Reddit** | Reddit only | — | Yes | Zero-config (public RSS); searches Reddit posts, not the full web |
| **Bluesky** | Bluesky only | — | — | Zero-config (public AT Protocol API); searches Bluesky posts, not the full web |
| **GitHub** | GitHub only | — | Yes | Zero-config (public REST Search API); searches issues/PRs, not the full web |
| **Xquik** | X/Twitter only | — | Yes | Searches X posts, not the full web; needs `XQUIK_API_KEY` |

### Multiple Providers (recommended)

Set up multiple search engines so if one has issues, your research doesn't stop:```bash
export SEARCH_ROUTING=brave,serper,duckduckgo

If Brave is down, it automatically tries Serper. If Serper is rate-limited, it falls through to DuckDuckGo. Your research just works.

See docs/PROVIDERS.md for a full provider comparison (index classification, capabilities, free tiers) and docs/DEPLOYMENT.md for advanced routing options (per-topic routing, patent-specific providers, etc.).

Single Provider

If you only have one search API key, that works too — just set it up and go.

Provider Setup Examples

Multi-provider routing (recommended):```bash
export SEARCH_ROUTING=brave,serper
export BRAVE_API_KEY=BSAxxxxxxxxxx
export SERPER_API_KEY=...


**Single provider — Brave Search:**```bash
export SEARCH_PROVIDER=brave
export BRAVE_API_KEY=BSAxxxxxxxxxx

Single provider — SearXNG (self-hosted, privacy-first):```bash
export SEARCH_PROVIDER=searxng
export SEARXNG_URL=http://localhost:8080


**Single provider — Exa:**```bash
export SEARCH_PROVIDER=exa
export EXA_API_KEY=...

Single provider — Brave:```bash
export SEARCH_PROVIDER=brave
export BRAVE_API_KEY=BSA...


Any provider from the Configuration table works the same way — set `SEARCH_PROVIDER` and its key(s).

---

## Search Lenses

Search lenses let you control which websites your AI is allowed to search. Instead of searching the entire web (and getting blogs, spam, and AI-generated junk), a lens restricts results to only the sources you trust for that topic.

### Built-in Lenses

| Lens | Focus |
|------|-------|
| `docs` | Official documentation and API references only |
| `academic` | Preprint servers, repositories, open-access journals |
| `academic-extended` | Preprint servers, OA aggregators, and repositories beyond core journal indexes |
| `biomed` | Rare-disease and biomedical knowledge-graph sources — ontology portals, gene-disease databases, curated rare-disease registries |
| `clinical` | Clinical trials, drug safety, evidence-based medicine |
| `curriculum` | Academic curriculum data, institutional free speech climate, and global education statistics |
| `security` | CVEs, advisories, vulnerability research |
| `investigative_records` | Public records, corporate filings, FOIA |
| `programming` | Code docs, tutorials, Q&A |
| `programming-goggle` | Developer-first results re-ranked by Brave's Programming Goggle — surfaces docs, repos, and authoritative technical content (requires Brave) |
| `devops` | Infrastructure and operations — Kubernetes, Docker, Terraform, cloud, CI/CD |
| `news` | Current events, journalism |
| `tech` | Technology industry |
| `legal` | Law, cases, statutes |
| `medical` | Health, medicine |
| `finance` | Markets, filings |
| `science` | Research, papers |
| `government` | Policy, regulations |
| `osint` | Open-source intelligence — public records, corporate registries, social footprint, infrastructure |
| `awesome-lists` | Community-curated "awesome-*" lists on GitHub — PR-reviewed tool and resource collections across every domain |

You can also create your own lenses for any field — just list the domains you trust.

### How it works

When you (or your AI) use a lens, results come only from the sites in that lens. For example, using the `medical` lens means your AI searches PubMed, WHO, NIH, and other clinical sources — never health blogs or supplement ads.

Your AI uses lenses automatically when you ask it to. For example: *"Search for recent findings on SGLT2 inhibitors using the clinical lens."*

Creating Your Own Lens

Create a directory for your custom lenses and add a JSON file for each one:```json
{
  "name": "my-industry",
  "description": "Only searches sources I trust for my field",
  "domains": [
    "trusted-source.com",
    "industry-journal.org",
    "official-database.gov"
  ],
  "cx": ""
}

Then point the server to your lens directory:```bash

…(正文过长,页面只展示前面部分,完整内容见仓库)
```

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Web Researcher MCP 怎么安装?

在客户端按下面的安装命令接入:go install github.com/zoharbabin/web-researcher-mcp/cmd/web-researcher-mcp@latest\r。装完在客户端配置里引用同一个包或端点。

Web Researcher MCP 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Web Researcher MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Web Researcher MCP 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Web Researcher MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor、Codex、Zed;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Web Researcher MCP 能提供哪些能力?

资料显示能力标签包括 web search、research、citations、academic、patents、news。具体工具清单以官方文档为准。

Web Researcher MCP 需要什么运行环境?

运行时为 Cross-platform。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 未标注。