capguru-mcp

English | Русский

MCP server for the Cap.Guru captcha solving service. It lets AI assistants (Claude Desktop, Claude Code, Cursor and other MCP clients) open web pages in a browser and solve captchas on them.

Supported: reCAPTCHA v2/v3, Cloudflare Turnstile, text (image) captchas, hCaptcha, GeeTest v3/v4, FunCaptcha (Arkose Labs), TikTok, AWS WAF, Yandex SmartCaptcha.

Installation

pip install capguru-mcp
playwright install chromium

Connecting to an MCP client

Claude Desktop (claude_desktop_config.json), Cursor (.cursor/mcp.json) and most other clients:

{
  "mcpServers": {
    "capguru": {
      "command": "capguru-mcp",
      "env": {
        "CAPGURU_API_KEY": "YOUR_KEY"
      }
    }
  }
}

Claude Code:

claude mcp add capguru --env CAPGURU_API_KEY=YOUR_KEY -- capguru-mcp

Without installing (via uv): use "command": "uvx", "args": ["capguru-mcp"].

Tools

Example requests to the assistant:

• "Open https://site.com/login, solve the captcha and take a screenshot."
• "Get a reCAPTCHA token for sitekey 6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ- on https://www.google.com/recaptcha/api2/demo."
• "Get a reCAPTCHA v3 token for sitekey 6Ldb4ccaAAAAACMxv8uxUIMckZy1og98rs_h3AmO on http://learn.captcha.guru/ln/recap3/."
• "Open https://react-turnstile.vercel.app/basic and solve the Turnstile."
• "Recognize the captcha image #captcha_img and type the answer into #captcha_input."

solve_recaptcha_token uses the Cap.Guru token method (userrecaptcha): it returns the g-recaptcha-response token. If a page is open, the sitekey, URL and User-Agent are taken from it; for v2 the token is inserted into the page and the site callback is called. For v3 pass version: v3 (optionally min_score, service default 0.1); the token is only returned, because v3 sites request it themselves.

solve_turnstile_token works the same way for Cloudflare Turnstile (method=turnstile): with an open page the token is put into cf-turnstile-response and the Turnstile callback is called. Typical solve time is 10–30 seconds.

Settings (environment variables)

Full documentation: https://docs.cap.guru

Русский

MCP-сервер для сервиса решения капчи Cap.Guru. Позволяет ИИ-ассистентам (Claude Desktop, Claude Code, Cursor и другим MCP-клиентам) открывать страницы в браузере и решать на них капчу.

Поддерживаются: reCAPTCHA v2/v3, Cloudflare Turnstile, текстовые капчи (картинкой), hCaptcha, GeeTest v3/v4, FunCaptcha (Arkose Labs), TikTok, AWS WAF, Яндекс SmartCaptcha.

Установка

pip install capguru-mcp
playwright install chromium

Подключение к MCP-клиенту

Claude Desktop (claude_desktop_config.json), Cursor (.cursor/mcp.json) и большинство других клиентов:

{
  "mcpServers": {
    "capguru": {
      "command": "capguru-mcp",
      "env": {
        "CAPGURU_API_KEY": "ВАШ_КЛЮЧ"
      }
    }
  }
}

Claude Code:

claude mcp add capguru --env CAPGURU_API_KEY=ВАШ_КЛЮЧ -- capguru-mcp

Без установки (через uv): "command": "uvx", "args": ["capguru-mcp"].

Инструменты

Примеры запросов ассистенту:

• «Открой https://site.com/login, реши капчу и сделай скриншот».
• «Получи токен reCAPTCHA для sitekey 6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ- на https://www.google.com/recaptcha/api2/demo».
• «Получи токен reCAPTCHA v3 для sitekey 6Ldb4ccaAAAAACMxv8uxUIMckZy1og98rs_h3AmO на http://learn.captcha.guru/ln/recap3/».
• «Открой https://react-turnstile.vercel.app/basic и реши Turnstile».
• «Распознай капчу с картинки #captcha_img и введи ответ в #captcha_input».

solve_recaptcha_token использует токенный метод Cap.Guru (userrecaptcha) и возвращает токен g-recaptcha-response. Если страница открыта, sitekey, адрес и User-Agent берутся с неё; для v2 токен вставляется на страницу и вызывается callback сайта. Для v3 укажите version: v3 (и при необходимости min_score, по умолчанию у сервиса 0.1); токен только возвращается, потому что сайты с v3 запрашивают его сами.

solve_turnstile_token так же работает для Cloudflare Turnstile (method=turnstile): если страница открыта, токен вставляется в cf-turnstile-response и вызывается callback Turnstile. Обычное время решения — 10–30 секунд.

Настройки (переменные окружения)

Полная документация: https://docs.cap.guru