PyPI - capguru-mcp - Versions diffs - 0.2.0__tar.gz - Mend

capguru-mcp 0.2.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

capguru_mcp-0.2.0/PKG-INFO +183 -0
capguru_mcp-0.2.0/README.md +167 -0
capguru_mcp-0.2.0/capguru_mcp/__init__.py +1 -0
capguru_mcp-0.2.0/capguru_mcp/__main__.py +3 -0
capguru_mcp-0.2.0/capguru_mcp/server.py +591 -0
capguru_mcp-0.2.0/capguru_mcp.egg-info/PKG-INFO +183 -0
capguru_mcp-0.2.0/capguru_mcp.egg-info/SOURCES.txt +11 -0
capguru_mcp-0.2.0/capguru_mcp.egg-info/dependency_links.txt +1 -0
capguru_mcp-0.2.0/capguru_mcp.egg-info/entry_points.txt +2 -0
capguru_mcp-0.2.0/capguru_mcp.egg-info/requires.txt +3 -0
capguru_mcp-0.2.0/capguru_mcp.egg-info/top_level.txt +1 -0
capguru_mcp-0.2.0/pyproject.toml +31 -0
capguru_mcp-0.2.0/setup.cfg +4 -0

capguru_mcp-0.2.0/PKG-INFO ADDED Viewed

@@ -0,0 +1,183 @@
+Metadata-Version: 2.4
+Name: capguru-mcp
+Version: 0.2.0
+Summary: MCP server for the Cap.Guru captcha solving service: lets AI assistants open pages and solve reCAPTCHA v2/v3, Cloudflare Turnstile, text captchas, hCaptcha, GeeTest, FunCaptcha, TikTok, AWS WAF and Yandex SmartCaptcha
+Author: Cap.Guru
+Project-URL: Homepage, https://cap.guru
+Project-URL: Documentation, https://docs.cap.guru
+Keywords: mcp,captcha,solver,playwright,cap.guru,claude,cursor,turnstile,recaptcha
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: mcp>=1.2
+Requires-Dist: capguru>=0.4.0
+Requires-Dist: playwright>=1.40
+# capguru-mcp
+**English** | [Русский](#русский)
+MCP server for the [Cap.Guru](https://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:
+```json
+{
+  "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](https://docs.astral.sh/uv/)): use `"command": "uvx", "args": ["capguru-mcp"]`.
+## Tools
+| Tool | Description |
+|---|---|
+| `open_browser` | Launch a browser (`headless`, `channel`: `chrome`/`msedge`, `proxy`) |
+| `connect_browser` | Connect to a running Chrome started with `--remote-debugging-port` |
+| `goto` | Open a URL |
+| `click`, `fill` | Click an element, type text into an input |
+| `screenshot` | Screenshot of the page |
+| `page_info` | Current URL and title |
+| `detect_captcha` | Detect the captcha type without solving |
+| `solve_captcha` | Solve the captcha: `auto` or a specific type |
+| `solve_recaptcha_token` | Get a reCAPTCHA v2 / v2 Invisible / v3 token (`sitekey`, `pageurl`, `version`, `min_score`); works without a browser too |
+| `solve_turnstile_token` | Get a Cloudflare Turnstile token (`sitekey`, `pageurl`); works without a browser too |
+| `solve_image_captcha` | Recognize a text captcha from an image: element `selector`, `image_base64`, `image_path` or `image_url`; optional `vernet`, `fill_selector` |
+| `close_browser` | Close the browser |
+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)
+| Variable | Default | Description |
+|---|---|---|
+| `CAPGURU_API_KEY` | — | Cap.Guru API key (required) |
+| `CAPGURU_SERVER` | `https://api.cap.guru` | API server |
+| `CAPGURU_ATTEMPTS` | `5` | Max number of solving attempts |
+| `CAPGURU_DEBUG` | `1` | Include the solver log in tool results |
+| `CAPGURU_BROWSER_CHANNEL` | — | `chrome` or `msedge` to use an installed browser |
+| `CAPGURU_BROWSER_PATH` | — | Path to a browser executable |
+| `CAPGURU_BROWSER_ARGS` | — | Extra browser arguments, space separated |
+Full documentation: https://docs.cap.guru
+---
+## Русский
+MCP-сервер для сервиса решения капчи [Cap.Guru](https://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`) и большинство других клиентов:
+```json
+{
+  "mcpServers": {
+    "capguru": {
+      "command": "capguru-mcp",
+      "env": {
+        "CAPGURU_API_KEY": "ВАШ_КЛЮЧ"
+      }
+    }
+  }
+}
+```
+Claude Code:
+```
+claude mcp add capguru --env CAPGURU_API_KEY=ВАШ_КЛЮЧ -- capguru-mcp
+```
+Без установки (через [uv](https://docs.astral.sh/uv/)): `"command": "uvx", "args": ["capguru-mcp"]`.
+### Инструменты
+| Инструмент | Описание |
+|---|---|
+| `open_browser` | Запустить браузер (`headless`, `channel`: `chrome`/`msedge`, `proxy`) |
+| `connect_browser` | Подключиться к запущенному Chrome с `--remote-debugging-port` |
+| `goto` | Открыть адрес |
+| `click`, `fill` | Нажать на элемент, ввести текст в поле |
+| `screenshot` | Скриншот страницы |
+| `page_info` | Текущий адрес и заголовок |
+| `detect_captcha` | Определить тип капчи, не решая |
+| `solve_captcha` | Решить капчу: `auto` или конкретный тип |
+| `solve_recaptcha_token` | Получить токен reCAPTCHA v2 / v2 Invisible / v3 (`sitekey`, `pageurl`, `version`, `min_score`); работает и без браузера |
+| `solve_turnstile_token` | Получить токен Cloudflare Turnstile (`sitekey`, `pageurl`); работает и без браузера |
+| `solve_image_captcha` | Распознать текстовую капчу с картинки: элемент `selector`, `image_base64`, `image_path` или `image_url`; по желанию `vernet`, `fill_selector` |
+| `close_browser` | Закрыть браузер |
+Примеры запросов ассистенту:
+- *«Открой 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 секунд.
+### Настройки (переменные окружения)
+| Переменная | По умолчанию | Описание |
+|---|---|---|
+| `CAPGURU_API_KEY` | — | API-ключ Cap.Guru (обязательно) |
+| `CAPGURU_SERVER` | `https://api.cap.guru` | Сервер API |
+| `CAPGURU_ATTEMPTS` | `5` | Макс. количество попыток |
+| `CAPGURU_DEBUG` | `1` | Добавлять лог солвера в ответ инструмента |
+| `CAPGURU_BROWSER_CHANNEL` | — | `chrome` или `msedge`, чтобы использовать установленный браузер |
+| `CAPGURU_BROWSER_PATH` | — | Путь к исполняемому файлу браузера |
+| `CAPGURU_BROWSER_ARGS` | — | Дополнительные аргументы браузера через пробел |
+Полная документация: https://docs.cap.guru

capguru_mcp-0.2.0/README.md ADDED Viewed

@@ -0,0 +1,167 @@
+# capguru-mcp
+**English** | [Русский](#русский)
+MCP server for the [Cap.Guru](https://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:
+```json
+{
+  "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](https://docs.astral.sh/uv/)): use `"command": "uvx", "args": ["capguru-mcp"]`.
+## Tools
+| Tool | Description |
+|---|---|
+| `open_browser` | Launch a browser (`headless`, `channel`: `chrome`/`msedge`, `proxy`) |
+| `connect_browser` | Connect to a running Chrome started with `--remote-debugging-port` |
+| `goto` | Open a URL |
+| `click`, `fill` | Click an element, type text into an input |
+| `screenshot` | Screenshot of the page |
+| `page_info` | Current URL and title |
+| `detect_captcha` | Detect the captcha type without solving |
+| `solve_captcha` | Solve the captcha: `auto` or a specific type |
+| `solve_recaptcha_token` | Get a reCAPTCHA v2 / v2 Invisible / v3 token (`sitekey`, `pageurl`, `version`, `min_score`); works without a browser too |
+| `solve_turnstile_token` | Get a Cloudflare Turnstile token (`sitekey`, `pageurl`); works without a browser too |
+| `solve_image_captcha` | Recognize a text captcha from an image: element `selector`, `image_base64`, `image_path` or `image_url`; optional `vernet`, `fill_selector` |
+| `close_browser` | Close the browser |
+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)
+| Variable | Default | Description |
+|---|---|---|
+| `CAPGURU_API_KEY` | — | Cap.Guru API key (required) |
+| `CAPGURU_SERVER` | `https://api.cap.guru` | API server |
+| `CAPGURU_ATTEMPTS` | `5` | Max number of solving attempts |
+| `CAPGURU_DEBUG` | `1` | Include the solver log in tool results |
+| `CAPGURU_BROWSER_CHANNEL` | — | `chrome` or `msedge` to use an installed browser |
+| `CAPGURU_BROWSER_PATH` | — | Path to a browser executable |
+| `CAPGURU_BROWSER_ARGS` | — | Extra browser arguments, space separated |
+Full documentation: https://docs.cap.guru
+---
+## Русский
+MCP-сервер для сервиса решения капчи [Cap.Guru](https://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`) и большинство других клиентов:
+```json
+{
+  "mcpServers": {
+    "capguru": {
+      "command": "capguru-mcp",
+      "env": {
+        "CAPGURU_API_KEY": "ВАШ_КЛЮЧ"
+      }
+    }
+  }
+}
+```
+Claude Code:
+```
+claude mcp add capguru --env CAPGURU_API_KEY=ВАШ_КЛЮЧ -- capguru-mcp
+```
+Без установки (через [uv](https://docs.astral.sh/uv/)): `"command": "uvx", "args": ["capguru-mcp"]`.
+### Инструменты
+| Инструмент | Описание |
+|---|---|
+| `open_browser` | Запустить браузер (`headless`, `channel`: `chrome`/`msedge`, `proxy`) |
+| `connect_browser` | Подключиться к запущенному Chrome с `--remote-debugging-port` |
+| `goto` | Открыть адрес |
+| `click`, `fill` | Нажать на элемент, ввести текст в поле |
+| `screenshot` | Скриншот страницы |
+| `page_info` | Текущий адрес и заголовок |
+| `detect_captcha` | Определить тип капчи, не решая |
+| `solve_captcha` | Решить капчу: `auto` или конкретный тип |
+| `solve_recaptcha_token` | Получить токен reCAPTCHA v2 / v2 Invisible / v3 (`sitekey`, `pageurl`, `version`, `min_score`); работает и без браузера |
+| `solve_turnstile_token` | Получить токен Cloudflare Turnstile (`sitekey`, `pageurl`); работает и без браузера |
+| `solve_image_captcha` | Распознать текстовую капчу с картинки: элемент `selector`, `image_base64`, `image_path` или `image_url`; по желанию `vernet`, `fill_selector` |
+| `close_browser` | Закрыть браузер |
+Примеры запросов ассистенту:
+- *«Открой 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 секунд.
+### Настройки (переменные окружения)
+| Переменная | По умолчанию | Описание |
+|---|---|---|
+| `CAPGURU_API_KEY` | — | API-ключ Cap.Guru (обязательно) |
+| `CAPGURU_SERVER` | `https://api.cap.guru` | Сервер API |
+| `CAPGURU_ATTEMPTS` | `5` | Макс. количество попыток |
+| `CAPGURU_DEBUG` | `1` | Добавлять лог солвера в ответ инструмента |
+| `CAPGURU_BROWSER_CHANNEL` | — | `chrome` или `msedge`, чтобы использовать установленный браузер |
+| `CAPGURU_BROWSER_PATH` | — | Путь к исполняемому файлу браузера |
+| `CAPGURU_BROWSER_ARGS` | — | Дополнительные аргументы браузера через пробел |
+Полная документация: https://docs.cap.guru

capguru_mcp-0.2.0/capguru_mcp/__init__.py ADDED Viewed

	@@ -0,0 +1 @@
1	+ __version__ = '0.2.0'

capguru_mcp-0.2.0/capguru_mcp/__main__.py ADDED Viewed

@@ -0,0 +1,3 @@
+from .server import main
+main()

capguru_mcp-0.2.0/capguru_mcp/server.py ADDED Viewed

@@ -0,0 +1,591 @@
+from __future__ import annotations
+import base64
+import contextlib
+import functools
+import io
+import os
+import sys
+from typing import Optional
+try:
+    from mcp.server.mcpserver import MCPServer as _Server, Image
+    from mcp.server.mcpserver.exceptions import ToolError
+except ImportError:
+    from mcp.server.fastmcp import FastMCP as _Server, Image
+    from mcp.server.fastmcp.exceptions import ToolError
+from captcha_solver import CaptchaSolver, CapGuruFatalError
+from captcha_solver.capguru_client import CapGuruClient
+INSTRUCTIONS = (
+    'Cap.Guru captcha solver. Typical flow: open_browser (or connect_browser) -> goto(url) -> '
+    'interact with the page (click/fill) until a captcha appears -> solve_captcha(). '
+    'Use screenshot() to see the page. Supported: reCAPTCHA v2, hCaptcha, GeeTest v3/v4, '
+    'FunCaptcha, TikTok, AWS WAF, Yandex SmartCaptcha. '
+    'For reCAPTCHA v2 / v2 Invisible / v3 you can also get a token without solving images: '
+    'solve_recaptcha_token(sitekey, pageurl, version), it works with or without an open browser. '
+    'Cloudflare Turnstile is solved the same way with solve_turnstile_token(sitekey, pageurl). '
+    'Text (image) captchas: solve_image_captcha(selector or image), optionally fill_selector to type the answer.'
+)
+mcp = _Server('capguru', instructions=INSTRUCTIONS)
+def tool(fn):
+    @functools.wraps(fn)
+    async def wrapper(*args, **kwargs):
+        try:
+            return await fn(*args, **kwargs)
+        except ToolError:
+            raise
+        except Exception as e:
+            raise ToolError(f'{type(e).__name__}: {e}') from e
+    return mcp.tool()(wrapper)
+SOLVE_METHODS = {
+    'auto': None,
+    'recaptcha2': 'solve_recaptcha2',
+    'hcaptcha': 'solve_hcaptcha',
+    'yandex': 'solve_other',
+    'geetest': 'solve_geetest',
+    'funcaptcha': 'solve_funcaptcha',
+    'tiktok': 'solve_tiktok',
+    'aws': 'solve_aws',
+}
+class _State:
+    def __init__(self) -> None:
+        self.pw = None
+        self.browser = None
+        self.context = None
+        self.page = None
+        self.solver: Optional[CaptchaSolver] = None
+        self.owns_browser = False
+S = _State()
+class _Tee(io.TextIOBase):
+    def __init__(self) -> None:
+        self.buf = io.StringIO()
+    def write(self, s: str) -> int:
+        self.buf.write(s)
+        sys.stderr.write(s)
+        return len(s)
+@contextlib.contextmanager
+def _capture():
+    tee = _Tee()
+    with contextlib.redirect_stdout(tee):
+        yield tee
+def _api_key() -> str:
+    key = os.environ.get('CAPGURU_API_KEY', '').strip()
+    if not key:
+        raise RuntimeError('CAPGURU_API_KEY environment variable is not set in the MCP server config')
+    return key
+def _server_url() -> str:
+    return os.environ.get('CAPGURU_SERVER', '').strip() or 'https://api.cap.guru'
+def _debug() -> bool:
+    return os.environ.get('CAPGURU_DEBUG', '1').strip().lower() not in ('0', 'false', 'no', '')
+def _attempts() -> int:
+    try:
+        return max(1, int(os.environ.get('CAPGURU_ATTEMPTS', '5')))
+    except ValueError:
+        return 5
+async def _ensure_playwright():
+    if S.pw is None:
+        from playwright.async_api import async_playwright
+        S.pw = await async_playwright().start()
+    return S.pw
+TURNSTILE_HOOK_JS = """(() => {
+    if (window.__cgTurnstileHooked) return;
+    window.__cgTurnstileHooked = true;
+    window.__cgTurnstile = [];
+    const wrap = (ts) => {
+        if (!ts || ts.__cgWrapped || typeof ts.render !== 'function') return ts;
+        const orig = ts.render.bind(ts);
+        ts.render = function (el, params) {
+            try { window.__cgTurnstile.push(Object.assign({}, params || {})); } catch (e) {}
+            return orig(el, params);
+        };
+        ts.__cgWrapped = true;
+        return ts;
+    };
+    let current = window.turnstile;
+    try {
+        Object.defineProperty(window, 'turnstile', {
+            configurable: true,
+            get() { return current; },
+            set(v) { current = wrap(v); },
+        });
+    } catch (e) {}
+    if (current) wrap(current);
+})();"""
+async def _attach(page) -> None:
+    S.page = page
+    try:
+        await page.context.add_init_script(TURNSTILE_HOOK_JS)
+    except Exception:
+        pass
+    with _capture():
+        S.solver = CaptchaSolver(
+            page=page,
+            api_key=_api_key(),
+            server=_server_url(),
+            attempts=_attempts(),
+            debug=_debug(),
+        )
+        await S.solver.setup()
+def _require_page():
+    if S.page is None or S.page.is_closed():
+        raise RuntimeError('No browser page. Call open_browser or connect_browser first.')
+    return S.page
+async def _close() -> None:
+    try:
+        if S.solver is not None:
+            S.solver.close()
+    except Exception:
+        pass
+    try:
+        if S.owns_browser and S.browser is not None:
+            await S.browser.close()
+    except Exception:
+        pass
+    S.browser = S.context = S.page = S.solver = None
+    S.owns_browser = False
+@tool
+async def open_browser(headless: bool = False, channel: str = '', proxy: str = '') -> str:
+    """Launch a new Chromium browser with one page and attach the captcha solver to it.
+    headless: run without a visible window.
+    channel: 'chrome' or 'msedge' to use an installed browser instead of bundled Chromium.
+    proxy: optional proxy, e.g. 'http://user:pass@host:port'.
+    """
+    await _close()
+    pw = await _ensure_playwright()
+    kwargs = {'headless': headless}
+    channel = channel or os.environ.get('CAPGURU_BROWSER_CHANNEL', '')
+    if channel:
+        kwargs['channel'] = channel
+    exe = os.environ.get('CAPGURU_BROWSER_PATH', '')
+    if exe:
+        kwargs['executable_path'] = exe
+    args = [a for a in os.environ.get('CAPGURU_BROWSER_ARGS', '').split() if a]
+    if args:
+        kwargs['args'] = args
+    if proxy:
+        from urllib.parse import urlsplit
+        u = urlsplit(proxy)
+        p = {'server': f'{u.scheme}://{u.hostname}:{u.port}' if u.port else f'{u.scheme}://{u.hostname}'}
+        if u.username:
+            p['username'] = u.username
+            p['password'] = u.password or ''
+        kwargs['proxy'] = p
+    S.browser = await pw.chromium.launch(**kwargs)
+    S.owns_browser = True
+    S.context = await S.browser.new_context()
+    page = await S.context.new_page()
+    await _attach(page)
+    return 'Browser opened. Use goto(url) to open a page.'
+@tool
+async def connect_browser(cdp_url: str = 'http://127.0.0.1:9222') -> str:
+    """Connect to an already running Chrome started with --remote-debugging-port and attach the solver
+    to its first tab. Use this to solve captchas in a browser controlled by another tool."""
+    await _close()
+    pw = await _ensure_playwright()
+    S.browser = await pw.chromium.connect_over_cdp(cdp_url)
+    S.owns_browser = False
+    S.context = S.browser.contexts[0] if S.browser.contexts else await S.browser.new_context()
+    page = S.context.pages[0] if S.context.pages else await S.context.new_page()
+    await _attach(page)
+    return f'Connected to {cdp_url}. Current page: {page.url}'
+@tool
+async def goto(url: str, wait_until: str = 'load', timeout: int = 60) -> str:
+    """Open a URL in the browser page. wait_until: load | domcontentloaded | networkidle."""
+    page = _require_page()
+    await page.goto(url, wait_until=wait_until, timeout=timeout * 1000)
+    return f'Opened {page.url} — title: {await page.title()}'
+@tool
+async def detect_captcha() -> str:
+    """Detect which captcha is visible on the page without solving it.
+    Returns recaptcha2, hcaptcha, yandex, geetest, funcaptcha, tiktok, aws or 'none'."""
+    _require_page()
+    with _capture():
+        kind = await S.solver.detect()
+    return kind or 'none'
+@tool
+async def solve_captcha(captcha_type: str = 'auto', timeout: int = 30) -> str:
+    """Solve the captcha on the current page through the Cap.Guru service.
+    captcha_type: auto (detect automatically) | recaptcha2 | hcaptcha | yandex | geetest | funcaptcha | tiktok | aws.
+    timeout: for auto, how many seconds to wait for a captcha to appear.
+    """
+    _require_page()
+    captcha_type = (captcha_type or 'auto').strip().lower()
+    if captcha_type not in SOLVE_METHODS:
+        return f'Unknown captcha_type "{captcha_type}". Use one of: {", ".join(SOLVE_METHODS)}'
+    with _capture() as log:
+        try:
+            if captcha_type == 'auto':
+                kind = await S.solver.auto(timeout=timeout)
+                result = f'Solved: {kind}' if kind else f'No captcha found within {timeout} s'
+            else:
+                await getattr(S.solver, SOLVE_METHODS[captcha_type])()
+                result = f'Solved: {captcha_type}'
+        except CapGuruFatalError as e:
+            result = f'Cap.Guru account error (API key or balance): {e}'
+        except Exception as e:
+            result = f'Not solved: {e}'
+    tail = log.buf.getvalue().strip().splitlines()[-15:]
+    return result + ('\n\nLog:\n' + '\n'.join(tail) if tail else '')
+RECAPTCHA_INFO_JS = """() => {
+    const out = { sitekey: '', callback: '', dataS: '' };
+    const el = document.querySelector('.g-recaptcha[data-sitekey], [data-sitekey]');
+    if (el) {
+        out.sitekey = el.getAttribute('data-sitekey') || '';
+        out.callback = el.getAttribute('data-callback') || '';
+        out.dataS = el.getAttribute('data-s') || '';
+    }
+    if (!out.sitekey) {
+        for (const sc of document.querySelectorAll('script[src*="recaptcha"]')) {
+            const m = /[?&]render=([^&]+)/.exec(sc.src);
+            if (m && m[1] !== 'explicit') { out.sitekey = decodeURIComponent(m[1]); out.v3 = true; break; }
+        }
+    }
+    if (!out.sitekey) {
+        for (const f of document.querySelectorAll('iframe[src*="recaptcha"]')) {
+            const m = /[?&]k=([^&]+)/.exec(f.src);
+            if (m) { out.sitekey = decodeURIComponent(m[1]); break; }
+        }
+    }
+    return out;
+}"""
+APPLY_TOKEN_JS = """([token, callback]) => {
+    const done = [];
+    for (const ta of document.querySelectorAll('textarea[name="g-recaptcha-response"], #g-recaptcha-response')) {
+        ta.value = token;
+        ta.innerHTML = token;
+        done.push('textarea');
+    }
+    const call = (fn) => { try { fn(token); return true; } catch (e) { return false; } };
+    if (callback && typeof window[callback] === 'function' && call(window[callback])) done.push('callback:' + callback);
+    else {
+        const cfg = window.___grecaptcha_cfg && window.___grecaptcha_cfg.clients;
+        const seen = new Set();
+        const walk = (o, depth) => {
+            if (!o || typeof o !== 'object' || depth > 5 || seen.has(o)) return;
+            seen.add(o);
+            for (const k of Object.keys(o)) {
+                const v = o[k];
+                if (k === 'callback') {
+                    if (typeof v === 'function' && call(v)) done.push('callback');
+                    else if (typeof v === 'string' && typeof window[v] === 'function' && call(window[v])) done.push('callback:' + v);
+                } else walk(v, depth + 1);
+            }
+        };
+        if (cfg) walk(cfg, 0);
+    }
+    return done.join(', ') || 'nothing found';
+}"""
+@tool
+async def solve_recaptcha_token(
+    sitekey: str = '',
+    pageurl: str = '',
+    version: str = 'v2',
+    min_score: float = 0.0,
+    data_s: str = '',
+    user_agent: str = '',
+    cookies: str = '',
+    proxy: str = '',
+    proxytype: str = '',
+    apply_to_page: bool = True,
+) -> str:
+    """Get a reCAPTCHA token from Cap.Guru (method userrecaptcha) without solving images.
+    version: v2 (also v2 Invisible) or v3. min_score: for v3 only, required score (service default 0.1).
+    sitekey: the k / data-sitekey value (for v3 also the render= value of recaptcha/api.js).
+    pageurl: full URL of the page with the captcha.
+    If a browser page is open, empty sitekey/pageurl/user_agent are taken from it, and with
+    apply_to_page=true the token is put into g-recaptcha-response and the site callback is called (v2).
+    For v3 the site requests the token itself, so the token is only returned.
+    data_s: data-s value (Google services). cookies, user_agent: passed to the worker.
+    proxy: 'login:password@ip:port', proxytype: HTTP | HTTPS | SOCKS4 | SOCKS5.
+    """
+    page = S.page if (S.page is not None and not S.page.is_closed()) else None
+    callback = ''
+    if page is not None:
+        info = await page.evaluate(RECAPTCHA_INFO_JS)
+        sitekey = sitekey or info.get('sitekey', '')
+        data_s = data_s or info.get('dataS', '')
+        callback = info.get('callback', '')
+        pageurl = pageurl or page.url
+        if not user_agent:
+            user_agent = await page.evaluate('() => navigator.userAgent')
+    version = (version or 'v2').strip().lower()
+    if version not in ('v2', 'v3'):
+        return 'version must be v2 or v3'
+    if not sitekey:
+        return 'sitekey not found: pass sitekey (the k / data-sitekey value) explicitly'
+    if not pageurl:
+        return 'pageurl is required when no browser page is open'
+    payload = {'method': 'userrecaptcha', 'googlekey': sitekey, 'pageurl': pageurl}
+    if version == 'v3':
+        payload['version'] = 'v3'
+        if min_score and min_score > 0:
+            payload['min_score'] = min_score
+    for k, v in (('data-s', data_s), ('userAgent', user_agent), ('cookies', cookies),
+                 ('proxy', proxy), ('proxytype', proxytype)):
+        if v:
+            payload[k] = v
+    client = CapGuruClient(_api_key(), _server_url())
+    with _capture():
+        try:
+            token = await client.click(payload, debug=_debug())
+        except CapGuruFatalError as e:
+            return f'Cap.Guru account error (API key or balance): {e}'
+    if not token or 'ERROR' in str(token).upper():
+        return f'Not solved: {token or "timeout"}'
+    token = str(token).strip()
+    applied = ''
+    if apply_to_page and page is not None and version == 'v2':
+        applied = await page.evaluate(APPLY_TOKEN_JS, [token, callback])
+    lines = [f'Token: {token}', f'version: {version}', f'sitekey: {sitekey}', f'pageurl: {pageurl}']
+    if applied:
+        lines.append(f'Applied to page: {applied}')
+    return '\n'.join(lines)
+TURNSTILE_INFO_JS = r"""() => {
+    const out = { sitekey: '', callback: '' };
+    const el = document.querySelector('.cf-turnstile[data-sitekey]');
+    if (el) {
+        out.sitekey = el.getAttribute('data-sitekey') || '';
+        out.callback = el.getAttribute('data-callback') || '';
+    }
+    const hooked = (window.__cgTurnstile || []).filter(p => p && p.sitekey);
+    if (!out.sitekey && hooked.length) out.sitekey = hooked[hooked.length - 1].sitekey;
+    if (!out.sitekey) {
+        for (const f of document.querySelectorAll('iframe[src*="challenges.cloudflare.com"]')) {
+            const m = /\/([0-3]x[0-9A-Za-z_-]{10,})\//.exec(f.src);
+            if (m) { out.sitekey = m[1]; break; }
+        }
+    }
+    if (!out.sitekey) {
+        const any = document.querySelector('[data-sitekey^="0x"], [data-sitekey^="1x"], [data-sitekey^="2x"], [data-sitekey^="3x"]');
+        if (any) { out.sitekey = any.getAttribute('data-sitekey'); out.callback = out.callback || any.getAttribute('data-callback') || ''; }
+    }
+    return out;
+}"""
+APPLY_TURNSTILE_JS = """([token, callback, sitekey]) => {
+    const done = [];
+    for (const el of document.querySelectorAll('input[name="cf-turnstile-response"], textarea[name="cf-turnstile-response"]')) {
+        el.value = token;
+        done.push(el.tagName.toLowerCase());
+    }
+    const call = (fn) => { try { fn(token); return true; } catch (e) { return false; } };
+    let called = false;
+    if (callback && typeof window[callback] === 'function') called = call(window[callback]) && !!done.push('callback:' + callback);
+    if (!called) {
+        for (const p of (window.__cgTurnstile || [])) {
+            if (sitekey && p.sitekey && p.sitekey !== sitekey) continue;
+            const cb = p.callback;
+            if (typeof cb === 'function' && call(cb)) { done.push('callback (render)'); called = true; break; }
+            if (typeof cb === 'string' && typeof window[cb] === 'function' && call(window[cb])) { done.push('callback:' + cb); called = true; break; }
+        }
+    }
+    return done.join(', ') || 'nothing found';
+}"""
+@tool
+async def solve_turnstile_token(sitekey: str = '', pageurl: str = '', apply_to_page: bool = True) -> str:
+    """Get a Cloudflare Turnstile token from Cap.Guru (method turnstile).
+    sitekey: the data-sitekey value (e.g. 0x4AAAA... or 1x000...). pageurl: URL of the page with Turnstile.
+    If a browser page is open, empty sitekey/pageurl are taken from it, and with apply_to_page=true the
+    token is put into cf-turnstile-response and the Turnstile callback is called.
+    Typical solve time is 10-30 seconds.
+    """
+    page = S.page if (S.page is not None and not S.page.is_closed()) else None
+    callback = ''
+    if page is not None:
+        info = await page.evaluate(TURNSTILE_INFO_JS)
+        sitekey = sitekey or info.get('sitekey', '')
+        callback = info.get('callback', '')
+        pageurl = pageurl or page.url
+    if not sitekey:
+        return 'sitekey not found: pass sitekey (the data-sitekey value) explicitly'
+    if not pageurl:
+        return 'pageurl is required when no browser page is open'
+    payload = {'method': 'turnstile', 'sitekey': sitekey, 'pageurl': pageurl}
+    client = CapGuruClient(_api_key(), _server_url())
+    with _capture():
+        try:
+            token = await client.click(payload, debug=_debug())
+        except CapGuruFatalError as e:
+            return f'Cap.Guru account error (API key or balance): {e}'
+    if not token or 'ERROR' in str(token).upper():
+        return f'Not solved: {token or "timeout"}'
+    token = str(token).strip()
+    applied = ''
+    if apply_to_page and page is not None:
+        applied = await page.evaluate(APPLY_TURNSTILE_JS, [token, callback, sitekey])
+    lines = [f'Token: {token}', f'sitekey: {sitekey}', f'pageurl: {pageurl}']
+    if applied:
+        lines.append(f'Applied to page: {applied}')
+    return '\n'.join(lines)
+@tool
+async def solve_image_captcha(
+    selector: str = '',
+    image_base64: str = '',
+    image_path: str = '',
+    image_url: str = '',
+    vernet: int = 0,
+    fill_selector: str = '',
+) -> str:
+    """Recognize a text (image) captcha through Cap.Guru (method base64) and return the text.
+    Image source, one of:
+      selector: the captcha image element on the open page (screenshot of the element is sent),
+      image_base64: image in base64 (a data: URL is also accepted),
+      image_path: path to an image file,
+      image_url: image URL (downloaded with the page cookies if a page is open).
+    vernet: optional captcha kind: 2 General v1, 6 General v2, 22 Arithmetic, 12 Rambler, 18 General Yandex,
+      20 Yandex 6 ch., 16 VKontakte, 14 SolveMedia, 13 Gibdd, 9 Ok.ru, 17 World of Tanks, 5 Microsoft Hotmail.
+    fill_selector: if set and a page is open, the recognized text is typed into this input.
+    """
+    page = S.page if (S.page is not None and not S.page.is_closed()) else None
+    body = ''
+    if image_base64:
+        body = image_base64.split(',', 1)[1] if image_base64.startswith('data:') else image_base64
+    elif image_path:
+        with open(os.path.expanduser(image_path), 'rb') as f:
+            body = base64.b64encode(f.read()).decode()
+    elif image_url:
+        if page is not None:
+            resp = await page.context.request.get(image_url)
+            data = await resp.body()
+        else:
+            import httpx
+            async with httpx.AsyncClient(follow_redirects=True, timeout=30) as http:
+                data = (await http.get(image_url)).content
+        body = base64.b64encode(data).decode()
+    elif selector:
+        if page is None:
+            return 'selector requires an open page (open_browser / connect_browser)'
+        el = await page.wait_for_selector(selector, timeout=15000)
+        src = await el.get_attribute('src') or ''
+        if src.startswith('data:image') and ',' in src:
+            body = src.split(',', 1)[1]
+        else:
+            body = base64.b64encode(await el.screenshot(type='png')).decode()
+    else:
+        return 'Pass one image source: selector, image_base64, image_path or image_url'
+    if not body:
+        return 'Image is empty'
+    payload = {'method': 'base64', 'body': body}
+    if vernet:
+        payload['vernet'] = int(vernet)
+    client = CapGuruClient(_api_key(), _server_url())
+    with _capture():
+        try:
+            text = await client.click(payload, debug=_debug())
+        except CapGuruFatalError as e:
+            return f'Cap.Guru account error (API key or balance): {e}'
+    if not text or 'ERROR' in str(text).upper():
+        return f'Not solved: {text or "timeout"}'
+    text = str(text).strip()
+    lines = [f'Text: {text}']
+    if fill_selector:
+        if page is None:
+            lines.append('fill_selector ignored: no open page')
+        else:
+            await page.fill(fill_selector, text, timeout=15000)
+            lines.append(f'Filled {fill_selector}')
+    return '\n'.join(lines)
+@tool
+async def screenshot(full_page: bool = False) -> Image:
+    """Take a screenshot of the current page."""
+    page = _require_page()
+    return Image(data=await page.screenshot(full_page=full_page, type='png'), format='png')
+@tool
+async def click(selector: str) -> str:
+    """Click an element by CSS selector (or Playwright selector such as text=Sign in)."""
+    page = _require_page()
+    await page.click(selector, timeout=15000)
+    return f'Clicked {selector}'
+@tool
+async def fill(selector: str, text: str) -> str:
+    """Type text into an input found by selector."""
+    page = _require_page()
+    await page.fill(selector, text, timeout=15000)
+    return f'Filled {selector}'
+@tool
+async def page_info() -> str:
+    """Return the current URL and title of the page."""
+    page = _require_page()
+    return f'URL: {page.url}\nTitle: {await page.title()}'
+@tool
+async def close_browser() -> str:
+    """Close the browser opened by open_browser (or disconnect from a connected one)."""
+    await _close()
+    return 'Browser closed.'
+def main() -> None:
+    mcp.run()
+if __name__ == '__main__':
+    main()

capguru_mcp-0.2.0/capguru_mcp.egg-info/PKG-INFO ADDED Viewed

@@ -0,0 +1,183 @@
+Metadata-Version: 2.4
+Name: capguru-mcp
+Version: 0.2.0
+Summary: MCP server for the Cap.Guru captcha solving service: lets AI assistants open pages and solve reCAPTCHA v2/v3, Cloudflare Turnstile, text captchas, hCaptcha, GeeTest, FunCaptcha, TikTok, AWS WAF and Yandex SmartCaptcha
+Author: Cap.Guru
+Project-URL: Homepage, https://cap.guru
+Project-URL: Documentation, https://docs.cap.guru
+Keywords: mcp,captcha,solver,playwright,cap.guru,claude,cursor,turnstile,recaptcha
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: mcp>=1.2
+Requires-Dist: capguru>=0.4.0
+Requires-Dist: playwright>=1.40
+# capguru-mcp
+**English** | [Русский](#русский)
+MCP server for the [Cap.Guru](https://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:
+```json
+{
+  "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](https://docs.astral.sh/uv/)): use `"command": "uvx", "args": ["capguru-mcp"]`.
+## Tools
+| Tool | Description |
+|---|---|
+| `open_browser` | Launch a browser (`headless`, `channel`: `chrome`/`msedge`, `proxy`) |
+| `connect_browser` | Connect to a running Chrome started with `--remote-debugging-port` |
+| `goto` | Open a URL |
+| `click`, `fill` | Click an element, type text into an input |
+| `screenshot` | Screenshot of the page |
+| `page_info` | Current URL and title |
+| `detect_captcha` | Detect the captcha type without solving |
+| `solve_captcha` | Solve the captcha: `auto` or a specific type |
+| `solve_recaptcha_token` | Get a reCAPTCHA v2 / v2 Invisible / v3 token (`sitekey`, `pageurl`, `version`, `min_score`); works without a browser too |
+| `solve_turnstile_token` | Get a Cloudflare Turnstile token (`sitekey`, `pageurl`); works without a browser too |
+| `solve_image_captcha` | Recognize a text captcha from an image: element `selector`, `image_base64`, `image_path` or `image_url`; optional `vernet`, `fill_selector` |
+| `close_browser` | Close the browser |
+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)
+| Variable | Default | Description |
+|---|---|---|
+| `CAPGURU_API_KEY` | — | Cap.Guru API key (required) |
+| `CAPGURU_SERVER` | `https://api.cap.guru` | API server |
+| `CAPGURU_ATTEMPTS` | `5` | Max number of solving attempts |
+| `CAPGURU_DEBUG` | `1` | Include the solver log in tool results |
+| `CAPGURU_BROWSER_CHANNEL` | — | `chrome` or `msedge` to use an installed browser |
+| `CAPGURU_BROWSER_PATH` | — | Path to a browser executable |
+| `CAPGURU_BROWSER_ARGS` | — | Extra browser arguments, space separated |
+Full documentation: https://docs.cap.guru
+---
+## Русский
+MCP-сервер для сервиса решения капчи [Cap.Guru](https://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`) и большинство других клиентов:
+```json
+{
+  "mcpServers": {
+    "capguru": {
+      "command": "capguru-mcp",
+      "env": {
+        "CAPGURU_API_KEY": "ВАШ_КЛЮЧ"
+      }
+    }
+  }
+}
+```
+Claude Code:
+```
+claude mcp add capguru --env CAPGURU_API_KEY=ВАШ_КЛЮЧ -- capguru-mcp
+```
+Без установки (через [uv](https://docs.astral.sh/uv/)): `"command": "uvx", "args": ["capguru-mcp"]`.
+### Инструменты
+| Инструмент | Описание |
+|---|---|
+| `open_browser` | Запустить браузер (`headless`, `channel`: `chrome`/`msedge`, `proxy`) |
+| `connect_browser` | Подключиться к запущенному Chrome с `--remote-debugging-port` |
+| `goto` | Открыть адрес |
+| `click`, `fill` | Нажать на элемент, ввести текст в поле |
+| `screenshot` | Скриншот страницы |
+| `page_info` | Текущий адрес и заголовок |
+| `detect_captcha` | Определить тип капчи, не решая |
+| `solve_captcha` | Решить капчу: `auto` или конкретный тип |
+| `solve_recaptcha_token` | Получить токен reCAPTCHA v2 / v2 Invisible / v3 (`sitekey`, `pageurl`, `version`, `min_score`); работает и без браузера |
+| `solve_turnstile_token` | Получить токен Cloudflare Turnstile (`sitekey`, `pageurl`); работает и без браузера |
+| `solve_image_captcha` | Распознать текстовую капчу с картинки: элемент `selector`, `image_base64`, `image_path` или `image_url`; по желанию `vernet`, `fill_selector` |
+| `close_browser` | Закрыть браузер |
+Примеры запросов ассистенту:
+- *«Открой 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 секунд.
+### Настройки (переменные окружения)
+| Переменная | По умолчанию | Описание |
+|---|---|---|
+| `CAPGURU_API_KEY` | — | API-ключ Cap.Guru (обязательно) |
+| `CAPGURU_SERVER` | `https://api.cap.guru` | Сервер API |
+| `CAPGURU_ATTEMPTS` | `5` | Макс. количество попыток |
+| `CAPGURU_DEBUG` | `1` | Добавлять лог солвера в ответ инструмента |
+| `CAPGURU_BROWSER_CHANNEL` | — | `chrome` или `msedge`, чтобы использовать установленный браузер |
+| `CAPGURU_BROWSER_PATH` | — | Путь к исполняемому файлу браузера |
+| `CAPGURU_BROWSER_ARGS` | — | Дополнительные аргументы браузера через пробел |
+Полная документация: https://docs.cap.guru

capguru_mcp-0.2.0/capguru_mcp.egg-info/SOURCES.txt ADDED Viewed

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+capguru_mcp/__init__.py
+capguru_mcp/__main__.py
+capguru_mcp/server.py
+capguru_mcp.egg-info/PKG-INFO
+capguru_mcp.egg-info/SOURCES.txt
+capguru_mcp.egg-info/dependency_links.txt
+capguru_mcp.egg-info/entry_points.txt
+capguru_mcp.egg-info/requires.txt
+capguru_mcp.egg-info/top_level.txt

capguru_mcp-0.2.0/capguru_mcp.egg-info/dependency_links.txt ADDED Viewed

	@@ -0,0 +1 @@
1	+

capguru_mcp-0.2.0/capguru_mcp.egg-info/entry_points.txt ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ [console_scripts]
2	+ capguru-mcp = capguru_mcp.server:main

capguru_mcp-0.2.0/capguru_mcp.egg-info/requires.txt ADDED Viewed

@@ -0,0 +1,3 @@
+mcp>=1.2
+capguru>=0.4.0
+playwright>=1.40

capguru_mcp-0.2.0/capguru_mcp.egg-info/top_level.txt ADDED Viewed

	@@ -0,0 +1 @@
1	+ capguru_mcp

capguru_mcp-0.2.0/pyproject.toml ADDED Viewed

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+[project]
+name = "capguru-mcp"
+version = "0.2.0"
+description = "MCP server for the Cap.Guru captcha solving service: lets AI assistants open pages and solve reCAPTCHA v2/v3, Cloudflare Turnstile, text captchas, hCaptcha, GeeTest, FunCaptcha, TikTok, AWS WAF and Yandex SmartCaptcha"
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [{ name = "Cap.Guru" }]
+dependencies = [
+    "mcp>=1.2",
+    "capguru>=0.4.0",
+    "playwright>=1.40",
+]
+keywords = ["mcp", "captcha", "solver", "playwright", "cap.guru", "claude", "cursor", "turnstile", "recaptcha"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent",
+]
+[project.urls]
+Homepage = "https://cap.guru"
+Documentation = "https://docs.cap.guru"
+[project.scripts]
+capguru-mcp = "capguru_mcp.server:main"
+[tool.setuptools]
+packages = ["capguru_mcp"]

capguru_mcp-0.2.0/setup.cfg ADDED Viewed

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build =
+tag_date = 0