{"id":21020,"library":"capsolver","title":"capsolver-python","description":"Official Python SDK for Capsolver, a service for solving CAPTCHAs (ReCaptcha, hCaptcha, Geetest, etc.) automatically. Current version 1.0.7, requires Python >=3.6.8, maintained by Capsolver team.","status":"active","version":"1.0.7","language":"python","source_language":"en","source_url":"https://github.com/capsolver/capsolver-python","tags":["captcha","recaptcha","hcaptcha","automation"],"install":[{"cmd":"pip install capsolver","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"HTTP client for API calls","package":"requests","optional":false}],"imports":[{"note":"Main client class for all CAPTCHA solving.","symbol":"CapSolver","correct":"from capsolver import CapSolver"}],"quickstart":{"code":"from capsolver import CapSolver\nimport os\n\napi_key = os.environ.get('CAPSOLVER_API_KEY', 'YOUR_API_KEY')\nsolver = CapSolver(api_key=api_key)\n\n# Solve ReCaptcha v2\nresult = solver.solve(\n    type=\"ReCaptchaV2TaskProxyless\",\n    websiteURL=\"https://example.com\",\n    websiteKey=\"6Lc...\"\n)\nprint(result)\n","lang":"python","description":"Instantiate CapSolver with your API key and solve a ReCaptcha v2 (proxyless)."},"warnings":[{"fix":"Always handle capsolver.exceptions.CapSolverError in your code.","message":"API keys are required for all requests. The library does not validate the key until the first API call, so catch exceptions.","severity":"gotcha","affected_versions":"all"},{"fix":"Change 'from capsolver.capsolver import CapSolver' to 'from capsolver import CapSolver'.","message":"The 'capsolver.capsolver' module is deprecated. Use the top-level 'capsolver' package directly.","severity":"deprecated","affected_versions":"<=1.0.6"},{"fix":"Refer to Capsolver API docs for exact task type strings.","message":"Task names are case-sensitive and version-specific. Mistyping a task type (e.g., 'ReCaptchaV2Task' vs 'ReCaptchaV2TaskProxyless') will raise an API error.","severity":"gotcha","affected_versions":"all"},{"fix":"Use 'CapSolver(api_key=...)' with explicit keyword.","message":"In v1.0.0, the constructor changed from 'capsolver(api_key)' to 'CapSolver(api_key=api_key)', with keyword argument enforcement.","severity":"breaking","affected_versions":"<1.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Upgrade capsolver: pip install -U capsolver","cause":"Older version (<1.0.0) did not export CapSolver at top level.","error":"ImportError: cannot import name 'CapSolver' from 'capsolver'"},{"fix":"Verify your API key and set it via CAPSOLVER_API_KEY environment variable or pass it explicitly.","cause":"Invalid or missing API key.","error":"capsolver.exceptions.CapSolverError: ERROR_KEY_DOES_NOT_EXIST"},{"fix":"Check Capsolver documentation for correct task type (e.g., ReCaptchaV2TaskProxyless).","cause":"Task type string is incorrect or not supported by your plan.","error":"capsolver.exceptions.CapSolverError: ERROR_TASK_NOT_SUPPORTED"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}