capsolver-core 0.1.0__py3-none-any.whl

capsolver_core-0.1.0.dist-info/METADATA

@@ -0,0 +1,206 @@
+Metadata-Version: 2.5
+Name: capsolver-core
+Version: 0.1.0
+Summary: CapSolver core library — detect captchas, solve via API, and autofill tokens. Powers capsolver-agent and capsolver-mcp.
+Project-URL: Homepage, https://capsolver.com
+Project-URL: Repository, https://github.com/capsolver-ai/capsolver-core
+Project-URL: Issues, https://github.com/capsolver-ai/capsolver-core/issues
+Project-URL: Changelog, https://github.com/capsolver-ai/capsolver-core/blob/main/CHANGELOG.md
+Project-URL: Security, https://github.com/capsolver-ai/capsolver-core/blob/main/SECURITY.md
+Author-email: capsolver-ai <dev@capsolver.ai>
+License-Expression: ISC
+License-File: LICENSE
+Keywords: capsolver,captcha,recaptcha,turnstile
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-asyncio>=1.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Provides-Extra: playwright
+Requires-Dist: playwright>=1.40; extra == 'playwright'
+Description-Content-Type: text/markdown
+
+# capsolver-core
+
+A Python SDK for [CapSolver](https://capsolver.com) — detect captchas on a page, read their parameters, solve them via the CapSolver API, and write the token back.
+
+> **Token mode only.** This SDK solves captchas by requesting a token from the
+> CapSolver API (reCAPTCHA v2/v3, Cloudflare Turnstile).
+
+## Install
+
+```bash
+pip install capsolver-core
+```
+
+With Playwright support:
+
+```bash
+pip install capsolver-core[playwright]
+```
+
+Set your API key (or pass `api_key=` directly to `create_capsolver()`):
+
+```bash
+# bash / zsh
+export CAPSOLVER_API_KEY="your-capsolver-api-key"
+
+# PowerShell
+$env:CAPSOLVER_API_KEY = "your-capsolver-api-key"
+
+# cmd
+set CAPSOLVER_API_KEY=your-capsolver-api-key
+```
+
+## Two ways to use it
+
+### 1. Pure API (you already have the sitekey)
+
+No browser needed — give it the captcha parameters, get a token back.
+
+```python
+import asyncio
+from capsolver_core import create_capsolver, CaptchaType, CaptchaInfo
+
+async def main():
+    cap = create_capsolver(api_key="YOUR_API_KEY")
+
+    info = CaptchaInfo(
+        type=CaptchaType.RECAPTCHA_V2,
+        website_url="https://example.com",
+        website_key="6Lc...",
+    )
+    solution = await cap.solve(info)
+    print(solution.token)  # submit this as g-recaptcha-response
+
+asyncio.run(main())
+```
+
+### 2. Driving a real browser (Playwright)
+
+Detect, read params, solve, and autofill — all from a live page.
+
+```python
+import asyncio
+from capsolver_core import create_capsolver
+from playwright.async_api import async_playwright
+
+async def main():
+    cap = create_capsolver(api_key="YOUR_API_KEY")
+
+    async with async_playwright() as p:
+        browser = await p.chromium.launch()
+        page = await browser.new_page()
+        await page.goto("https://example.com/login")
+
+        # One-shot: detect every captcha, solve each, write tokens back.
+        results = await cap.solve_on_page(page)
+        for r in results:
+            print(r.info.type, r.solution.token if r.solution else None, r.filled, r.error)
+
+        # …or step by step:
+        types = await cap.detect(page)
+        infos = await cap.get_captcha_info(page)
+        solution = await cap.solve(infos[0])
+
+asyncio.run(main())
+```
+
+## CLI
+
+The `capsolver` command provides quick diagnostics without writing code.
+
+```bash
+# Show SDK version, Python version, and optional dependency status
+capsolver info
+
+# List all supported captcha types and registered handlers
+capsolver list-types
+
+# Check account balance (requires CAPSOLVER_API_KEY)
+capsolver balance
+capsolver balance --api-key YOUR_KEY
+```
+
+Also works via `python -m capsolver_core info`.
+
+## API
+
+### `create_capsolver(**options)` / `Capsolver(**options)`
+
+| Option              | Default                     | Description                            |
+|---------------------|-----------------------------|----------------------------------------|
+| `api_key`           | —                           | CapSolver client key (required to solve)|
+| `service`           | `https://api.capsolver.com` | API base URL                           |
+| `default_timeout`   | `120`                       | Polling budget, seconds                |
+| `polling_interval`  | `5`                         | Delay between result polls, seconds    |
+| `request_timeout_ms`| `30000`                     | Per-HTTP-request timeout               |
+| `app_id`            | —                           | Developer/affiliate id                 |
+| `handlers`          | all built-ins               | Override the registered captcha handlers|
+| `source`            | —                           | Traffic source identifier              |
+| `version`           | —                           | Client version tag                     |
+| `on_error`          | —                           | Callback for non-fatal errors          |
+
+### Resource cleanup
+
+`Capsolver` holds an internal HTTP connection pool. Use it as an async context
+manager to ensure connections are released:
+
+```python
+async with create_capsolver(api_key="YOUR_API_KEY") as cap:
+    solution = await cap.solve(info)
+```
+
+Or call `await cap.aclose()` explicitly when done.
+
+### Methods
+
+- `solve(info, wait_options?)` → `Solution` — solve from a `CaptchaInfo`.
+- `detect(page)` → `list[CaptchaType]` — which captchas are present.
+- `get_captcha_info(page)` → `list[CaptchaInfo]` — structured params per widget.
+- `solve_on_page(page, options?)` → `list[SolveOnPageResult]` — detect → solve → autofill.
+- `get_balance()` → `BalanceResp` — account balance.
+- `register(handler)` / `get_supported_captchas()` / `get_handler(key)` — registry access.
+
+### Supported captchas
+
+`reCaptchaV2`, `reCaptchaV3` (incl. enterprise), `cloudflare` (Turnstile).
+
+## Architecture
+
+```
+src/capsolver_core/
+  __init__.py   public API surface (all exports)
+  __main__.py   CLI entry point (capsolver command)
+  core/         pure-Python token solving (http, client, task builders, types)
+  captcha/      handler registry + per-captcha handlers (the plugin layer)
+  browser/      PageDriver adapter + self-contained in-page inject scripts
+  capsolver.py  public Capsolver class
+```
+
+## Development
+
+```bash
+git clone https://github.com/capsolver-ai/capsolver-core.git
+cd capsolver-core
+uv sync --all-extras          # or: pip install -r requirements-dev.txt
+uv run pytest                 # run tests
+uv run ruff check src tests   # lint
+```
+
+## License
+
+ISC

capsolver_core-0.1.0.dist-info/RECORD

@@ -0,0 +1,29 @@
+capsolver_core/__init__.py,sha256=bRdcXGG5y3bzjpEFzNm3T4heGJ3XKT1WxwN9352pXVw,1358
+capsolver_core/__main__.py,sha256=HpnpZt7spPhm0cUZgScoy_djv5fZRN8n5ZZhvxnBYBg,3072
+capsolver_core/capsolver.py,sha256=ifXehaqUm6XTwcZ5T-lJcnrqnKRZZ40THAb126joNn0,8352
+capsolver_core/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+capsolver_core/browser/__init__.py,sha256=Vx4_ndHmBX0Z68lQ1X_G1sYeErEUIfivTiM1XktQTV0,265
+capsolver_core/browser/adapter.py,sha256=ucpTcAdKg-ZiBRS2wTWrh8cOKd4KBcY0L0bS_WoUAvw,3925
+capsolver_core/browser/driver.py,sha256=5l-2IcWIF7bKqLRMaBGez-aE_5WPq6Nmr6qIUP9PDrw,814
+capsolver_core/browser/inject/__init__.py,sha256=Bf3ksjy92HoAJecrSFFEdif7fBGqiWKfahnlYUplOfs,81
+capsolver_core/browser/inject/cloudflare.py,sha256=a2wlkt9VaVH48aHac3dtbhnitdxE2KWatAxPl_IIvjw,2806
+capsolver_core/browser/inject/recaptcha.py,sha256=oRQ7Wjfj2dWqYwz2lxIYop-ID2sw9ViKvqsEBrsRJ2E,6061
+capsolver_core/captcha/__init__.py,sha256=tTiQhsIkssTiLId4MnNSaxdaTI3bAYU5V07s3LLIQBo,556
+capsolver_core/captcha/handler.py,sha256=zW_hmlgUREnuRiEtdHvBYwwATgK2mg3esKBVdLQud6A,1736
+capsolver_core/captcha/registry.py,sha256=5cU23cgk8AUyoXiq8UT6HQmf8EXCXFtf860VvzR1wEI,1931
+capsolver_core/captcha/types.py,sha256=3C6vy1iueJUnlvYegKtW74ViVOmmVQ5Dhmtu9mSGGQM,1629
+capsolver_core/captcha/handlers/__init__.py,sha256=hs-awJIR8Mq3sXBitIPl4y7llBfYgiiPmFF7X9Q2oFw,535
+capsolver_core/captcha/handlers/cloudflare.py,sha256=J8PBMZ_-1xbpcYLmaQNxdoipHqy6p-j6EpQ71QENigk,2829
+capsolver_core/captcha/handlers/recaptcha.py,sha256=vxBou6e9n4DqQCIvOWKGdN9YTVFgZZlf57GAnjgFz9Y,3982
+capsolver_core/captcha/handlers/support.py,sha256=PJzO3khKoCVOOwWYtpOIJ3N1-KDn5LftlZEjgEBwBrE,1245
+capsolver_core/core/__init__.py,sha256=1lxePQ9VpqBIY4cLHDb20HRJKfww3QkUmSHbkbAUZAE,369
+capsolver_core/core/client.py,sha256=9u3m1NHBWV3s50mfTnfBmpUp0ziS_GB86vruI5fE_GU,6715
+capsolver_core/core/errors.py,sha256=G5OsC9h4KRx5QmYcrpgtSRGHgreB402oqQ1bbPo4iok,1781
+capsolver_core/core/http.py,sha256=qj74X6vJFyJwZ8c3Hifa0Zk0TZa5NN6eilAJ1HjAM70,4825
+capsolver_core/core/tasks.py,sha256=U_j65mU1TArFdZTk8AoyE4BoudC5qtbfN21kQP9Ixs8,3913
+capsolver_core/core/types.py,sha256=vQXJ007NHTmIkBftMozoim42MSLMMPQL1yjbTFmYmvI,5161
+capsolver_core-0.1.0.dist-info/METADATA,sha256=iPSpxmdhj3whSpQ2_3G6tNFeNnSLWGhX26VvTBIo3Vk,7050
+capsolver_core-0.1.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+capsolver_core-0.1.0.dist-info/entry_points.txt,sha256=PNa5F9JsxuueV6T5vJpVxDrfr9oBZ4m2YftSqotKLk4,59
+capsolver_core-0.1.0.dist-info/licenses/LICENSE,sha256=p65mlslnCknoxoEoP3lESj40mUaZRt2xzgMlrGE72hM,763
+capsolver_core-0.1.0.dist-info/RECORD,,

capsolver_core-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.0
+Root-Is-Purelib: true
+Tag: py3-none-any

capsolver_core-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+capsolver = capsolver_core.__main__:main

capsolver_core-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2025-2026 capsolver-ai
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.