KC

kuraneko1/chrome-web-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

69 stars 6 forks Качество 81 Тренд 28MIT

Windows и macOS не поддерживаются. Использование Docker не меняет политику поддержки хоста.

Обзор

Windows и macOS не поддерживаются. Использование Docker не меняет политику поддержки хоста. Односессионное использование: один клиентский процесс, один браузер, последовательный поиск. Нормальное использование никогда не сбивает ограничитель: pace warning загорается только при 15+ поисках в минуту. Последовательное или слегка параллельное использование остается далеко ниже. Предупреждение является консультативным, а не блоком: поиски продолжаются. Но Google также подсчитывает общий объем — устойчивые барражи заканчиваются в CAPTCHA независимо от скорости (наблюдается после десятков поисков за одну сессию). При вызове: подождите несколько минут и повторите в безголовом (xvfb) режиме — он обычно проясняется сам по себе; в видимом (xephyr) режиме решите задачу в окне chrome-web-mcp самостоятельно, затем повторите. last captcha at in health check показывает последний хит. Открытый код + субагенты: безопасно. Все агенты используют один серверный процесс и один браузер.

Обзор (машинный перевод)

Читать далее

Поддерживаемая ОС: Linux и macOS. Порт macOS использует собственный Chrome (видимо) [T0] и не требует X11. Windows не поддерживается. См. docs/macos.md для настройки macOS, проект-локальный Chrome для Тестирование и детали выполнения.

[!Осуждение] Один браузер за один профиль — несколько клиентских процессов MCP совместно используют его.

Нормальное использование никогда не сбивает ограничитель: pace_warning срабатывает только при 15+ Поиск в минуту. Последовательное или слегка параллельное использование остается далеко ниже. Предупреждение является консультативным, а не блоком: поиски продолжаются. Но Google

также подсчитывает общий объем, поэтому сервер дрожит сам: max_searches_per_hour (по умолчанию 60) и экспоненциальное охлаждение CAPTCHA. Google CAPTCHA больше не завершает звонок. Google переходит на общее охлаждение На этот же вопрос отвечает следующий движок search_engines. (DuckDuckGo, Brave, Bing и, по умолчанию, SearXNG). [4], которые отвечают, и [5] перечисляют каждую попытку. В видимом (xephyr) режиме окно вызова оставлено на экране, чтобы вы могли [7] и [8], [[8]], [[8]], [[Т]], [[Т]]

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

chrome-web-mcp

日本語版 README

Supported OS: Linux and macOS. The macOS port uses native Chrome (visible or --headless=new) and does not require X11. Windows is not supported. See docs/macos.md for macOS setup, project-local Chrome for Testing, and runtime details.

[!CAUTION] One browser at a time per profile — several MCP client processes share it.

  • Normal use never trips the limiter: pace_warning fires only at 15+ searches per minute. Sequential or lightly-parallel use stays far below it.
  • A warning is advisory, not a block: searches keep running. But Google counts total volume too, so the server throttles itself: max_searches_per_hour (default 60) and an exponential CAPTCHA cooldown.
  • A Google CAPTCHA no longer ends the call. Google goes on a shared cooldown and the same query is answered by the next engine in search_engines (DuckDuckGo, Brave, Bing, and optionally a self-hosted SearXNG by default). data.engine reports who answered and data.attempts lists every attempt. In visible (xephyr) mode the challenge window is left on screen so you can solve it yourself; last_captcha_at and engine_cooldowns_s in health_check show the current state. Recovery is worth waiting for: sustained barrages end in CAPTCHA regardless of pacing, so if every engine is cooling down, wait a few minutes and retry.
  • opencode + subagents: SAFE. All agents share one server process and one browser. Concurrent searches are pooled in a shared query queue (per-process lock + SQLite pacing) and executed sequentially — verified with 3 simultaneous subagents and 35 rapid searches, no CAPTCHA.
  • Separate processes share one browser: the first process to claim the persistent profile owns Chrome/Xvfb and publishes its CDP endpoint; later processes attach to that browser (each keeps its own tabs), so N sessions cost one ~600 MB browser tree instead of N. If the registry file is missing or unusable, a process with a busy profile still falls back to its own throwaway profile exactly as before (profile_shared_fallback: true). Stagger starts by seconds or raise CW_MIN_DELAY / CW_MAX_DELAY.

A stdio Model Context Protocol server that exposes focused browser tools:

  • google_search — Google search through a JavaScript-rendered Chrome instance, with automatic fallback to other engines when Google challenges.
  • fetch_url — JavaScript-rendered readable text extraction for public HTTP(S) URLs.
  • health_check — display, browser, queue, CAPTCHA, profile, engine, and idle release status.

The server is designed to be configured by any MCP client that can launch a stdio command.

Features

  • JS-rendered Google search + public URL fetch through real Chrome. Linux uses Xephyr/Xvfb; macOS uses native visible Chrome or native --headless=new.
Открыть полный README на GitHub

Установка

uvx --from chrome-web-mcp==0.3.0 chrome-web-mcp
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "chrome-web": { "command": "uvx", "args": ["--from", "chrome-web-mcp==0.3.0", "chrome-web-mcp"] } } }