Metadata-Version: 2.4
Name: capmonstercloudclient
Version: 4.1.0
Summary: Official CapMonsterCloud Client: https://capmonster.cloud/
Home-page: https://github.com/ZennoLab/capmonstercloud-client-python
Author: Andrey Ilyin
Author-email: andrey.ilyin@zennolab.com
License: AGPL-3.0
Keywords: captcha 
				recaptcha
				geetest
				funcaptcha
				python3
				python-library
				capmonster
                capmonstercloud
                capmonstercloudclient
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: AsyncIO
Classifier: Operating System :: Unix
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: MacOS
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohappyeyeballs==2.4.4; python_version >= "3.9" and python_version <= "3.13"
Requires-Dist: aiohttp==3.11.10; python_version >= "3.9" and python_version <= "3.13"
Requires-Dist: aiosignal==1.3.1; python_version >= "3.9" and python_version <= "3.13"
Requires-Dist: annotated-types==0.7.0; python_version >= "3.9" and python_version <= "3.13"
Requires-Dist: async-timeout==5.0.1; python_version >= "3.9" and python_version <= "3.11"
Requires-Dist: attrs==24.2.0; python_version >= "3.9" and python_version <= "3.13"
Requires-Dist: frozenlist==1.5.0; python_version >= "3.9" and python_version <= "3.13"
Requires-Dist: idna==3.10; python_version >= "3.9" and python_version <= "3.13"
Requires-Dist: multidict==6.1.0; python_version >= "3.9" and python_version <= "3.13"
Requires-Dist: propcache==0.2.1; python_version >= "3.9" and python_version <= "3.13"
Requires-Dist: pydantic-core==2.27.1; python_version >= "3.9" and python_version <= "3.13"
Requires-Dist: pydantic==2.10.3; python_version >= "3.9" and python_version <= "3.13"
Requires-Dist: typing-extensions==4.12.2; python_version >= "3.9" and python_version <= "3.13"
Requires-Dist: yarl==1.18.3; python_version >= "3.9" and python_version <= "3.13"
Requires-Dist: aiohttp==3.7.4; python_version >= "3.6" and python_version <= "3.8"
Requires-Dist: pydantic==2.10.3; python_version >= "3.8" and python_version < "3.9"
Requires-Dist: pydantic==2.5.3; python_version >= "3.7" and python_version < "3.8"
Requires-Dist: pydantic==2.1.*; python_version < "3.7"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# CapMonster Cloud Python SDK

[![PyPI version](https://img.shields.io/pypi/v/capmonstercloudclient)](https://pypi.org/project/capmonstercloudclient/)

Official Python SDK for the CapMonster Cloud API.
Use this package when you want to create tasks and retrieve solutions from Python applications or scripts.

## Links

- Package: [capmonstercloudclient on PyPI](https://pypi.org/project/capmonstercloudclient/)
- Documentation: [docs.capmonster.cloud](https://docs.capmonster.cloud/)
- Dashboard / API key: [dash.capmonster.cloud](https://dash.capmonster.cloud/)

## Installation

```bash
python3 -m pip install capmonstercloudclient
```

Need to test before depositing? Contact support and we’ll add trial credits to your account.

## Minimal async example

```python
import asyncio

from capmonstercloudclient import CapMonsterClient, ClientOptions
from capmonstercloudclient.requests import RecaptchaV2Request

client_options = ClientOptions(api_key="<YOUR_API_KEY>")
cap_monster_client = CapMonsterClient(options=client_options)

recaptcha2request = RecaptchaV2Request(
    websiteUrl="https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high",
    websiteKey="6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd",
)

async def solve_captcha():
    return await cap_monster_client.solve_captcha(recaptcha2request)

response = asyncio.run(solve_captcha())
print(response)
```

Supported task families include reCAPTCHA, GeeTest, Turnstile, image-to-text, and additional task types documented in the public docs.

Supported request classes:

- [AltchaCustomTaskRequest](https://docs.capmonster.cloud/docs/captchas/altcha-task)
- [AlibabaCustomTaskRequest](https://docs.capmonster.cloud/docs/captchas/alibaba-task)
- [AmazonWafRequest](https://docs.capmonster.cloud/docs/captchas/amazon-task)
- [BasiliskCustomTaskRequest](https://docs.capmonster.cloud/docs/captchas/Basilisk-task)
- [BinanceTaskRequest](https://docs.capmonster.cloud/docs/captchas/binance)
- [CastleCustomTaskRequest](https://docs.capmonster.cloud/docs/captchas/castle-task)
- [DataDomeCustomTaskRequest](https://docs.capmonster.cloud/docs/captchas/datadome)
- [FriendlyCaptchaRequest](https://docs.capmonster.cloud/docs/captchas/friendly-task)
- [FuncaptchaRequest](https://docs.capmonster.cloud/docs/captchas/funcaptcha-task)
- [FunCaptchaComplexImageTaskRequest](https://docs.capmonster.cloud/docs/captchas/ComplexImageTask-Recognition)
- [GeetestRequest](https://docs.capmonster.cloud/docs/captchas/geetest-task)
- [HuntCustomTaskRequest](https://docs.capmonster.cloud/docs/captchas/hunt-task)
- [ImageToTextRequest](https://docs.capmonster.cloud/docs/captchas/image-to-text)
- [ImpervaCustomTaskRequest](https://docs.capmonster.cloud/docs/captchas/incapsula)
- [MTCaptchaRequest](https://docs.capmonster.cloud/docs/captchas/mtcaptcha-task)
- [ProsopoTaskRequest](https://docs.capmonster.cloud/docs/captchas/prosopo-task)
- [RecognitionComplexImageTaskRequest](https://docs.capmonster.cloud/docs/captchas/ComplexImageTask-Recognition)
- [RecaptchaComplexImageTaskRequest](https://docs.capmonster.cloud/docs/captchas/recaptcha-click)
- [RecaptchaV2EnterpriseRequest](https://docs.capmonster.cloud/docs/captchas/recaptcha-v2-enterprise-task)
- [RecaptchaV2Request](https://docs.capmonster.cloud/docs/captchas/no-captcha-task)
- [RecaptchaV3EnterpriseRequest](https://docs.capmonster.cloud/docs/captchas/recaptcha-v3-enterprise-task)
- [RecaptchaV3ProxylessRequest](https://docs.capmonster.cloud/docs/captchas/recaptcha-v3-task)
- [TemuCustomTaskRequest](https://docs.capmonster.cloud/docs/captchas/temu-task)
- [TenDiCustomTaskRequest](https://docs.capmonster.cloud/docs/captchas/tendi)
- [TspdCustomTaskRequest](https://docs.capmonster.cloud/docs/captchas/tspd-task)
- [TurnstileRequest](https://docs.capmonster.cloud/docs/captchas/turnstile-task)
- [YidunRequest](https://docs.capmonster.cloud/docs/captchas/yidun-task)
