
kuraneko1/chrome-web-mcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
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
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_warningfires 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.enginereports who answered anddata.attemptslists every attempt. In visible (xephyr) mode the challenge window is left on screen so you can solve it yourself;last_captcha_atandengine_cooldowns_sinhealth_checkshow 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 raiseCW_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.
Установка
uvx --from chrome-web-mcp==0.3.0 chrome-web-mcpКонфигурация
{
"mcpServers": {
"chrome-web": {
"command": "uvx",
"args": ["--from", "chrome-web-mcp==0.3.0", "chrome-web-mcp"]
}
}
}