{
  "markdown": "# python3-anticaptcha\n\n[![PyPI version](https://badge.fury.io/py/python3-anticaptcha.svg)](https://badge.fury.io/py/python3-anticaptcha)\n[![Python versions](https://img.shields.io/pypi/pyversions/python3-anticaptcha.svg?logo=python&logoColor=FBE072)](https://badge.fury.io/py/python3-anticaptcha)\n[![Downloads](https://static.pepy.tech/badge/python3-anticaptcha/month)](https://pepy.tech/project/python3-anticaptcha)\n[![Static Badge](https://img.shields.io/badge/docs-Sphinx-green?label=Documentation&labelColor=gray)](https://andreidrang.github.io/python3-anticaptcha/)\n[![Test](https://github.com/AndreiDrang/python3-anticaptcha/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/AndreiDrang/python3-anticaptcha/actions/workflows/test.yml)\n[![Lint](https://github.com/AndreiDrang/python3-anticaptcha/actions/workflows/lint.yml/badge.svg?branch=main)](https://github.com/AndreiDrang/python3-anticaptcha/actions/workflows/lint.yml)\n[![codecov](https://codecov.io/gh/AndreiDrang/python3-anticaptcha/graph/badge.svg?token=W92nfZY6Tz)](https://codecov.io/gh/AndreiDrang/python3-anticaptcha)\n\nPython 3 client library for [AntiCaptcha](https://getcaptchasolution.com/vchfpctqyz) service - solve reCAPTCHA, hCaptcha, image captchas, and more programmatically.\n\n## Why use this library?\n\nAntiCaptcha is a paid captcha solving service. This library provides a clean Python interface to:\n- Submit captchas to AntiCaptcha's worker network\n- Poll for results automatically\n- Handle proxy rotation for high-volume requests\n- Support both synchronous and asynchronous workflows\n\n## Supported Captcha Types\n\n| Type | Class | Use Case |\n|------|-------|----------|\n| reCAPTCHA v2 | `ReCaptchaV2` | Google reCAPTCHA V2 checkbox/invisible |\n| reCAPTCHA v3 | `ReCaptchaV3` | Google reCAPTCHA V3 score-based |\n| Image Captcha | `ImageToText` | Classic text-from-image captchas |\n| Image Coordinates | `ImageToCoordinates` | Click-on-image captchas |\n| FunCaptcha | `FunCaptcha` | Arkose Labs (formerly FunCaptcha) |\n| GeeTest | `GeeTest` | Chinese GeeTest captcha |\n| Turnstile | `Turnstile` | Cloudflare Turnstile |\n| FriendlyCaptcha | `FriendlyCaptcha` | FriendlyCaptcha puzzles |\n| Prosopo | `Prosopo` | Prosopo captcha |\n| Amazon WAF | `AmazonWAF` | AWS WAF Captcha |\n\n## Quick Start\n\n### 1. Install\n\n```bash\npip install python3-anticaptcha\n```\n\n### 2. Get Your API Key\n\n1. Log into [AntiCaptcha](https://getcaptchasolution.com/vchfpctqyzclients/settings/apisetup)\n2. Copy your API key from the \"Setup\" section\n\n### 3. Solve a reCAPTCHA\n\n```python\nfrom python3_anticaptcha import ReCaptchaV2\nfrom python3_anticaptcha.core.enum import CaptchaTypeEnm\n\n# Basic usage (no proxy)\nresult = ReCaptchaV2(\n    api_key=\"YOUR_API_KEY\",\n    captcha_type=CaptchaTypeEnm.RecaptchaV2TaskProxyless,\n    websiteURL=\"https://example.com/page-with-captcha\",\n    websiteKey=\"6LeIxAKTAAAAAJ309xRj9YBN2aaaaaaaaa\",  # sitekey from the page\n).captcha_handler()\n\nprint(result[\"solution\"][\"gRecaptchaResponse\"])\n```\n\n### 4. Solve with Proxy\n\n```python\nfrom python3_anticaptcha import ReCaptchaV2\nfrom python3_anticaptcha.core.enum import CaptchaTypeEnm, ProxyTypeEnm\n\nresult = ReCaptchaV2(\n    api_key=\"YOUR_API_KEY\",\n    captcha_type=CaptchaTypeEnm.RecaptchaV2Task,\n    websiteURL=\"https://example.com/page-with-captcha\",\n    websiteKey=\"6LeIxAKTAAAAAJ309xRj9YBN2aaaaaaaaa\",\n    proxyType=ProxyTypeEnm.HTTP,\n    proxyAddress=\"123.45.67.89\",\n    proxyPort=8080,\n    proxyLogin=\"proxy_user\",\n    proxyPassword=\"proxy_pass\",\n    userAgent=\"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36\",\n).captcha_handler()\n```\n\n### 5. Async Usage\n\n```python\nimport asyncio\nfrom python3_anticaptcha import ReCaptchaV2\nfrom python3_anticaptcha.core.enum import CaptchaTypeEnm\n\nasync def solve():\n    result = await ReCaptchaV2(\n        api_key=\"YOUR_API_KEY\",\n        captcha_type=CaptchaTypeEnm.RecaptchaV2TaskProxyless,\n        websiteURL=\"https://example.com/page-with-captcha\",\n        websiteKey=\"6LeIxAKTAAAAAJ309xRj9YBN2aaaaaaaaa\",\n    ).aio_captcha_handler()\n    return result\n\nresult = asyncio.run(solve())\n```\n\n## Environment Variable\n\nSet `API_KEY` to avoid passing it in code:\n\n```bash\nexport API_KEY=\"your_api_key_here\"\n```\n\n```python\n# Now you can omit api_key parameter\nfrom python3_anticaptcha import ImageToText\n\nresult = ImageToText(captcha_file=\"captcha.png\").captcha_handler()\n```\n\n## Configuration Options\n\nAll captcha classes support these common parameters:\n\n| Parameter | Type | Description |\n|-----------|------|-------------|\n| `api_key` | str | Your AntiCaptcha API key (or set `API_KEY` env var) |\n| `sleep_time` | int | Seconds between result polls (default: 10) |\n\n## Documentation\n\n- [Full Documentation](https://andreidrang.github.io/python3-anticaptcha/) - Detailed API reference\n- [AntiCaptcha Errors](https://getcaptchasolution.com/vchfpctqyzapidoc/errors) - Error code meanings\n\n## Development\n\nInstall [uv](https://docs.astral.sh/uv/) and create the project environment with all development extras:\n\n```bash\nuv sync --all-extras\n```\n\nThe Makefile provides the standard project commands:\n\n```bash\n# Run tests\nmake tests\n\n# Run Ruff checks\nmake lint\n\n# Build package\nmake build\n\n# Build documentation\nmake doc\n```\n\nRuff is the formatter and linter. To apply its safe fixes and formatting, run:\n\n```bash\nmake refactor\n```\n\n## Contacts\n\n- Telegram: [pythoncaptcha](https://t.me/pythoncaptcha)\n- Email: python-captcha@pm.me\n\n---\n\nLove Rust? Check out [Rust-AntiCaptcha](https://crates.io/crates/rust-anticaptcha) - same API for Rust projects.\n",
  "bytes": 5549,
  "sha": "78e58e4eb95cd84102c0ceb06248fc09af3dca98207aa5c121107200a39cdca3",
  "repo_slug": "andreidrang/python3-anticaptcha",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_andreidrang_python3_anticaptcha_okf_inde_e9bedb17/readme"
}