
Product
Secure Your AI-Generated Code with Socket MCP
Socket MCP brings real-time security checks to AI-generated code, helping developers catch risky dependencies before they enter the codebase.
A modern, strongly typed, async-friendly Python SDK for solving CAPTCHA challenges using Capmonster.Cloud.
Supports reCAPTCHA v2 & v3, Cloudflare Turnstile, GeeTest (v3 & v4) and much more.
pip install capmonster_python
[!IMPORTANT]
You're viewing the documentation for Capmonster Python v4, which includes breaking changes. If you prefer the old syntax used in versions prior to 4.x, you can continue using it by installing the legacy version:
pip install capmonster_python==3.2
import asyncio
from capmonster_python import CapmonsterClient, RecaptchaV3Task
async def main():
client = CapmonsterClient(api_key="YOUR_API_KEY")
task = RecaptchaV3Task(
websiteURL="https://example.com",
websiteKey="SITE_KEY_HERE",
minScore=0.5,
pageAction="verify"
)
task_id = await client.create_task_async(task)
result = await client.join_task_result_async(task_id)
print(result)
asyncio.run(main())
from capmonster_python import CapmonsterClient, RecaptchaV2Task
client = CapmonsterClient(api_key="<YOUR_API_KEY>")
task = RecaptchaV2Task(
websiteURL="https://example.com",
websiteKey="SITE_KEY_HERE"
)
task_id = client.create_task(task)
result = client.join_task_result(task_id)
print(result)
Capmonster Python v4 supports a wide range of CAPTCHA formats β from mainstream challenges like reCAPTCHA and Turnstile to enterprise-grade shields like Imperva and DataDome. Each task supports full Pydantic validation β and both sync and async clients π unless noted.
π Category | CAPTCHA Type | Class Name | Proxy Required | Notes |
---|---|---|---|---|
π§© reCAPTCHA | reCAPTCHA v2 | RecaptchaV2Task | Optional | Visible / Invisible supported β π |
reCAPTCHA v2 Enterprise | RecaptchaV2EnterpriseTask | Optional | enterprisePayload & apiDomain β
π | |
reCAPTCHA v3 | RecaptchaV3Task | β No | Score-based, proxyless β π | |
π‘οΈ Cloudflare | Turnstile (token) | TurnstileTask | β No | Lightweight, async-ready β π |
Turnstile (cf_clearance) | TurnstileCloudFlareTask | β Yes | Full HTML + proxy required β π | |
πΈ Image-based | Image-to-Text OCR | ImageToTextTask | β No | Base64 image + module control β π |
Complex Image (Recaptcha-like) | ComplexImageRecaptchaTask | β No | Grid-based, metadata aware β π | |
Complex Image Recognition (AI) | ComplexImageRecognitionTask | β No | Supports tasks like Shein, OOCL β π | |
π§ Human Behavior | GeeTest v3 | GeeTestV3Task | Optional | Challenge + gt key + freshness β
π |
GeeTest v4 | GeeTestV4Task | Optional | initParameters supported β
π | |
π‘οΈ Enterprise Protection | DataDome | DataDomeTask | β Recommended | Cookie & page context needed β π |
Imperva | ImpervaTask | β Recommended | Incapsula + Reese84 logic β π | |
π¦ Platform-Specific | Binance Login | BinanceTask | β Yes | validateId for login flow β
π |
Temu | TemuTask | β No | Cookie-injected behavioral solver β π | |
TenDI | TenDITask | β Yes | Custom captchaAppId field β π | |
π§ͺ Miscellaneous | Prosopo | ProsopoTask | Optional | Used in zk or crypto UIs β π |
Basilisk | BasiliskTask | β No | Minimalist site-key puzzle β π |
Need help or have a question?
[!NOTE]
Community support is intended only for questions and issues related to this project. Custom usage scenarios, integrations, or application-specific logic are outside the scope of support.
This project is licensed under the MIT License.
FAQs
capmonster.cloud library/package for Python
We found that capmonster-python demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago.Β It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
Socket MCP brings real-time security checks to AI-generated code, helping developers catch risky dependencies before they enter the codebase.
Security News
As vulnerability data bottlenecks grow, the federal government is formally investigating NISTβs handling of the National Vulnerability Database.
Research
Security News
Socketβs Threat Research Team has uncovered 60 npm packages using post-install scripts to silently exfiltrate hostnames, IP addresses, DNS servers, and user directories to a Discord-controlled endpoint.