capmonstercloudclient 4.3.2__tar.gz → 4.3.3__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.
Files changed (59) hide show
  1. {capmonstercloudclient-4.3.2/capmonstercloudclient.egg-info → capmonstercloudclient-4.3.3}/PKG-INFO +98 -54
  2. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/README.md +97 -53
  3. capmonstercloudclient-4.3.3/capmonstercloud_client/version.txt +1 -0
  4. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3/capmonstercloudclient.egg-info}/PKG-INFO +98 -54
  5. capmonstercloudclient-4.3.2/capmonstercloud_client/version.txt +0 -1
  6. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/LICENSE +0 -0
  7. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/MANIFEST.in +0 -0
  8. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/CapMonsterCloudClient.py +0 -0
  9. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/GetResultTimeouts.py +0 -0
  10. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/__init__.py +0 -0
  11. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/captchaResult.py +0 -0
  12. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/clientOptions.py +0 -0
  13. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/exceptions.py +0 -0
  14. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requestController.py +0 -0
  15. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/AlibabaCustomTaskRequest.py +0 -0
  16. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/AltchaCustomTaskRequest.py +0 -0
  17. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/AmazonWafRequest.py +0 -0
  18. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/BasiliskCustomTaskRequest.py +0 -0
  19. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/BinanceTaskRequest.py +0 -0
  20. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/CastleCustomTaskRequest.py +0 -0
  21. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/ComplexImageTaskBase.py +0 -0
  22. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/CustomTaskRequestBase.py +0 -0
  23. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/DataDomeCustomTaskRequest.py +0 -0
  24. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/FriendlyCustomTaskRequest.py +0 -0
  25. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/FuncaptchaComplexImageTask.py +0 -0
  26. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/FuncaptchaRequest.py +0 -0
  27. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/GeetestRequest.py +0 -0
  28. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/HcaptchaComplexImageTask.py +0 -0
  29. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/HcaptchaRequest.py +0 -0
  30. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/HuntCustomTaskRequest.py +0 -0
  31. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/ImageToTextRequest.py +0 -0
  32. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/ImpervaCustomTaskRequest.py +0 -0
  33. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/MTCaptchaRequest.py +0 -0
  34. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/ProsopoTaskRequest.py +0 -0
  35. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/RecaptchaComplexImageTask.py +0 -0
  36. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/RecaptchaV2EnterpiseRequest.py +0 -0
  37. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/RecaptchaV2Request.py +0 -0
  38. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/RecaptchaV3EnterpriseRequest.py +0 -0
  39. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/RecaptchaV3ProxylessRequest.py +0 -0
  40. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/RecognitionComplexImageTaskRequest.py +0 -0
  41. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/TemuCustomTaskRequest.py +0 -0
  42. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/TenDiCustomTaskRequest.py +0 -0
  43. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/TspdCustomTaskRequest.py +0 -0
  44. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/TurnstileRequest.py +0 -0
  45. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/YidunRequest.py +0 -0
  46. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/__init__.py +0 -0
  47. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/baseRequest.py +0 -0
  48. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/baseRequestWithProxy.py +0 -0
  49. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/enums.py +0 -0
  50. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/requests/proxy_info.py +0 -0
  51. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloud_client/utils.py +0 -0
  52. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloudclient.egg-info/SOURCES.txt +0 -0
  53. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloudclient.egg-info/dependency_links.txt +0 -0
  54. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloudclient.egg-info/requires.txt +0 -0
  55. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/capmonstercloudclient.egg-info/top_level.txt +0 -0
  56. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/pyproject.toml +0 -0
  57. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/requirements.txt +0 -0
  58. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/setup.cfg +0 -0
  59. {capmonstercloudclient-4.3.2 → capmonstercloudclient-4.3.3}/setup.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: capmonstercloudclient
3
- Version: 4.3.2
3
+ Version: 4.3.3
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: AI Captcha Solver & Captcha Bypass
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**: 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.
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 & Benchmarks
113
+ ## ⚡ Highlights
114
114
 
115
- - ⚡ **Fast Solving:** Automated AI models solve captchas in 300 ms to 6 seconds depending on the system load.
116
- - 🤖 **Zero Human Workers:** 100% automated machine learning pipeline with no manual latencies.
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
- - 🛡️ **Modern Anti-Bot Bypass:** Full support for Cloudflare Turnstile, reCAPTCHA Enterprise, GeeTest, and Amazon WAF.
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.
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 & Usage Examples
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="[https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high](https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high)",
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="[https://target-website.com/login](https://target-website.com/login)",
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("[https://target-website.com/login](https://target-website.com/login)")
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
- ### Migration from 2Captcha (2captcha-python)
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="[https://target-website.com/page-with-recaptcha](https://target-website.com/page-with-recaptcha)",
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="[https://target-website.com/page-with-recaptcha](https://target-website.com/page-with-recaptcha)",
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
- ### Migration from Capsolver (capsolver-python)
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, DataDome, GeeTest & More
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 conform to the official [CapMonster Cloud API Documentation](https://docs.capmonster.cloud/docs/captchas/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme):
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 [https://api.capmonster.cloud](https://api.capmonster.cloud)
321
+ [ CapMonsterClient API ] ──► POST createTask to https://api.capmonster.cloud
319
322
  │
320
323
  ▼
321
- [ Neural Network Processing ] ──► Poll getTaskResult (300ms - 6s)
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
- - **Token Expiration:** Most tokens (reCAPTCHA, Turnstile) remain valid for 120 seconds. Inject and submit the solution immediately after receiving the response.
332
- - **Proxy Usage:** For custom tasks and strict protections, use the same proxy in your scraping session and the CapMonster task payload.
333
- - **Balance Monitoring:** Ensure your account balance remains positive in the [Dashboard](https://dash.capmonster.cloud/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
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
- **Which captchas can the Python SDK bypass?**
349
- 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.
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
- **Which Python versions are supported?**
352
- The package on PyPI requires Python 3.6 or newer.
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
- ## 📚 Official Documentation & Links
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: AI Captcha Solver & Captcha Bypass
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**: 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.
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 & Benchmarks
33
+ ## ⚡ Highlights
34
34
 
35
- - ⚡ **Fast Solving:** Automated AI models solve captchas in 300 ms to 6 seconds depending on the system load.
36
- - 🤖 **Zero Human Workers:** 100% automated machine learning pipeline with no manual latencies.
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
- - 🛡️ **Modern Anti-Bot Bypass:** Full support for Cloudflare Turnstile, reCAPTCHA Enterprise, GeeTest, and Amazon WAF.
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.
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 & Usage Examples
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="[https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high](https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high)",
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="[https://target-website.com/login](https://target-website.com/login)",
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("[https://target-website.com/login](https://target-website.com/login)")
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
- ### Migration from 2Captcha (2captcha-python)
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="[https://target-website.com/page-with-recaptcha](https://target-website.com/page-with-recaptcha)",
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="[https://target-website.com/page-with-recaptcha](https://target-website.com/page-with-recaptcha)",
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
- ### Migration from Capsolver (capsolver-python)
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, DataDome, GeeTest & More
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 conform to the official [CapMonster Cloud API Documentation](https://docs.capmonster.cloud/docs/captchas/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme):
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 [https://api.capmonster.cloud](https://api.capmonster.cloud)
241
+ [ CapMonsterClient API ] ──► POST createTask to https://api.capmonster.cloud
239
242
  │
240
243
  ▼
241
- [ Neural Network Processing ] ──► Poll getTaskResult (300ms - 6s)
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
- - **Token Expiration:** Most tokens (reCAPTCHA, Turnstile) remain valid for 120 seconds. Inject and submit the solution immediately after receiving the response.
252
- - **Proxy Usage:** For custom tasks and strict protections, use the same proxy in your scraping session and the CapMonster task payload.
253
- - **Balance Monitoring:** Ensure your account balance remains positive in the [Dashboard](https://dash.capmonster.cloud/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
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
- **Which captchas can the Python SDK bypass?**
269
- 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.
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
- **Which Python versions are supported?**
272
- The package on PyPI requires Python 3.6 or newer.
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
- ## 📚 Official Documentation & Links
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,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: capmonstercloudclient
3
- Version: 4.3.2
3
+ Version: 4.3.3
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: AI Captcha Solver & Captcha Bypass
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**: 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.
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 & Benchmarks
113
+ ## ⚡ Highlights
114
114
 
115
- - ⚡ **Fast Solving:** Automated AI models solve captchas in 300 ms to 6 seconds depending on the system load.
116
- - 🤖 **Zero Human Workers:** 100% automated machine learning pipeline with no manual latencies.
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
- - 🛡️ **Modern Anti-Bot Bypass:** Full support for Cloudflare Turnstile, reCAPTCHA Enterprise, GeeTest, and Amazon WAF.
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.
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 & Usage Examples
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="[https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high](https://lessons.zennolab.com/captchas/recaptcha/v2_simple.php?level=high)",
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="[https://target-website.com/login](https://target-website.com/login)",
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("[https://target-website.com/login](https://target-website.com/login)")
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
- ### Migration from 2Captcha (2captcha-python)
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="[https://target-website.com/page-with-recaptcha](https://target-website.com/page-with-recaptcha)",
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="[https://target-website.com/page-with-recaptcha](https://target-website.com/page-with-recaptcha)",
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
- ### Migration from Capsolver (capsolver-python)
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, DataDome, GeeTest & More
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 conform to the official [CapMonster Cloud API Documentation](https://docs.capmonster.cloud/docs/captchas/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme):
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 [https://api.capmonster.cloud](https://api.capmonster.cloud)
321
+ [ CapMonsterClient API ] ──► POST createTask to https://api.capmonster.cloud
319
322
  │
320
323
  ▼
321
- [ Neural Network Processing ] ──► Poll getTaskResult (300ms - 6s)
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
- - **Token Expiration:** Most tokens (reCAPTCHA, Turnstile) remain valid for 120 seconds. Inject and submit the solution immediately after receiving the response.
332
- - **Proxy Usage:** For custom tasks and strict protections, use the same proxy in your scraping session and the CapMonster task payload.
333
- - **Balance Monitoring:** Ensure your account balance remains positive in the [Dashboard](https://dash.capmonster.cloud/?utm_source=github&utm_medium=referral&utm_campaign=python_repo_readme).
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
- **Which captchas can the Python SDK bypass?**
349
- 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.
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
- **Which Python versions are supported?**
352
- The package on PyPI requires Python 3.6 or newer.
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
- ## 📚 Official Documentation & Links
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
  ---