English Français العربية

io.github.zoharbabin/google-researcher

السجل الرسمي مؤرشف البحث والويب

MCP server providing Google Search, web scraping, and multi-source research tools for AI assistants

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package google-researcher-mcp
Claude Code 
claude mcp add google-researcher -e 'GOOGLE_CUSTOM_SEARCH_API_KEY=<your google_custom_search_api_key>' -e 'GOOGLE_CUSTOM_SEARCH_ID=<GOOGLE_CUSTOM_SEARCH_ID>' -- node -y google-researcher-mcp@6.3.3
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "google-researcher": {
            "command": "node",
            "args": [
                "-y",
                "google-researcher-mcp@6.3.3"
            ],
            "env": {
                "GOOGLE_CUSTOM_SEARCH_API_KEY": "<your google_custom_search_api_key>",
                "GOOGLE_CUSTOM_SEARCH_ID": "<GOOGLE_CUSTOM_SEARCH_ID>"
            }
        }
    }
}

متغيرات البيئة

  • GOOGLE_CUSTOM_SEARCH_API_KEY إلزامي سري Google Custom Search API key
  • GOOGLE_CUSTOM_SEARCH_ID إلزامي Google Programmable Search Engine ID

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. google-researcher-mcp — DEPRECATED
  2. Migrate in one line
  3. Why the Rewrite?
  4. Links

google-researcher-mcp — DEPRECATED

⚠️ This project has been superseded by web-researcher-mcp.

A complete rewrite in Go: same tools, but it cites real sources and stays honest — citation verification, retraction flagging, eight search providers behind one interface, and a single signed static binary. No Node.js, no npm.

Migrate in one line

Your API keys and tool calls don't change — only how the server is launched. Pick whichever you prefer (no Node required):

# macOS / Linux — installs the binary and registers it with Claude Code automatically:
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"

# Python users (uv) — run with no install:
uvx web-researcher-mcp
Before / after (MCP client config)

The config keeps the same shape — swap the command/args, keep your env:

// BEFORE — google-researcher-mcp (npx / Node)
{
  "mcpServers": {
    "google-researcher": {
      "command": "npx",
      "args": ["-y", "google-researcher-mcp"],
      "env": { "GOOGLE_CUSTOM_SEARCH_API_KEY": "…", "GOOGLE_CUSTOM_SEARCH_ID": "…" }
    }
  }
}

// AFTER — web-researcher-mcp (installed binary; or use "uvx" + args ["web-researcher-mcp"])
{
  "mcpServers": {
    "web-researcher": {
      "command": "web-researcher-mcp",
      "env": { "GOOGLE_CUSTOM_SEARCH_API_KEY": "…", "GOOGLE_CUSTOM_SEARCH_ID": "…" }
    }
  }
}

Don't run both at once — they register identical tool names. Remove the google-researcher entry before adding web-researcher.

→ Full migration guide

Your existing GOOGLE_CUSTOM_SEARCH_API_KEY and GOOGLE_CUSTOM_SEARCH_ID work unchanged.

Why the Rewrite?

Open IssueResolution in web-researcher-mcp
#108 — Orphan detection fails via npxGo binary has native process lifecycle (EOF/SIGPIPE) — no npm wrapper
#107 — Google discontinuing 'entire web' searchEight providers (Brave, Serper, SearXNG, SearchAPI, Tavily, Exa, DuckDuckGo + Google PSE for lenses) with automatic fallback
#55 — Support alternative search enginesMultiple engines behind one interface, plus a zero-config DuckDuckGo default
#72 — Add Redis cachingHybrid cache: memory + AES-encrypted disk + optional Redis
#40 — Split server.ts into modulesFully modular Go architecture (one package per concern)

Plus what's new: verify_citation and audit_bibliography (catch fabricated/retracted citations), academic / patent / SEC-filing / US-case-law / economic / clinical-trial search, and authority-weighted search lenses.

الأسئلة الشائعة

ما هو io.github.zoharbabin/google-researcher؟

MCP server providing Google Search, web scraping, and multi-source research tools for AI assistants

كيف أثبّت io.github.zoharbabin/google-researcher؟

يعمل على جهازك. في Claude Code: claude mcp add google-researcher -e 'GOOGLE_CUSTOM_SEARCH_API_KEY=<your google_custom_search_api_key>' -e 'GOOGLE_CUSTOM_SEARCH_ID=<GOOGLE_CUSTOM_SEARCH_ID>' -- node -y google-researcher-mcp@6.3.3. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.zoharbabin/google-researcher إلى مفتاح API؟

نعم. يتطلب GOOGLE_CUSTOM_SEARCH_API_KEY, GOOGLE_CUSTOM_SEARCH_ID، وتضبطها في إعداداته.

هل io.github.zoharbabin/google-researcher مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.zoharbabin/google-researcher؟

ينشره zoharbabin. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.