Web Researcher MCP

1) Cài đặt Web Researcher MCP (nhanh nhất: uvx): Cài đặt uv (một lần), sau đó chạy máy chủ MCP thông qua uvx. macOS/Linux: - curl -LsSf https://astral.sh/uv/install.sh | sh Sau đó: - claude mcp add --scope user web-researcher -- uvx web-researcher-mcp Thao tác này tìm nạp tệp nhị phân được xây dựng sẵn chính xác cho hệ điều hành của bạn và chạy nó (không cần bộ công cụ Go). Nguồn: https://github.com/zoharbabin/web-researcher-mcp?ref=producthunt

2) Các cách cài đặt thay thế (chọn một): macOS (Homebrew): - brew install zoharbabin/tap/web-researcher-mcp - claude mcp add --scope user web-researcher -- web-researcher-mcp macOS/Linux (trình cài đặt curl): - curl -fsSL https://raw.githubusercontent.com/zoharbabin/web-researcher-mcp/main/install.sh | sh Windows (trình cài đặt PowerShell): - powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/zoharbabin/web-researcher-mcp/main/install.ps1 | iex" Các tùy chọn khác: - winget install zoharbabin.web-researcher-mcp - scoop bucket add zoharbabin https://github.com/zoharbabin/scoop-bucket && scoop 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 - docker run -i --rm -e GOOGLE_CUSTOM_SEARCH_API_KEY=YOUR_KEY -e GOOGLE_CUSTOM_SEARCH_ID=YOUR_CX docker.io/zoharbabin/web-researcher-mcp:latest Nguồn: https://github.com/zoharbabin/web-researcher-mcp?ref=producthunt

3) Kết nối nó với máy khách MCP của bạn (cấu hình JSON chung): Nếu ứng dụng của bạn không phải là luồng CLI của Claude Code, hãy thêm một mục máy chủ MCP vào cấu hình máy khách của bạn. Ví dụ (Google PSE): { "mcpServers": { "web-researcher": { "command": "web-researcher-mcp", "env": { "SEARCH_PROVIDER": "google", "GOOGLE_CUSTOM_SEARCH_API_KEY": "YOUR_GOOGLE_API_KEY", "GOOGLE_CUSTOM_SEARCH_ID": "YOUR_SEARCH_ENGINE_ID" } } } } Ví dụ (Brave): { "mcpServers": { "web-researcher": { "command": "web-researcher-mcp", "env": { "SEARCH_PROVIDER": "brave", "BRAVE_API_KEY": "YOUR_BRAVE_API_KEY" } } } } Nguồn: https://github.com/zoharbabin/web-researcher-mcp?ref=producthunt

4) Chạy không cần cấu hình (dự phòng DuckDuckGo): Nếu bạn không đặt SEARCH_PROVIDER hoặc bất kỳ khóa API nào, Web Researcher MCP vẫn hoạt động ngay lập tức bằng cách sử dụng DuckDuckGo làm dự phòng tích hợp (không yêu cầu khóa API). Điều này hữu ích để xác thực thiết lập của bạn trước khi thêm khóa nhà cung cấp. Nguồn: https://github.com/zoharbabin/web-researcher-mcp?ref=producthunt

5) (Khuyến nghị) Thêm khóa nhà cung cấp tìm kiếm để cải thiện chất lượng và mở khóa nhiều tính năng hơn: Đặt SEARCH_PROVIDER và (các) khóa phù hợp. Các nhà cung cấp được hỗ trợ bao gồm DuckDuckGo (không có khóa), Google PSE, Brave, Serper, SearchAPI.io, SearXNG, Tavily, Exa và Hacker News. Ví dụ biến môi trường: - SEARCH_PROVIDER=brave - BRAVE_API_KEY=... Hoặc Google PSE: - SEARCH_PROVIDER=google - GOOGLE_CUSTOM_SEARCH_API_KEY=... - GOOGLE_CUSTOM_SEARCH_ID=... Nguồn: https://github.com/zoharbabin/web-researcher-mcp?ref=producthunt

6) (Tùy chọn) Cấu hình chuyển đổi dự phòng đa nhà cung cấp: Để tránh thời gian chết/giới hạn tốc độ, hãy cấu hình nhiều nhà cung cấp để máy chủ tự động chuyển đổi dự phòng. Ví dụ: - SEARCH_ROUTING=brave,google,serper - BRAVE_API_KEY=... - GOOGLE_CUSTOM_SEARCH_API_KEY=... - GOOGLE_CUSTOM_SEARCH_ID=... - SERPER_API_KEY=... Nguồn: https://github.com/zoharbabin/web-researcher-mcp?ref=producthunt

7) Sử dụng “ống kính tìm kiếm” để giới hạn kết quả cho các nguồn đáng tin cậy: Khi bạn muốn độ tin cậy cao hơn và ít thư rác hơn, hãy sử dụng một ống kính tích hợp (ví dụ: y tế, pháp lý, học thuật, tin tức) để các tìm kiếm được giới hạn trong các miền được quản lý. Ví dụ lời nhắc cho máy khách AI của bạn: - “Tìm kiếm các phát hiện gần đây về thuốc ức chế SGLT2 bằng cách sử dụng ống kính lâm sàng.” Bạn cũng có thể tạo các ống kính tùy chỉnh bằng cách thêm một tệp JSON trong thư mục lenses/ với danh sách cho phép miền. Nguồn: https://github.com/zoharbabin/web-researcher-mcp?ref=producthunt

8) Yêu cầu AI của bạn sử dụng các công cụ cốt lõi (quy trình làm việc phổ biến): Sau khi được kết nối, AI của bạn có thể gọi các công cụ như: - web_search: tìm kiếm web (tùy chọn với ống kính) - scrape_page: đọc toàn bộ URL (trang web, PDF, DOCX, PPTX, bản ghi YouTube) - search_and_scrape: tìm kiếm sau đó tự động đọc các kết quả hàng đầu - news_search / image_search: khi được nhà cung cấp của bạn hỗ trợ - academic_search / patent_search / legal_search / filing_search / econ_search / clinical_search: cơ sở dữ liệu chuyên biệt - verify_citation / audit_bibliography / format_bibliography: quy trình làm việc trích dẫn - sequential_search: nghiên cứu sâu nhiều bước Nguồn: https://github.com/zoharbabin/web-researcher-mcp?ref=producthunt

9) Sử dụng các mẫu lời nhắc có hướng dẫn để nghiên cứu lặp lại: Sử dụng các mẫu lời nhắc tích hợp (nơi máy khách của bạn hỗ trợ lựa chọn lời nhắc) để chạy các quy trình làm việc có cấu trúc: - comprehensive-research - fact-check - competitive-analysis - literature-review Các mẫu này hướng dẫn nghiên cứu nhiều bước để bạn không phải chỉ định mọi hướng dẫn. Nguồn: https://github.com/zoharbabin/web-researcher-mcp?ref=producthunt

10) Khắc phục sự cố thường gặp (sửa lỗi nhanh): Nếu các công cụ bị lỗi với lỗi “khóa API”: đặt khóa trong khối env cấu hình máy khách MCP của bạn (không chỉ trong hồ sơ shell). Nếu các trang trống rỗng: các trang web nặng JavaScript yêu cầu Chromium; tệp nhị phân tự động tải xuống Chromium khi sử dụng lần đầu (~200MB). Bạn có thể đặt CHROME_PATH thành một cài đặt Chrome hiện có. Hình ảnh Docker bao gồm Chromium. Nếu bộ nhớ cache bị lỗi thời sau khi nâng cấp: xóa thư mục bộ nhớ cache (ví dụ: ~/Library/Caches/web-researcher-mcp/ trên macOS) hoặc đặt CACHE_DIR. Nếu bạn gặp giới hạn tốc độ của nhà cung cấp (429): chuyển đổi nhà cung cấp hoặc cấu hình SEARCH_ROUTING để chuyển đổi dự phòng. Nguồn: https://github.com/zoharbabin/web-researcher-mcp?ref=producthunt

11) (Nhóm) Chạy ở chế độ HTTP và kết nối máy khách với một điểm cuối dùng chung: Đối với các thiết lập dùng chung/nhóm, hãy chạy máy chủ dưới dạng dịch vụ HTTP và kết nối các máy khách MCP với http://localhost:3000/mcp/. Ví dụ: - PORT=3000 OAUTH_ISSUER_URL=https://auth.example.com OAUTH_AUDIENCE=https://api.example.com ./web-researcher-mcp Ví dụ Docker Compose: services: web-researcher: image: zoharbabin/web-researcher-mcp ports: - "3000:3000" environment: PORT: "3000" SEARCH_PROVIDER: brave BRAVE_API_KEY: ${BRAVE_API_KEY} Nguồn: https://github.com/zoharbabin/web-researcher-mcp?ref=producthunt