capmonstercloudclient 4.3.2__tar.gz → 4.3.4__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.
- {capmonstercloudclient-4.3.2/capmonstercloudclient.egg-info → capmonstercloudclient-4.3.4}/PKG-INFO +98 -54
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/README.md +97 -53
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/RecaptchaV2EnterpiseRequest.py +16 -2
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/utils.py +1 -1
- capmonstercloudclient-4.3.4/capmonstercloud_client/version.txt +1 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4/capmonstercloudclient.egg-info}/PKG-INFO +98 -54
- capmonstercloudclient-4.3.2/capmonstercloud_client/version.txt +0 -1
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/LICENSE +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/MANIFEST.in +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/CapMonsterCloudClient.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/GetResultTimeouts.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/__init__.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/captchaResult.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/clientOptions.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/exceptions.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requestController.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/AlibabaCustomTaskRequest.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/AltchaCustomTaskRequest.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/AmazonWafRequest.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/BasiliskCustomTaskRequest.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/BinanceTaskRequest.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/CastleCustomTaskRequest.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/ComplexImageTaskBase.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/CustomTaskRequestBase.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/DataDomeCustomTaskRequest.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/FriendlyCustomTaskRequest.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/FuncaptchaComplexImageTask.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/FuncaptchaRequest.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/GeetestRequest.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/HcaptchaComplexImageTask.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/HcaptchaRequest.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/HuntCustomTaskRequest.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/ImageToTextRequest.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/ImpervaCustomTaskRequest.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/MTCaptchaRequest.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/ProsopoTaskRequest.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/RecaptchaComplexImageTask.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/RecaptchaV2Request.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/RecaptchaV3EnterpriseRequest.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/RecaptchaV3ProxylessRequest.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/RecognitionComplexImageTaskRequest.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/TemuCustomTaskRequest.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/TenDiCustomTaskRequest.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/TspdCustomTaskRequest.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/TurnstileRequest.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/YidunRequest.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/__init__.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/baseRequest.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/baseRequestWithProxy.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/enums.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/proxy_info.py +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloudclient.egg-info/SOURCES.txt +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloudclient.egg-info/dependency_links.txt +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloudclient.egg-info/requires.txt +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloudclient.egg-info/top_level.txt +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/pyproject.toml +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/requirements.txt +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/setup.cfg +0 -0
- {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/setup.py +0 -0
{capmonstercloudclient-4.3.2/capmonstercloudclient.egg-info → capmonstercloudclient-4.3.4}/PKG-INFO
RENAMED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: capmonstercloudclient
|
|
3
|
-
Version: 4.3.
|
|
3
|
+
Version: 4.3.4
|
|
4
4
|
Summary: Official CapMonster Cloud Python SDK: captcha solver & captcha bypass for reCAPTCHA, Cloudflare Turnstile, DataDome and GeeTest. A 2captcha and capsolver alternative.
|
|
5
5
|
Home-page: https://github.com/CapMonsterCloud/capmonster-python-captcha-solver
|
|
6
6
|
Author: CapMonster Cloud
|
|
@@ -78,13 +78,13 @@ Dynamic: requires-dist
|
|
|
78
78
|
Dynamic: requires-python
|
|
79
79
|
Dynamic: summary
|
|
80
80
|
|
|
81
|
-
# CapMonster Cloud Python SDK:
|
|
81
|
+
# CapMonster Cloud Python SDK: Python Captcha Solver & Captcha Bypass for reCAPTCHA, Cloudflare Turnstile and GeeTest
|
|
82
82
|
|
|
83
|
-
> **🔄 Migrating from 2Captcha or Capsolver?** CapMonster Cloud is a fast, cost-effective **2captcha alternative** and **capsolver alternative
|
|
83
|
+
> **🔄 Migrating from 2Captcha or Capsolver?** CapMonster Cloud is a fast, cost-effective **2captcha alternative** and **capsolver alternative** for Python: reCAPTCHA v3 from **$0.90 per 1,000 solves**, which is **up to 38% cheaper than 2Captcha** and **10% cheaper than Capsolver**, with an API response time of **≤ 2 s**. Already have software built for 2Captcha? CapMonster Cloud [supports the 2Captcha API format](https://docs.capmonster.cloud/docs/external-services/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme). Moving your Python code takes just a few lines: see the **Migration examples** below. Full comparison and disclaimer are in the comparison section below.
|
|
84
84
|
|
|
85
85
|
<p align="center">
|
|
86
86
|
<a href="https://capmonster.cloud/en/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme">
|
|
87
|
-
<img src="https://img.shields.io/badge/CapMonster%20Cloud-Python%20Captcha%20Solver-00B2FF?style=for-the-badge&logo=python&logoColor=white" alt="CapMonster Cloud Python SDK" height="40">
|
|
87
|
+
<img src="https://img.shields.io/badge/CapMonster%20Cloud-Python%20Captcha%20Solver-00B2FF?style=for-the-badge&logo=python&logoColor=white" alt="CapMonster Cloud Python SDK - captcha solver and captcha bypass API client" height="40">
|
|
88
88
|
</a>
|
|
89
89
|
</p>
|
|
90
90
|
|
|
@@ -110,21 +110,22 @@ The CapMonster Cloud Python SDK (`capmonstercloudclient`, also known as the CapM
|
|
|
110
110
|
|
|
111
111
|
---
|
|
112
112
|
|
|
113
|
-
## ⚡ Highlights
|
|
113
|
+
## ⚡ Highlights
|
|
114
114
|
|
|
115
|
-
- ⚡ **Fast
|
|
116
|
-
- 🤖 **Zero
|
|
115
|
+
- ⚡ **Fast solving:** AI-based recognition, on average between 1 and 30 seconds depending on the captcha type.
|
|
116
|
+
- 🤖 **Zero human workers:** 100% automated machine learning pipeline with no manual latencies.
|
|
117
|
+
- 🛡️ **Modern anti-bot bypass:** Full support for Cloudflare Turnstile, reCAPTCHA Enterprise, GeeTest, DataDome, and Amazon WAF.
|
|
117
118
|
- 🌐 **Browser Automation Ready:** Works out-of-the-box with **Playwright, Selenium, and Puppeteer**.
|
|
118
|
-
-
|
|
119
|
-
-
|
|
120
|
-
-
|
|
121
|
-
-
|
|
119
|
+
- 💰 **Cost-effective:** Low-cost pricing structure based on pay-as-you-go balance.
|
|
120
|
+
- 📉 **Cheaper than alternatives:** reCAPTCHA v3 from $0.90 per 1,000 solves, versus $1.45 at 2Captcha and $1.00 at Capsolver.
|
|
121
|
+
- 🔄 **Easy migration:** replace your 2Captcha or Capsolver solver call and keep the rest of your scraper or bot unchanged.
|
|
122
|
+
- 📖 **Official docs:** request types follow the [CapMonster Cloud API documentation](https://docs.capmonster.cloud/docs/captchas/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
|
|
122
123
|
|
|
123
124
|
---
|
|
124
125
|
|
|
125
126
|
## 📊 CapMonster Cloud vs 2Captcha vs Capsolver
|
|
126
127
|
|
|
127
|
-
Looking for a 2captcha alternative or a capsolver alternative for web scraping and automation? Compare price, speed and success rate.
|
|
128
|
+
Looking for a 2captcha alternative or a capsolver alternative for Python web scraping and automation? Compare price, speed and success rate.
|
|
128
129
|
|
|
129
130
|
### reCAPTCHA v3
|
|
130
131
|
|
|
@@ -161,7 +162,7 @@ pip install capmonstercloudclient
|
|
|
161
162
|
|
|
162
163
|
---
|
|
163
164
|
|
|
164
|
-
## 🚀 Quick Start
|
|
165
|
+
## 🚀 Quick Start: Solve and Bypass Captchas in Python
|
|
165
166
|
|
|
166
167
|
### 1. Asynchronous reCAPTCHA v2 Solving
|
|
167
168
|
|
|
@@ -177,10 +178,10 @@ client = CapMonsterClient(options=options)
|
|
|
177
178
|
async def main():
|
|
178
179
|
# Build the task payload
|
|
179
180
|
request = RecaptchaV2Request(
|
|
180
|
-
websiteUrl="
|
|
181
|
+
websiteUrl="https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high",
|
|
181
182
|
websiteKey="6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd"
|
|
182
183
|
)
|
|
183
|
-
|
|
184
|
+
|
|
184
185
|
# Send task and receive token
|
|
185
186
|
result = await client.solve_captcha(request)
|
|
186
187
|
print("reCAPTCHA Token:", result.get("gRecaptchaResponse"))
|
|
@@ -203,7 +204,7 @@ client = CapMonsterClient(options=options)
|
|
|
203
204
|
async def run_scraper():
|
|
204
205
|
# Solve Turnstile challenge via CapMonster Cloud
|
|
205
206
|
turnstile_req = TurnstileRequest(
|
|
206
|
-
websiteURL="
|
|
207
|
+
websiteURL="https://target-website.com/login",
|
|
207
208
|
websiteKey="0x4AAAAAAABnPIDnK2k_e-2"
|
|
208
209
|
)
|
|
209
210
|
solution = await client.solve_captcha(turnstile_req)
|
|
@@ -213,8 +214,8 @@ async def run_scraper():
|
|
|
213
214
|
async with async_playwright() as p:
|
|
214
215
|
browser = await p.chromium.launch(headless=False)
|
|
215
216
|
page = await browser.new_page()
|
|
216
|
-
await page.goto("
|
|
217
|
-
|
|
217
|
+
await page.goto("https://target-website.com/login")
|
|
218
|
+
|
|
218
219
|
await page.evaluate(f'document.querySelector("[name=cf-turnstile-response]").value = "{token}";')
|
|
219
220
|
await page.click("#submit-button")
|
|
220
221
|
await browser.close()
|
|
@@ -227,9 +228,9 @@ if __name__ == "__main__":
|
|
|
227
228
|
|
|
228
229
|
## 🔄 Migrating from 2Captcha or Capsolver
|
|
229
230
|
|
|
230
|
-
Already use 2Captcha or Capsolver in your scraper or bot? Replace only the solver call and keep the rest of your parser unchanged. CapMonster Cloud follows the same flow: send the website URL and sitekey, receive the token.
|
|
231
|
+
Already use 2Captcha or Capsolver in your Python scraper or bot? Replace only the solver call and keep the rest of your parser unchanged. CapMonster Cloud follows the same flow: send the website URL and sitekey, receive the token.
|
|
231
232
|
|
|
232
|
-
###
|
|
233
|
+
### Before: 2Captcha (2captcha-python)
|
|
233
234
|
|
|
234
235
|
```python
|
|
235
236
|
# Before: 2Captcha
|
|
@@ -238,11 +239,28 @@ from twocaptcha import TwoCaptcha
|
|
|
238
239
|
solver = TwoCaptcha("YOUR_2CAPTCHA_API_KEY")
|
|
239
240
|
result = solver.recaptcha(
|
|
240
241
|
sitekey="YOUR_SITE_KEY",
|
|
241
|
-
url="
|
|
242
|
+
url="https://target-website.com/page-with-recaptcha",
|
|
242
243
|
)
|
|
243
244
|
token = result["code"]
|
|
244
245
|
```
|
|
245
246
|
|
|
247
|
+
### Before: Capsolver (capsolver-python)
|
|
248
|
+
|
|
249
|
+
```python
|
|
250
|
+
# Before: Capsolver
|
|
251
|
+
import capsolver
|
|
252
|
+
|
|
253
|
+
capsolver.api_key = "YOUR_CAPSOLVER_API_KEY"
|
|
254
|
+
solution = capsolver.solve({
|
|
255
|
+
"type": "ReCaptchaV2TaskProxyLess",
|
|
256
|
+
"websiteURL": "https://target-website.com/page-with-recaptcha",
|
|
257
|
+
"websiteKey": "YOUR_SITE_KEY",
|
|
258
|
+
})
|
|
259
|
+
token = solution["gRecaptchaResponse"]
|
|
260
|
+
```
|
|
261
|
+
|
|
262
|
+
### After: CapMonster Cloud
|
|
263
|
+
|
|
246
264
|
```python
|
|
247
265
|
# After: CapMonster Cloud
|
|
248
266
|
import asyncio
|
|
@@ -253,7 +271,7 @@ client = CapMonsterClient(options=ClientOptions(api_key="YOUR_CAPMONSTER_API_KEY
|
|
|
253
271
|
|
|
254
272
|
async def solve():
|
|
255
273
|
result = await client.solve_captcha(RecaptchaV2Request(
|
|
256
|
-
websiteUrl="
|
|
274
|
+
websiteUrl="https://target-website.com/page-with-recaptcha",
|
|
257
275
|
websiteKey="YOUR_SITE_KEY",
|
|
258
276
|
))
|
|
259
277
|
return result.get("gRecaptchaResponse")
|
|
@@ -261,22 +279,7 @@ async def solve():
|
|
|
261
279
|
token = asyncio.run(solve())
|
|
262
280
|
```
|
|
263
281
|
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
```python
|
|
267
|
-
# Before: Capsolver
|
|
268
|
-
import capsolver
|
|
269
|
-
|
|
270
|
-
capsolver.api_key = "YOUR_CAPSOLVER_API_KEY"
|
|
271
|
-
solution = capsolver.solve({
|
|
272
|
-
"type": "ReCaptchaV2TaskProxyLess",
|
|
273
|
-
"websiteURL": "[https://target-website.com/page-with-recaptcha](https://target-website.com/page-with-recaptcha)",
|
|
274
|
-
"websiteKey": "YOUR_SITE_KEY",
|
|
275
|
-
})
|
|
276
|
-
token = solution["gRecaptchaResponse"]
|
|
277
|
-
```
|
|
278
|
-
|
|
279
|
-
The "After" code is the same CapMonster Cloud snippet as above: only the client, the API key and the request class change, the rest of your scraper stays the same. If you use an async framework, call `await client.solve_captcha(...)` directly instead of `asyncio.run`.
|
|
282
|
+
Only the client, the API key and the request class change: the token is used exactly as before, so the rest of your scraper stays the same. If you use an async framework, call `await client.solve_captcha(...)` directly instead of `asyncio.run`.
|
|
280
283
|
|
|
281
284
|
### Keep existing 2Captcha-based software
|
|
282
285
|
|
|
@@ -284,11 +287,11 @@ Software that already speaks the 2Captcha API can work with CapMonster Cloud wit
|
|
|
284
287
|
|
|
285
288
|
---
|
|
286
289
|
|
|
287
|
-
## 🛡️ Supported CAPTCHA Types: reCAPTCHA, Cloudflare Turnstile,
|
|
290
|
+
## 🛡️ Supported CAPTCHA Types: Bypass reCAPTCHA, Cloudflare Turnstile, GeeTest and More
|
|
288
291
|
|
|
289
292
|
Use this Python captcha solver for captcha bypass in web scraping and automation: reCAPTCHA bypass (v2, v3, Enterprise), Cloudflare Turnstile solver, DataDome solver, GeeTest solver, Amazon WAF bypass and image-to-text recognition.
|
|
290
293
|
|
|
291
|
-
All task types
|
|
294
|
+
All task types follow the official [CapMonster Cloud API documentation](https://docs.capmonster.cloud/docs/captchas/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme):
|
|
292
295
|
|
|
293
296
|
| Protection Type | Task Request Class | Proxyless Mode |
|
|
294
297
|
| :--- | :--- | :---: |
|
|
@@ -315,10 +318,10 @@ All task types conform to the official [CapMonster Cloud API Documentation](http
|
|
|
315
318
|
[ Extract sitekey & website URL ]
|
|
316
319
|
│
|
|
317
320
|
▼
|
|
318
|
-
[ CapMonsterClient API ] ──► POST createTask to
|
|
321
|
+
[ CapMonsterClient API ] ──► POST createTask to https://api.capmonster.cloud
|
|
319
322
|
│
|
|
320
323
|
▼
|
|
321
|
-
[ Neural Network Processing ] ──► Poll getTaskResult
|
|
324
|
+
[ Neural Network Processing ] ──► Poll getTaskResult until the task is ready
|
|
322
325
|
│
|
|
323
326
|
▼
|
|
324
327
|
[ Receive Token & Autosubmit ] ──► Complete bypass
|
|
@@ -328,46 +331,87 @@ All task types conform to the official [CapMonster Cloud API Documentation](http
|
|
|
328
331
|
|
|
329
332
|
## ⚙️ Best Practices
|
|
330
333
|
|
|
331
|
-
- **
|
|
332
|
-
- **
|
|
333
|
-
- **
|
|
334
|
+
- **Use tokens promptly:** CAPTCHA tokens expire quickly (a reCAPTCHA v2 token is valid for 60 seconds after solving), so submit or inject the solution immediately after receiving the response.
|
|
335
|
+
- **Keep session context consistent:** When a task uses a proxy, use the same proxy in your scraping or browser session and in the CapMonster task.
|
|
336
|
+
- **Use the right task type:** Choose the request type that matches the target protection and follow the required parameters in the [documentation](https://docs.capmonster.cloud/docs/captchas/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
|
|
337
|
+
- **Monitor your balance:** Keep your account balance positive in the [Dashboard](https://dash.capmonster.cloud/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme) and handle API errors in your code.
|
|
338
|
+
|
|
339
|
+
---
|
|
340
|
+
|
|
341
|
+
## 💡 Use Cases
|
|
342
|
+
|
|
343
|
+
- **Web scraping and data collection** from websites you are authorized to access, without manual captcha solving.
|
|
344
|
+
- **Browser automation:** get the solution token in Python and inject it into the page with your automation tool.
|
|
345
|
+
- **Automated testing (QA)** of your own website and its captcha-protected forms.
|
|
346
|
+
- **Backend services** that need a captcha solving API inside a Python application.
|
|
334
347
|
|
|
335
348
|
---
|
|
336
349
|
|
|
337
350
|
## ❓ FAQ
|
|
338
351
|
|
|
339
|
-
**Is CapMonster Cloud a 2Captcha alternative?**
|
|
352
|
+
**Is CapMonster Cloud a 2Captcha alternative for Python?**
|
|
340
353
|
Yes. It is a captcha solving service with an official Python SDK. For reCAPTCHA v3 it starts at $0.90 per 1,000 solves versus $1.45 at 2Captcha, which is up to 38% cheaper. For Cloudflare Turnstile it starts at $1.30 versus $1.45, which is 10% cheaper.
|
|
341
354
|
|
|
342
|
-
**Is CapMonster Cloud a Capsolver alternative?**
|
|
355
|
+
**Is CapMonster Cloud a Capsolver alternative for Python?**
|
|
343
356
|
Yes. For reCAPTCHA v3 it is 10% cheaper than Capsolver ($0.90 versus $1.00 per 1,000 solves) and shows an API response time of ≤ 2 s versus < 3 s. See the comparison table above and its disclaimer.
|
|
344
357
|
|
|
345
358
|
**How do I migrate from 2Captcha or Capsolver to CapMonster Cloud in Python?**
|
|
346
359
|
Install `capmonstercloudclient`, create a `CapMonsterClient` with your API key and replace your solver call with `client.solve_captcha(...)`. See the migration examples above. Software that already supports the 2Captcha API can also be connected through the [CapMonster Cloud guide](https://docs.capmonster.cloud/docs/external-services/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
|
|
347
360
|
|
|
348
|
-
**
|
|
349
|
-
|
|
361
|
+
**Is there an official Python captcha solver from CapMonster Cloud?**
|
|
362
|
+
Yes. This repository is the official Python client library for the CapMonster Cloud captcha solving service.
|
|
350
363
|
|
|
351
|
-
**
|
|
352
|
-
|
|
364
|
+
**How do I bypass reCAPTCHA v2 in Python?**
|
|
365
|
+
Create a `CapMonsterClient` with your API key, pass a `RecaptchaV2Request` with the page URL and sitekey to `client.solve_captcha()` and read `result.get("gRecaptchaResponse")`. See the [reCAPTCHA v2 documentation](https://docs.capmonster.cloud/docs/captchas/no-captcha-task/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
|
|
366
|
+
|
|
367
|
+
**How do I bypass Cloudflare Turnstile in Python?**
|
|
368
|
+
Use `TurnstileRequest` with the page URL and sitekey, as in example 2 above, and read `solution.get("token")`. According to the [Turnstile documentation](https://docs.capmonster.cloud/docs/captchas/turnstile-task/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme), all Turnstile subtypes are supported automatically: manual, non-interactive and invisible.
|
|
369
|
+
|
|
370
|
+
**Which captcha types does the Python SDK solve?**
|
|
371
|
+
reCAPTCHA v2, v3 and Enterprise, Cloudflare Turnstile, GeeTest, Amazon WAF, DataDome, Imperva / Incapsula, Binance CAPTCHA, standard text (image-to-text) captchas and reCAPTCHA image tasks. See the supported types table above and the [Supported Captchas Overview](https://docs.capmonster.cloud/docs/captchas/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
|
|
353
372
|
|
|
354
373
|
**How do I get an API key?**
|
|
355
374
|
Register on CapMonster Cloud, top up your balance and copy your API key. The [Getting Started Guide](https://docs.capmonster.cloud/docs/getting-start/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme) describes each step.
|
|
356
375
|
|
|
376
|
+
**Which Python versions are supported?**
|
|
377
|
+
The package on PyPI requires Python 3.6 or newer.
|
|
378
|
+
|
|
379
|
+
**How fast are captchas solved?**
|
|
380
|
+
On average between 1 and 30 seconds, depending on the captcha type. More details are in the [CapMonster Cloud FAQ](https://docs.capmonster.cloud/docs/faq/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
|
|
381
|
+
|
|
382
|
+
**How long is a reCAPTCHA v2 solution valid?**
|
|
383
|
+
According to the [reCAPTCHA v2 documentation](https://docs.capmonster.cloud/docs/captchas/no-captcha-task/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme), the returned token is valid for 60 seconds after the captcha is solved, so use it right away.
|
|
384
|
+
|
|
385
|
+
**Where is the full API reference?**
|
|
386
|
+
See the [API Methods Reference](https://docs.capmonster.cloud/docs/methods/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
|
|
387
|
+
|
|
357
388
|
---
|
|
358
389
|
|
|
359
|
-
##
|
|
390
|
+
## ⚖️ Responsible Use
|
|
391
|
+
|
|
392
|
+
CapMonster Cloud is intended for legitimate business purposes only, such as testing your own website or a website you are authorized to test, and recognizing images you provide. Read more about [ethical and transparent captcha automation](https://capmonster.cloud/en/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
|
|
393
|
+
|
|
394
|
+
---
|
|
395
|
+
|
|
396
|
+
## 📚 Documentation & Support
|
|
360
397
|
|
|
361
398
|
- 📖 [Getting Started Guide](https://docs.capmonster.cloud/docs/getting-start/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme)
|
|
362
399
|
- 🎯 [Supported Captchas Overview](https://docs.capmonster.cloud/docs/captchas/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme)
|
|
363
400
|
- ⚙️ [API Methods Reference](https://docs.capmonster.cloud/docs/methods/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme)
|
|
401
|
+
- ❓ [CapMonster Cloud FAQ](https://docs.capmonster.cloud/docs/faq/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme)
|
|
402
|
+
- 🌐 [Browser Extension Guides](https://docs.capmonster.cloud/docs/extension/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme)
|
|
364
403
|
- 💬 [Support & Community](https://capmonster.cloud/en/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme#support)
|
|
365
404
|
|
|
366
|
-
## Other official SDKs
|
|
405
|
+
## Other official SDKs & integrations
|
|
367
406
|
|
|
368
|
-
- [.NET](https://github.com/CapMonsterCloud/capmonster-dotnet-captcha-solver)
|
|
369
407
|
- [Node.js](https://github.com/CapMonsterCloud/capmonster-nodejs-captcha-solver)
|
|
408
|
+
- [.NET](https://github.com/CapMonsterCloud/capmonster-dotnet-captcha-solver)
|
|
409
|
+
- [Go](https://github.com/CapMonsterCloud/capmonster-go-captcha-solver)
|
|
410
|
+
- [PHP](https://github.com/CapMonsterCloud/capmonster-php-captcha-solver)
|
|
411
|
+
- [Rust](https://github.com/CapMonsterCloud/capmonster-rust-captcha-solver)
|
|
370
412
|
- [n8n](https://github.com/CapMonsterCloud/capmonster-n8n-captcha-solver)
|
|
413
|
+
- [MCP server](https://github.com/CapMonsterCloud/capmonster-mcp-captcha-solver)
|
|
414
|
+
- [MCP server for Patchright](https://github.com/CapMonsterCloud/capmonster-mcp-patchright-captcha-solver)
|
|
371
415
|
- [API Docs](https://github.com/CapMonsterCloud/capmonster-captcha-solver-docs)
|
|
372
416
|
|
|
373
417
|
---
|
|
@@ -1,10 +1,10 @@
|
|
|
1
|
-
# CapMonster Cloud Python SDK:
|
|
1
|
+
# CapMonster Cloud Python SDK: Python Captcha Solver & Captcha Bypass for reCAPTCHA, Cloudflare Turnstile and GeeTest
|
|
2
2
|
|
|
3
|
-
> **🔄 Migrating from 2Captcha or Capsolver?** CapMonster Cloud is a fast, cost-effective **2captcha alternative** and **capsolver alternative
|
|
3
|
+
> **🔄 Migrating from 2Captcha or Capsolver?** CapMonster Cloud is a fast, cost-effective **2captcha alternative** and **capsolver alternative** for Python: reCAPTCHA v3 from **$0.90 per 1,000 solves**, which is **up to 38% cheaper than 2Captcha** and **10% cheaper than Capsolver**, with an API response time of **≤ 2 s**. Already have software built for 2Captcha? CapMonster Cloud [supports the 2Captcha API format](https://docs.capmonster.cloud/docs/external-services/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme). Moving your Python code takes just a few lines: see the **Migration examples** below. Full comparison and disclaimer are in the comparison section below.
|
|
4
4
|
|
|
5
5
|
<p align="center">
|
|
6
6
|
<a href="https://capmonster.cloud/en/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme">
|
|
7
|
-
<img src="https://img.shields.io/badge/CapMonster%20Cloud-Python%20Captcha%20Solver-00B2FF?style=for-the-badge&logo=python&logoColor=white" alt="CapMonster Cloud Python SDK" height="40">
|
|
7
|
+
<img src="https://img.shields.io/badge/CapMonster%20Cloud-Python%20Captcha%20Solver-00B2FF?style=for-the-badge&logo=python&logoColor=white" alt="CapMonster Cloud Python SDK - captcha solver and captcha bypass API client" height="40">
|
|
8
8
|
</a>
|
|
9
9
|
</p>
|
|
10
10
|
|
|
@@ -30,21 +30,22 @@ The CapMonster Cloud Python SDK (`capmonstercloudclient`, also known as the CapM
|
|
|
30
30
|
|
|
31
31
|
---
|
|
32
32
|
|
|
33
|
-
## ⚡ Highlights
|
|
33
|
+
## ⚡ Highlights
|
|
34
34
|
|
|
35
|
-
- ⚡ **Fast
|
|
36
|
-
- 🤖 **Zero
|
|
35
|
+
- ⚡ **Fast solving:** AI-based recognition, on average between 1 and 30 seconds depending on the captcha type.
|
|
36
|
+
- 🤖 **Zero human workers:** 100% automated machine learning pipeline with no manual latencies.
|
|
37
|
+
- 🛡️ **Modern anti-bot bypass:** Full support for Cloudflare Turnstile, reCAPTCHA Enterprise, GeeTest, DataDome, and Amazon WAF.
|
|
37
38
|
- 🌐 **Browser Automation Ready:** Works out-of-the-box with **Playwright, Selenium, and Puppeteer**.
|
|
38
|
-
-
|
|
39
|
-
-
|
|
40
|
-
-
|
|
41
|
-
-
|
|
39
|
+
- 💰 **Cost-effective:** Low-cost pricing structure based on pay-as-you-go balance.
|
|
40
|
+
- 📉 **Cheaper than alternatives:** reCAPTCHA v3 from $0.90 per 1,000 solves, versus $1.45 at 2Captcha and $1.00 at Capsolver.
|
|
41
|
+
- 🔄 **Easy migration:** replace your 2Captcha or Capsolver solver call and keep the rest of your scraper or bot unchanged.
|
|
42
|
+
- 📖 **Official docs:** request types follow the [CapMonster Cloud API documentation](https://docs.capmonster.cloud/docs/captchas/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
|
|
42
43
|
|
|
43
44
|
---
|
|
44
45
|
|
|
45
46
|
## 📊 CapMonster Cloud vs 2Captcha vs Capsolver
|
|
46
47
|
|
|
47
|
-
Looking for a 2captcha alternative or a capsolver alternative for web scraping and automation? Compare price, speed and success rate.
|
|
48
|
+
Looking for a 2captcha alternative or a capsolver alternative for Python web scraping and automation? Compare price, speed and success rate.
|
|
48
49
|
|
|
49
50
|
### reCAPTCHA v3
|
|
50
51
|
|
|
@@ -81,7 +82,7 @@ pip install capmonstercloudclient
|
|
|
81
82
|
|
|
82
83
|
---
|
|
83
84
|
|
|
84
|
-
## 🚀 Quick Start
|
|
85
|
+
## 🚀 Quick Start: Solve and Bypass Captchas in Python
|
|
85
86
|
|
|
86
87
|
### 1. Asynchronous reCAPTCHA v2 Solving
|
|
87
88
|
|
|
@@ -97,10 +98,10 @@ client = CapMonsterClient(options=options)
|
|
|
97
98
|
async def main():
|
|
98
99
|
# Build the task payload
|
|
99
100
|
request = RecaptchaV2Request(
|
|
100
|
-
websiteUrl="
|
|
101
|
+
websiteUrl="https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high",
|
|
101
102
|
websiteKey="6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd"
|
|
102
103
|
)
|
|
103
|
-
|
|
104
|
+
|
|
104
105
|
# Send task and receive token
|
|
105
106
|
result = await client.solve_captcha(request)
|
|
106
107
|
print("reCAPTCHA Token:", result.get("gRecaptchaResponse"))
|
|
@@ -123,7 +124,7 @@ client = CapMonsterClient(options=options)
|
|
|
123
124
|
async def run_scraper():
|
|
124
125
|
# Solve Turnstile challenge via CapMonster Cloud
|
|
125
126
|
turnstile_req = TurnstileRequest(
|
|
126
|
-
websiteURL="
|
|
127
|
+
websiteURL="https://target-website.com/login",
|
|
127
128
|
websiteKey="0x4AAAAAAABnPIDnK2k_e-2"
|
|
128
129
|
)
|
|
129
130
|
solution = await client.solve_captcha(turnstile_req)
|
|
@@ -133,8 +134,8 @@ async def run_scraper():
|
|
|
133
134
|
async with async_playwright() as p:
|
|
134
135
|
browser = await p.chromium.launch(headless=False)
|
|
135
136
|
page = await browser.new_page()
|
|
136
|
-
await page.goto("
|
|
137
|
-
|
|
137
|
+
await page.goto("https://target-website.com/login")
|
|
138
|
+
|
|
138
139
|
await page.evaluate(f'document.querySelector("[name=cf-turnstile-response]").value = "{token}";')
|
|
139
140
|
await page.click("#submit-button")
|
|
140
141
|
await browser.close()
|
|
@@ -147,9 +148,9 @@ if __name__ == "__main__":
|
|
|
147
148
|
|
|
148
149
|
## 🔄 Migrating from 2Captcha or Capsolver
|
|
149
150
|
|
|
150
|
-
Already use 2Captcha or Capsolver in your scraper or bot? Replace only the solver call and keep the rest of your parser unchanged. CapMonster Cloud follows the same flow: send the website URL and sitekey, receive the token.
|
|
151
|
+
Already use 2Captcha or Capsolver in your Python scraper or bot? Replace only the solver call and keep the rest of your parser unchanged. CapMonster Cloud follows the same flow: send the website URL and sitekey, receive the token.
|
|
151
152
|
|
|
152
|
-
###
|
|
153
|
+
### Before: 2Captcha (2captcha-python)
|
|
153
154
|
|
|
154
155
|
```python
|
|
155
156
|
# Before: 2Captcha
|
|
@@ -158,11 +159,28 @@ from twocaptcha import TwoCaptcha
|
|
|
158
159
|
solver = TwoCaptcha("YOUR_2CAPTCHA_API_KEY")
|
|
159
160
|
result = solver.recaptcha(
|
|
160
161
|
sitekey="YOUR_SITE_KEY",
|
|
161
|
-
url="
|
|
162
|
+
url="https://target-website.com/page-with-recaptcha",
|
|
162
163
|
)
|
|
163
164
|
token = result["code"]
|
|
164
165
|
```
|
|
165
166
|
|
|
167
|
+
### Before: Capsolver (capsolver-python)
|
|
168
|
+
|
|
169
|
+
```python
|
|
170
|
+
# Before: Capsolver
|
|
171
|
+
import capsolver
|
|
172
|
+
|
|
173
|
+
capsolver.api_key = "YOUR_CAPSOLVER_API_KEY"
|
|
174
|
+
solution = capsolver.solve({
|
|
175
|
+
"type": "ReCaptchaV2TaskProxyLess",
|
|
176
|
+
"websiteURL": "https://target-website.com/page-with-recaptcha",
|
|
177
|
+
"websiteKey": "YOUR_SITE_KEY",
|
|
178
|
+
})
|
|
179
|
+
token = solution["gRecaptchaResponse"]
|
|
180
|
+
```
|
|
181
|
+
|
|
182
|
+
### After: CapMonster Cloud
|
|
183
|
+
|
|
166
184
|
```python
|
|
167
185
|
# After: CapMonster Cloud
|
|
168
186
|
import asyncio
|
|
@@ -173,7 +191,7 @@ client = CapMonsterClient(options=ClientOptions(api_key="YOUR_CAPMONSTER_API_KEY
|
|
|
173
191
|
|
|
174
192
|
async def solve():
|
|
175
193
|
result = await client.solve_captcha(RecaptchaV2Request(
|
|
176
|
-
websiteUrl="
|
|
194
|
+
websiteUrl="https://target-website.com/page-with-recaptcha",
|
|
177
195
|
websiteKey="YOUR_SITE_KEY",
|
|
178
196
|
))
|
|
179
197
|
return result.get("gRecaptchaResponse")
|
|
@@ -181,22 +199,7 @@ async def solve():
|
|
|
181
199
|
token = asyncio.run(solve())
|
|
182
200
|
```
|
|
183
201
|
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
```python
|
|
187
|
-
# Before: Capsolver
|
|
188
|
-
import capsolver
|
|
189
|
-
|
|
190
|
-
capsolver.api_key = "YOUR_CAPSOLVER_API_KEY"
|
|
191
|
-
solution = capsolver.solve({
|
|
192
|
-
"type": "ReCaptchaV2TaskProxyLess",
|
|
193
|
-
"websiteURL": "[https://target-website.com/page-with-recaptcha](https://target-website.com/page-with-recaptcha)",
|
|
194
|
-
"websiteKey": "YOUR_SITE_KEY",
|
|
195
|
-
})
|
|
196
|
-
token = solution["gRecaptchaResponse"]
|
|
197
|
-
```
|
|
198
|
-
|
|
199
|
-
The "After" code is the same CapMonster Cloud snippet as above: only the client, the API key and the request class change, the rest of your scraper stays the same. If you use an async framework, call `await client.solve_captcha(...)` directly instead of `asyncio.run`.
|
|
202
|
+
Only the client, the API key and the request class change: the token is used exactly as before, so the rest of your scraper stays the same. If you use an async framework, call `await client.solve_captcha(...)` directly instead of `asyncio.run`.
|
|
200
203
|
|
|
201
204
|
### Keep existing 2Captcha-based software
|
|
202
205
|
|
|
@@ -204,11 +207,11 @@ Software that already speaks the 2Captcha API can work with CapMonster Cloud wit
|
|
|
204
207
|
|
|
205
208
|
---
|
|
206
209
|
|
|
207
|
-
## 🛡️ Supported CAPTCHA Types: reCAPTCHA, Cloudflare Turnstile,
|
|
210
|
+
## 🛡️ Supported CAPTCHA Types: Bypass reCAPTCHA, Cloudflare Turnstile, GeeTest and More
|
|
208
211
|
|
|
209
212
|
Use this Python captcha solver for captcha bypass in web scraping and automation: reCAPTCHA bypass (v2, v3, Enterprise), Cloudflare Turnstile solver, DataDome solver, GeeTest solver, Amazon WAF bypass and image-to-text recognition.
|
|
210
213
|
|
|
211
|
-
All task types
|
|
214
|
+
All task types follow the official [CapMonster Cloud API documentation](https://docs.capmonster.cloud/docs/captchas/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme):
|
|
212
215
|
|
|
213
216
|
| Protection Type | Task Request Class | Proxyless Mode |
|
|
214
217
|
| :--- | :--- | :---: |
|
|
@@ -235,10 +238,10 @@ All task types conform to the official [CapMonster Cloud API Documentation](http
|
|
|
235
238
|
[ Extract sitekey & website URL ]
|
|
236
239
|
│
|
|
237
240
|
▼
|
|
238
|
-
[ CapMonsterClient API ] ──► POST createTask to
|
|
241
|
+
[ CapMonsterClient API ] ──► POST createTask to https://api.capmonster.cloud
|
|
239
242
|
│
|
|
240
243
|
▼
|
|
241
|
-
[ Neural Network Processing ] ──► Poll getTaskResult
|
|
244
|
+
[ Neural Network Processing ] ──► Poll getTaskResult until the task is ready
|
|
242
245
|
│
|
|
243
246
|
▼
|
|
244
247
|
[ Receive Token & Autosubmit ] ──► Complete bypass
|
|
@@ -248,46 +251,87 @@ All task types conform to the official [CapMonster Cloud API Documentation](http
|
|
|
248
251
|
|
|
249
252
|
## ⚙️ Best Practices
|
|
250
253
|
|
|
251
|
-
- **
|
|
252
|
-
- **
|
|
253
|
-
- **
|
|
254
|
+
- **Use tokens promptly:** CAPTCHA tokens expire quickly (a reCAPTCHA v2 token is valid for 60 seconds after solving), so submit or inject the solution immediately after receiving the response.
|
|
255
|
+
- **Keep session context consistent:** When a task uses a proxy, use the same proxy in your scraping or browser session and in the CapMonster task.
|
|
256
|
+
- **Use the right task type:** Choose the request type that matches the target protection and follow the required parameters in the [documentation](https://docs.capmonster.cloud/docs/captchas/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
|
|
257
|
+
- **Monitor your balance:** Keep your account balance positive in the [Dashboard](https://dash.capmonster.cloud/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme) and handle API errors in your code.
|
|
258
|
+
|
|
259
|
+
---
|
|
260
|
+
|
|
261
|
+
## 💡 Use Cases
|
|
262
|
+
|
|
263
|
+
- **Web scraping and data collection** from websites you are authorized to access, without manual captcha solving.
|
|
264
|
+
- **Browser automation:** get the solution token in Python and inject it into the page with your automation tool.
|
|
265
|
+
- **Automated testing (QA)** of your own website and its captcha-protected forms.
|
|
266
|
+
- **Backend services** that need a captcha solving API inside a Python application.
|
|
254
267
|
|
|
255
268
|
---
|
|
256
269
|
|
|
257
270
|
## ❓ FAQ
|
|
258
271
|
|
|
259
|
-
**Is CapMonster Cloud a 2Captcha alternative?**
|
|
272
|
+
**Is CapMonster Cloud a 2Captcha alternative for Python?**
|
|
260
273
|
Yes. It is a captcha solving service with an official Python SDK. For reCAPTCHA v3 it starts at $0.90 per 1,000 solves versus $1.45 at 2Captcha, which is up to 38% cheaper. For Cloudflare Turnstile it starts at $1.30 versus $1.45, which is 10% cheaper.
|
|
261
274
|
|
|
262
|
-
**Is CapMonster Cloud a Capsolver alternative?**
|
|
275
|
+
**Is CapMonster Cloud a Capsolver alternative for Python?**
|
|
263
276
|
Yes. For reCAPTCHA v3 it is 10% cheaper than Capsolver ($0.90 versus $1.00 per 1,000 solves) and shows an API response time of ≤ 2 s versus < 3 s. See the comparison table above and its disclaimer.
|
|
264
277
|
|
|
265
278
|
**How do I migrate from 2Captcha or Capsolver to CapMonster Cloud in Python?**
|
|
266
279
|
Install `capmonstercloudclient`, create a `CapMonsterClient` with your API key and replace your solver call with `client.solve_captcha(...)`. See the migration examples above. Software that already supports the 2Captcha API can also be connected through the [CapMonster Cloud guide](https://docs.capmonster.cloud/docs/external-services/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
|
|
267
280
|
|
|
268
|
-
**
|
|
269
|
-
|
|
281
|
+
**Is there an official Python captcha solver from CapMonster Cloud?**
|
|
282
|
+
Yes. This repository is the official Python client library for the CapMonster Cloud captcha solving service.
|
|
270
283
|
|
|
271
|
-
**
|
|
272
|
-
|
|
284
|
+
**How do I bypass reCAPTCHA v2 in Python?**
|
|
285
|
+
Create a `CapMonsterClient` with your API key, pass a `RecaptchaV2Request` with the page URL and sitekey to `client.solve_captcha()` and read `result.get("gRecaptchaResponse")`. See the [reCAPTCHA v2 documentation](https://docs.capmonster.cloud/docs/captchas/no-captcha-task/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
|
|
286
|
+
|
|
287
|
+
**How do I bypass Cloudflare Turnstile in Python?**
|
|
288
|
+
Use `TurnstileRequest` with the page URL and sitekey, as in example 2 above, and read `solution.get("token")`. According to the [Turnstile documentation](https://docs.capmonster.cloud/docs/captchas/turnstile-task/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme), all Turnstile subtypes are supported automatically: manual, non-interactive and invisible.
|
|
289
|
+
|
|
290
|
+
**Which captcha types does the Python SDK solve?**
|
|
291
|
+
reCAPTCHA v2, v3 and Enterprise, Cloudflare Turnstile, GeeTest, Amazon WAF, DataDome, Imperva / Incapsula, Binance CAPTCHA, standard text (image-to-text) captchas and reCAPTCHA image tasks. See the supported types table above and the [Supported Captchas Overview](https://docs.capmonster.cloud/docs/captchas/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
|
|
273
292
|
|
|
274
293
|
**How do I get an API key?**
|
|
275
294
|
Register on CapMonster Cloud, top up your balance and copy your API key. The [Getting Started Guide](https://docs.capmonster.cloud/docs/getting-start/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme) describes each step.
|
|
276
295
|
|
|
296
|
+
**Which Python versions are supported?**
|
|
297
|
+
The package on PyPI requires Python 3.6 or newer.
|
|
298
|
+
|
|
299
|
+
**How fast are captchas solved?**
|
|
300
|
+
On average between 1 and 30 seconds, depending on the captcha type. More details are in the [CapMonster Cloud FAQ](https://docs.capmonster.cloud/docs/faq/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
|
|
301
|
+
|
|
302
|
+
**How long is a reCAPTCHA v2 solution valid?**
|
|
303
|
+
According to the [reCAPTCHA v2 documentation](https://docs.capmonster.cloud/docs/captchas/no-captcha-task/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme), the returned token is valid for 60 seconds after the captcha is solved, so use it right away.
|
|
304
|
+
|
|
305
|
+
**Where is the full API reference?**
|
|
306
|
+
See the [API Methods Reference](https://docs.capmonster.cloud/docs/methods/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
|
|
307
|
+
|
|
277
308
|
---
|
|
278
309
|
|
|
279
|
-
##
|
|
310
|
+
## ⚖️ Responsible Use
|
|
311
|
+
|
|
312
|
+
CapMonster Cloud is intended for legitimate business purposes only, such as testing your own website or a website you are authorized to test, and recognizing images you provide. Read more about [ethical and transparent captcha automation](https://capmonster.cloud/en/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
|
|
313
|
+
|
|
314
|
+
---
|
|
315
|
+
|
|
316
|
+
## 📚 Documentation & Support
|
|
280
317
|
|
|
281
318
|
- 📖 [Getting Started Guide](https://docs.capmonster.cloud/docs/getting-start/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme)
|
|
282
319
|
- 🎯 [Supported Captchas Overview](https://docs.capmonster.cloud/docs/captchas/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme)
|
|
283
320
|
- ⚙️ [API Methods Reference](https://docs.capmonster.cloud/docs/methods/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme)
|
|
321
|
+
- ❓ [CapMonster Cloud FAQ](https://docs.capmonster.cloud/docs/faq/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme)
|
|
322
|
+
- 🌐 [Browser Extension Guides](https://docs.capmonster.cloud/docs/extension/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme)
|
|
284
323
|
- 💬 [Support & Community](https://capmonster.cloud/en/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme#support)
|
|
285
324
|
|
|
286
|
-
## Other official SDKs
|
|
325
|
+
## Other official SDKs & integrations
|
|
287
326
|
|
|
288
|
-
- [.NET](https://github.com/CapMonsterCloud/capmonster-dotnet-captcha-solver)
|
|
289
327
|
- [Node.js](https://github.com/CapMonsterCloud/capmonster-nodejs-captcha-solver)
|
|
328
|
+
- [.NET](https://github.com/CapMonsterCloud/capmonster-dotnet-captcha-solver)
|
|
329
|
+
- [Go](https://github.com/CapMonsterCloud/capmonster-go-captcha-solver)
|
|
330
|
+
- [PHP](https://github.com/CapMonsterCloud/capmonster-php-captcha-solver)
|
|
331
|
+
- [Rust](https://github.com/CapMonsterCloud/capmonster-rust-captcha-solver)
|
|
290
332
|
- [n8n](https://github.com/CapMonsterCloud/capmonster-n8n-captcha-solver)
|
|
333
|
+
- [MCP server](https://github.com/CapMonsterCloud/capmonster-mcp-captcha-solver)
|
|
334
|
+
- [MCP server for Patchright](https://github.com/CapMonsterCloud/capmonster-mcp-patchright-captcha-solver)
|
|
291
335
|
- [API Docs](https://github.com/CapMonsterCloud/capmonster-captcha-solver-docs)
|
|
292
336
|
|
|
293
337
|
---
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
from typing import Dict, Union, Optional
|
|
2
|
-
from pydantic import Field
|
|
2
|
+
from pydantic import Field, field_validator
|
|
3
3
|
|
|
4
4
|
from .baseRequestWithProxy import BaseRequestWithProxy
|
|
5
5
|
|
|
@@ -22,6 +22,8 @@ class RecaptchaV2EnterpriseRequest(BaseRequestWithProxy):
|
|
|
22
22
|
domain.
|
|
23
23
|
pageAction: The action name configured for the reCAPTCHA Enterprise
|
|
24
24
|
challenge on the target website.
|
|
25
|
+
minScore: The minimum acceptable score for the token, in the range
|
|
26
|
+
0.1-0.9.
|
|
25
27
|
recaptchaDataSValue: The one-time token from the widget's "data-s"
|
|
26
28
|
parameter, if present on the page.
|
|
27
29
|
userAgent: The User-Agent string of the browser that should be
|
|
@@ -35,11 +37,21 @@ class RecaptchaV2EnterpriseRequest(BaseRequestWithProxy):
|
|
|
35
37
|
enterprisePayload: Optional[str] = Field(default=None, description='Additional parameters passed to the reCAPTCHA Enterprise widget, such as a custom "s" value used by some implementations.')
|
|
36
38
|
apiDomain: Optional[str] = Field(default=None, description='The domain to load the reCAPTCHA API from, used when the challenge is served from a domain other than the default Google domain.')
|
|
37
39
|
pageAction: Optional[str] = Field(default=None, description='The action name configured for the reCAPTCHA Enterprise challenge on the target website.')
|
|
40
|
+
minScore: Optional[float] = Field(default=None, description='Minimum acceptable score for the token, in the range 0.1-0.9.')
|
|
38
41
|
recaptchaDataSValue: Optional[str] = Field(default=None, description='The one-time token from the widget\'s "data-s" parameter, if present on the page.')
|
|
39
42
|
userAgent: Optional[str] = Field(default=None, description='The User-Agent string of the browser that should be emulated while solving the challenge.')
|
|
40
43
|
cookies: Optional[str] = Field(default=None, description='Cookies to be sent along with the request when solving the challenge.')
|
|
41
44
|
|
|
42
|
-
|
|
45
|
+
@field_validator('minScore')
|
|
46
|
+
@classmethod
|
|
47
|
+
def validate_min_score(cls, value):
|
|
48
|
+
if value is not None:
|
|
49
|
+
if not 0.1 <= value <= 0.9:
|
|
50
|
+
raise ValueError(f'Minimum score value should be found in interval 0.1 - 0.9, ' \
|
|
51
|
+
f'current "{value}".')
|
|
52
|
+
return value
|
|
53
|
+
|
|
54
|
+
def getTaskDict(self) -> Dict[str, Union[str, int, float]]:
|
|
43
55
|
task = {}
|
|
44
56
|
task['type'] = self.type
|
|
45
57
|
task['websiteURL'] = self.websiteUrl
|
|
@@ -56,6 +68,8 @@ class RecaptchaV2EnterpriseRequest(BaseRequestWithProxy):
|
|
|
56
68
|
task['apiDomain'] = self.apiDomain
|
|
57
69
|
if self.pageAction is not None:
|
|
58
70
|
task['pageAction'] = self.pageAction
|
|
71
|
+
if self.minScore is not None:
|
|
72
|
+
task['minScore'] = self.minScore
|
|
59
73
|
if self.recaptchaDataSValue is not None:
|
|
60
74
|
task['recaptchaDataSValue'] = self.recaptchaDataSValue
|
|
61
75
|
if self.userAgent is not None:
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
4.3.4
|
{capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4/capmonstercloudclient.egg-info}/PKG-INFO
RENAMED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: capmonstercloudclient
|
|
3
|
-
Version: 4.3.
|
|
3
|
+
Version: 4.3.4
|
|
4
4
|
Summary: Official CapMonster Cloud Python SDK: captcha solver & captcha bypass for reCAPTCHA, Cloudflare Turnstile, DataDome and GeeTest. A 2captcha and capsolver alternative.
|
|
5
5
|
Home-page: https://github.com/CapMonsterCloud/capmonster-python-captcha-solver
|
|
6
6
|
Author: CapMonster Cloud
|
|
@@ -78,13 +78,13 @@ Dynamic: requires-dist
|
|
|
78
78
|
Dynamic: requires-python
|
|
79
79
|
Dynamic: summary
|
|
80
80
|
|
|
81
|
-
# CapMonster Cloud Python SDK:
|
|
81
|
+
# CapMonster Cloud Python SDK: Python Captcha Solver & Captcha Bypass for reCAPTCHA, Cloudflare Turnstile and GeeTest
|
|
82
82
|
|
|
83
|
-
> **🔄 Migrating from 2Captcha or Capsolver?** CapMonster Cloud is a fast, cost-effective **2captcha alternative** and **capsolver alternative
|
|
83
|
+
> **🔄 Migrating from 2Captcha or Capsolver?** CapMonster Cloud is a fast, cost-effective **2captcha alternative** and **capsolver alternative** for Python: reCAPTCHA v3 from **$0.90 per 1,000 solves**, which is **up to 38% cheaper than 2Captcha** and **10% cheaper than Capsolver**, with an API response time of **≤ 2 s**. Already have software built for 2Captcha? CapMonster Cloud [supports the 2Captcha API format](https://docs.capmonster.cloud/docs/external-services/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme). Moving your Python code takes just a few lines: see the **Migration examples** below. Full comparison and disclaimer are in the comparison section below.
|
|
84
84
|
|
|
85
85
|
<p align="center">
|
|
86
86
|
<a href="https://capmonster.cloud/en/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme">
|
|
87
|
-
<img src="https://img.shields.io/badge/CapMonster%20Cloud-Python%20Captcha%20Solver-00B2FF?style=for-the-badge&logo=python&logoColor=white" alt="CapMonster Cloud Python SDK" height="40">
|
|
87
|
+
<img src="https://img.shields.io/badge/CapMonster%20Cloud-Python%20Captcha%20Solver-00B2FF?style=for-the-badge&logo=python&logoColor=white" alt="CapMonster Cloud Python SDK - captcha solver and captcha bypass API client" height="40">
|
|
88
88
|
</a>
|
|
89
89
|
</p>
|
|
90
90
|
|
|
@@ -110,21 +110,22 @@ The CapMonster Cloud Python SDK (`capmonstercloudclient`, also known as the CapM
|
|
|
110
110
|
|
|
111
111
|
---
|
|
112
112
|
|
|
113
|
-
## ⚡ Highlights
|
|
113
|
+
## ⚡ Highlights
|
|
114
114
|
|
|
115
|
-
- ⚡ **Fast
|
|
116
|
-
- 🤖 **Zero
|
|
115
|
+
- ⚡ **Fast solving:** AI-based recognition, on average between 1 and 30 seconds depending on the captcha type.
|
|
116
|
+
- 🤖 **Zero human workers:** 100% automated machine learning pipeline with no manual latencies.
|
|
117
|
+
- 🛡️ **Modern anti-bot bypass:** Full support for Cloudflare Turnstile, reCAPTCHA Enterprise, GeeTest, DataDome, and Amazon WAF.
|
|
117
118
|
- 🌐 **Browser Automation Ready:** Works out-of-the-box with **Playwright, Selenium, and Puppeteer**.
|
|
118
|
-
-
|
|
119
|
-
-
|
|
120
|
-
-
|
|
121
|
-
-
|
|
119
|
+
- 💰 **Cost-effective:** Low-cost pricing structure based on pay-as-you-go balance.
|
|
120
|
+
- 📉 **Cheaper than alternatives:** reCAPTCHA v3 from $0.90 per 1,000 solves, versus $1.45 at 2Captcha and $1.00 at Capsolver.
|
|
121
|
+
- 🔄 **Easy migration:** replace your 2Captcha or Capsolver solver call and keep the rest of your scraper or bot unchanged.
|
|
122
|
+
- 📖 **Official docs:** request types follow the [CapMonster Cloud API documentation](https://docs.capmonster.cloud/docs/captchas/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
|
|
122
123
|
|
|
123
124
|
---
|
|
124
125
|
|
|
125
126
|
## 📊 CapMonster Cloud vs 2Captcha vs Capsolver
|
|
126
127
|
|
|
127
|
-
Looking for a 2captcha alternative or a capsolver alternative for web scraping and automation? Compare price, speed and success rate.
|
|
128
|
+
Looking for a 2captcha alternative or a capsolver alternative for Python web scraping and automation? Compare price, speed and success rate.
|
|
128
129
|
|
|
129
130
|
### reCAPTCHA v3
|
|
130
131
|
|
|
@@ -161,7 +162,7 @@ pip install capmonstercloudclient
|
|
|
161
162
|
|
|
162
163
|
---
|
|
163
164
|
|
|
164
|
-
## 🚀 Quick Start
|
|
165
|
+
## 🚀 Quick Start: Solve and Bypass Captchas in Python
|
|
165
166
|
|
|
166
167
|
### 1. Asynchronous reCAPTCHA v2 Solving
|
|
167
168
|
|
|
@@ -177,10 +178,10 @@ client = CapMonsterClient(options=options)
|
|
|
177
178
|
async def main():
|
|
178
179
|
# Build the task payload
|
|
179
180
|
request = RecaptchaV2Request(
|
|
180
|
-
websiteUrl="
|
|
181
|
+
websiteUrl="https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high",
|
|
181
182
|
websiteKey="6Lcg7CMUAAAAANphynKgn9YAgA4tQ2KI_iqRyTwd"
|
|
182
183
|
)
|
|
183
|
-
|
|
184
|
+
|
|
184
185
|
# Send task and receive token
|
|
185
186
|
result = await client.solve_captcha(request)
|
|
186
187
|
print("reCAPTCHA Token:", result.get("gRecaptchaResponse"))
|
|
@@ -203,7 +204,7 @@ client = CapMonsterClient(options=options)
|
|
|
203
204
|
async def run_scraper():
|
|
204
205
|
# Solve Turnstile challenge via CapMonster Cloud
|
|
205
206
|
turnstile_req = TurnstileRequest(
|
|
206
|
-
websiteURL="
|
|
207
|
+
websiteURL="https://target-website.com/login",
|
|
207
208
|
websiteKey="0x4AAAAAAABnPIDnK2k_e-2"
|
|
208
209
|
)
|
|
209
210
|
solution = await client.solve_captcha(turnstile_req)
|
|
@@ -213,8 +214,8 @@ async def run_scraper():
|
|
|
213
214
|
async with async_playwright() as p:
|
|
214
215
|
browser = await p.chromium.launch(headless=False)
|
|
215
216
|
page = await browser.new_page()
|
|
216
|
-
await page.goto("
|
|
217
|
-
|
|
217
|
+
await page.goto("https://target-website.com/login")
|
|
218
|
+
|
|
218
219
|
await page.evaluate(f'document.querySelector("[name=cf-turnstile-response]").value = "{token}";')
|
|
219
220
|
await page.click("#submit-button")
|
|
220
221
|
await browser.close()
|
|
@@ -227,9 +228,9 @@ if __name__ == "__main__":
|
|
|
227
228
|
|
|
228
229
|
## 🔄 Migrating from 2Captcha or Capsolver
|
|
229
230
|
|
|
230
|
-
Already use 2Captcha or Capsolver in your scraper or bot? Replace only the solver call and keep the rest of your parser unchanged. CapMonster Cloud follows the same flow: send the website URL and sitekey, receive the token.
|
|
231
|
+
Already use 2Captcha or Capsolver in your Python scraper or bot? Replace only the solver call and keep the rest of your parser unchanged. CapMonster Cloud follows the same flow: send the website URL and sitekey, receive the token.
|
|
231
232
|
|
|
232
|
-
###
|
|
233
|
+
### Before: 2Captcha (2captcha-python)
|
|
233
234
|
|
|
234
235
|
```python
|
|
235
236
|
# Before: 2Captcha
|
|
@@ -238,11 +239,28 @@ from twocaptcha import TwoCaptcha
|
|
|
238
239
|
solver = TwoCaptcha("YOUR_2CAPTCHA_API_KEY")
|
|
239
240
|
result = solver.recaptcha(
|
|
240
241
|
sitekey="YOUR_SITE_KEY",
|
|
241
|
-
url="
|
|
242
|
+
url="https://target-website.com/page-with-recaptcha",
|
|
242
243
|
)
|
|
243
244
|
token = result["code"]
|
|
244
245
|
```
|
|
245
246
|
|
|
247
|
+
### Before: Capsolver (capsolver-python)
|
|
248
|
+
|
|
249
|
+
```python
|
|
250
|
+
# Before: Capsolver
|
|
251
|
+
import capsolver
|
|
252
|
+
|
|
253
|
+
capsolver.api_key = "YOUR_CAPSOLVER_API_KEY"
|
|
254
|
+
solution = capsolver.solve({
|
|
255
|
+
"type": "ReCaptchaV2TaskProxyLess",
|
|
256
|
+
"websiteURL": "https://target-website.com/page-with-recaptcha",
|
|
257
|
+
"websiteKey": "YOUR_SITE_KEY",
|
|
258
|
+
})
|
|
259
|
+
token = solution["gRecaptchaResponse"]
|
|
260
|
+
```
|
|
261
|
+
|
|
262
|
+
### After: CapMonster Cloud
|
|
263
|
+
|
|
246
264
|
```python
|
|
247
265
|
# After: CapMonster Cloud
|
|
248
266
|
import asyncio
|
|
@@ -253,7 +271,7 @@ client = CapMonsterClient(options=ClientOptions(api_key="YOUR_CAPMONSTER_API_KEY
|
|
|
253
271
|
|
|
254
272
|
async def solve():
|
|
255
273
|
result = await client.solve_captcha(RecaptchaV2Request(
|
|
256
|
-
websiteUrl="
|
|
274
|
+
websiteUrl="https://target-website.com/page-with-recaptcha",
|
|
257
275
|
websiteKey="YOUR_SITE_KEY",
|
|
258
276
|
))
|
|
259
277
|
return result.get("gRecaptchaResponse")
|
|
@@ -261,22 +279,7 @@ async def solve():
|
|
|
261
279
|
token = asyncio.run(solve())
|
|
262
280
|
```
|
|
263
281
|
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
```python
|
|
267
|
-
# Before: Capsolver
|
|
268
|
-
import capsolver
|
|
269
|
-
|
|
270
|
-
capsolver.api_key = "YOUR_CAPSOLVER_API_KEY"
|
|
271
|
-
solution = capsolver.solve({
|
|
272
|
-
"type": "ReCaptchaV2TaskProxyLess",
|
|
273
|
-
"websiteURL": "[https://target-website.com/page-with-recaptcha](https://target-website.com/page-with-recaptcha)",
|
|
274
|
-
"websiteKey": "YOUR_SITE_KEY",
|
|
275
|
-
})
|
|
276
|
-
token = solution["gRecaptchaResponse"]
|
|
277
|
-
```
|
|
278
|
-
|
|
279
|
-
The "After" code is the same CapMonster Cloud snippet as above: only the client, the API key and the request class change, the rest of your scraper stays the same. If you use an async framework, call `await client.solve_captcha(...)` directly instead of `asyncio.run`.
|
|
282
|
+
Only the client, the API key and the request class change: the token is used exactly as before, so the rest of your scraper stays the same. If you use an async framework, call `await client.solve_captcha(...)` directly instead of `asyncio.run`.
|
|
280
283
|
|
|
281
284
|
### Keep existing 2Captcha-based software
|
|
282
285
|
|
|
@@ -284,11 +287,11 @@ Software that already speaks the 2Captcha API can work with CapMonster Cloud wit
|
|
|
284
287
|
|
|
285
288
|
---
|
|
286
289
|
|
|
287
|
-
## 🛡️ Supported CAPTCHA Types: reCAPTCHA, Cloudflare Turnstile,
|
|
290
|
+
## 🛡️ Supported CAPTCHA Types: Bypass reCAPTCHA, Cloudflare Turnstile, GeeTest and More
|
|
288
291
|
|
|
289
292
|
Use this Python captcha solver for captcha bypass in web scraping and automation: reCAPTCHA bypass (v2, v3, Enterprise), Cloudflare Turnstile solver, DataDome solver, GeeTest solver, Amazon WAF bypass and image-to-text recognition.
|
|
290
293
|
|
|
291
|
-
All task types
|
|
294
|
+
All task types follow the official [CapMonster Cloud API documentation](https://docs.capmonster.cloud/docs/captchas/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme):
|
|
292
295
|
|
|
293
296
|
| Protection Type | Task Request Class | Proxyless Mode |
|
|
294
297
|
| :--- | :--- | :---: |
|
|
@@ -315,10 +318,10 @@ All task types conform to the official [CapMonster Cloud API Documentation](http
|
|
|
315
318
|
[ Extract sitekey & website URL ]
|
|
316
319
|
│
|
|
317
320
|
▼
|
|
318
|
-
[ CapMonsterClient API ] ──► POST createTask to
|
|
321
|
+
[ CapMonsterClient API ] ──► POST createTask to https://api.capmonster.cloud
|
|
319
322
|
│
|
|
320
323
|
▼
|
|
321
|
-
[ Neural Network Processing ] ──► Poll getTaskResult
|
|
324
|
+
[ Neural Network Processing ] ──► Poll getTaskResult until the task is ready
|
|
322
325
|
│
|
|
323
326
|
▼
|
|
324
327
|
[ Receive Token & Autosubmit ] ──► Complete bypass
|
|
@@ -328,46 +331,87 @@ All task types conform to the official [CapMonster Cloud API Documentation](http
|
|
|
328
331
|
|
|
329
332
|
## ⚙️ Best Practices
|
|
330
333
|
|
|
331
|
-
- **
|
|
332
|
-
- **
|
|
333
|
-
- **
|
|
334
|
+
- **Use tokens promptly:** CAPTCHA tokens expire quickly (a reCAPTCHA v2 token is valid for 60 seconds after solving), so submit or inject the solution immediately after receiving the response.
|
|
335
|
+
- **Keep session context consistent:** When a task uses a proxy, use the same proxy in your scraping or browser session and in the CapMonster task.
|
|
336
|
+
- **Use the right task type:** Choose the request type that matches the target protection and follow the required parameters in the [documentation](https://docs.capmonster.cloud/docs/captchas/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
|
|
337
|
+
- **Monitor your balance:** Keep your account balance positive in the [Dashboard](https://dash.capmonster.cloud/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme) and handle API errors in your code.
|
|
338
|
+
|
|
339
|
+
---
|
|
340
|
+
|
|
341
|
+
## 💡 Use Cases
|
|
342
|
+
|
|
343
|
+
- **Web scraping and data collection** from websites you are authorized to access, without manual captcha solving.
|
|
344
|
+
- **Browser automation:** get the solution token in Python and inject it into the page with your automation tool.
|
|
345
|
+
- **Automated testing (QA)** of your own website and its captcha-protected forms.
|
|
346
|
+
- **Backend services** that need a captcha solving API inside a Python application.
|
|
334
347
|
|
|
335
348
|
---
|
|
336
349
|
|
|
337
350
|
## ❓ FAQ
|
|
338
351
|
|
|
339
|
-
**Is CapMonster Cloud a 2Captcha alternative?**
|
|
352
|
+
**Is CapMonster Cloud a 2Captcha alternative for Python?**
|
|
340
353
|
Yes. It is a captcha solving service with an official Python SDK. For reCAPTCHA v3 it starts at $0.90 per 1,000 solves versus $1.45 at 2Captcha, which is up to 38% cheaper. For Cloudflare Turnstile it starts at $1.30 versus $1.45, which is 10% cheaper.
|
|
341
354
|
|
|
342
|
-
**Is CapMonster Cloud a Capsolver alternative?**
|
|
355
|
+
**Is CapMonster Cloud a Capsolver alternative for Python?**
|
|
343
356
|
Yes. For reCAPTCHA v3 it is 10% cheaper than Capsolver ($0.90 versus $1.00 per 1,000 solves) and shows an API response time of ≤ 2 s versus < 3 s. See the comparison table above and its disclaimer.
|
|
344
357
|
|
|
345
358
|
**How do I migrate from 2Captcha or Capsolver to CapMonster Cloud in Python?**
|
|
346
359
|
Install `capmonstercloudclient`, create a `CapMonsterClient` with your API key and replace your solver call with `client.solve_captcha(...)`. See the migration examples above. Software that already supports the 2Captcha API can also be connected through the [CapMonster Cloud guide](https://docs.capmonster.cloud/docs/external-services/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
|
|
347
360
|
|
|
348
|
-
**
|
|
349
|
-
|
|
361
|
+
**Is there an official Python captcha solver from CapMonster Cloud?**
|
|
362
|
+
Yes. This repository is the official Python client library for the CapMonster Cloud captcha solving service.
|
|
350
363
|
|
|
351
|
-
**
|
|
352
|
-
|
|
364
|
+
**How do I bypass reCAPTCHA v2 in Python?**
|
|
365
|
+
Create a `CapMonsterClient` with your API key, pass a `RecaptchaV2Request` with the page URL and sitekey to `client.solve_captcha()` and read `result.get("gRecaptchaResponse")`. See the [reCAPTCHA v2 documentation](https://docs.capmonster.cloud/docs/captchas/no-captcha-task/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
|
|
366
|
+
|
|
367
|
+
**How do I bypass Cloudflare Turnstile in Python?**
|
|
368
|
+
Use `TurnstileRequest` with the page URL and sitekey, as in example 2 above, and read `solution.get("token")`. According to the [Turnstile documentation](https://docs.capmonster.cloud/docs/captchas/turnstile-task/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme), all Turnstile subtypes are supported automatically: manual, non-interactive and invisible.
|
|
369
|
+
|
|
370
|
+
**Which captcha types does the Python SDK solve?**
|
|
371
|
+
reCAPTCHA v2, v3 and Enterprise, Cloudflare Turnstile, GeeTest, Amazon WAF, DataDome, Imperva / Incapsula, Binance CAPTCHA, standard text (image-to-text) captchas and reCAPTCHA image tasks. See the supported types table above and the [Supported Captchas Overview](https://docs.capmonster.cloud/docs/captchas/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
|
|
353
372
|
|
|
354
373
|
**How do I get an API key?**
|
|
355
374
|
Register on CapMonster Cloud, top up your balance and copy your API key. The [Getting Started Guide](https://docs.capmonster.cloud/docs/getting-start/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme) describes each step.
|
|
356
375
|
|
|
376
|
+
**Which Python versions are supported?**
|
|
377
|
+
The package on PyPI requires Python 3.6 or newer.
|
|
378
|
+
|
|
379
|
+
**How fast are captchas solved?**
|
|
380
|
+
On average between 1 and 30 seconds, depending on the captcha type. More details are in the [CapMonster Cloud FAQ](https://docs.capmonster.cloud/docs/faq/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
|
|
381
|
+
|
|
382
|
+
**How long is a reCAPTCHA v2 solution valid?**
|
|
383
|
+
According to the [reCAPTCHA v2 documentation](https://docs.capmonster.cloud/docs/captchas/no-captcha-task/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme), the returned token is valid for 60 seconds after the captcha is solved, so use it right away.
|
|
384
|
+
|
|
385
|
+
**Where is the full API reference?**
|
|
386
|
+
See the [API Methods Reference](https://docs.capmonster.cloud/docs/methods/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
|
|
387
|
+
|
|
357
388
|
---
|
|
358
389
|
|
|
359
|
-
##
|
|
390
|
+
## ⚖️ Responsible Use
|
|
391
|
+
|
|
392
|
+
CapMonster Cloud is intended for legitimate business purposes only, such as testing your own website or a website you are authorized to test, and recognizing images you provide. Read more about [ethical and transparent captcha automation](https://capmonster.cloud/en/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
|
|
393
|
+
|
|
394
|
+
---
|
|
395
|
+
|
|
396
|
+
## 📚 Documentation & Support
|
|
360
397
|
|
|
361
398
|
- 📖 [Getting Started Guide](https://docs.capmonster.cloud/docs/getting-start/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme)
|
|
362
399
|
- 🎯 [Supported Captchas Overview](https://docs.capmonster.cloud/docs/captchas/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme)
|
|
363
400
|
- ⚙️ [API Methods Reference](https://docs.capmonster.cloud/docs/methods/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme)
|
|
401
|
+
- ❓ [CapMonster Cloud FAQ](https://docs.capmonster.cloud/docs/faq/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme)
|
|
402
|
+
- 🌐 [Browser Extension Guides](https://docs.capmonster.cloud/docs/extension/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme)
|
|
364
403
|
- 💬 [Support & Community](https://capmonster.cloud/en/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme#support)
|
|
365
404
|
|
|
366
|
-
## Other official SDKs
|
|
405
|
+
## Other official SDKs & integrations
|
|
367
406
|
|
|
368
|
-
- [.NET](https://github.com/CapMonsterCloud/capmonster-dotnet-captcha-solver)
|
|
369
407
|
- [Node.js](https://github.com/CapMonsterCloud/capmonster-nodejs-captcha-solver)
|
|
408
|
+
- [.NET](https://github.com/CapMonsterCloud/capmonster-dotnet-captcha-solver)
|
|
409
|
+
- [Go](https://github.com/CapMonsterCloud/capmonster-go-captcha-solver)
|
|
410
|
+
- [PHP](https://github.com/CapMonsterCloud/capmonster-php-captcha-solver)
|
|
411
|
+
- [Rust](https://github.com/CapMonsterCloud/capmonster-rust-captcha-solver)
|
|
370
412
|
- [n8n](https://github.com/CapMonsterCloud/capmonster-n8n-captcha-solver)
|
|
413
|
+
- [MCP server](https://github.com/CapMonsterCloud/capmonster-mcp-captcha-solver)
|
|
414
|
+
- [MCP server for Patchright](https://github.com/CapMonsterCloud/capmonster-mcp-patchright-captcha-solver)
|
|
371
415
|
- [API Docs](https://github.com/CapMonsterCloud/capmonster-captcha-solver-docs)
|
|
372
416
|
|
|
373
417
|
---
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
4.3.2
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/__init__.py
RENAMED
|
File without changes
|
{capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/captchaResult.py
RENAMED
|
File without changes
|
{capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/clientOptions.py
RENAMED
|
File without changes
|
{capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/exceptions.py
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.4}/capmonstercloud_client/requests/enums.py
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|