{"id":13590840,"url":"https://github.com/Matthew17-21/Captcha-Tools","last_synced_at":"2025-04-08T14:31:58.076Z","repository":{"id":38349119,"uuid":"360216194","full_name":"Matthew17-21/Captcha-Tools","owner":"Matthew17-21","description":"All-in-one Python (And now Go!) module to help solve captchas with Capmonster, 2captcha, Anticaptcha, and Capsolver API's!","archived":false,"fork":false,"pushed_at":"2023-11-28T02:27:13.000Z","size":147,"stargazers_count":56,"open_issues_count":2,"forks_count":5,"subscribers_count":0,"default_branch":"main","last_synced_at":"2024-03-14T15:11:04.880Z","etag":null,"topics":["2captcha","2captcha-api","anticaptcha","anticaptcha-client","capsolver","capsolvercom","captcha","hcaptcha","recaptcha","scraper","scraping","scraping-api","sneakerbot","sneakerbots","sneakers"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Matthew17-21.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2021-04-21T15:19:13.000Z","updated_at":"2024-02-09T11:47:24.000Z","dependencies_parsed_at":"2024-01-14T04:35:29.100Z","dependency_job_id":"204ac7ac-d97a-4c63-83ca-52f44438135a","html_url":"https://github.com/Matthew17-21/Captcha-Tools","commit_stats":{"total_commits":77,"total_committers":3,"mean_commits":"25.666666666666668","dds":"0.025974025974025983","last_synced_commit":"a1ccd5a70d974e90329ed029e40917bc9f07713a"},"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Matthew17-21%2FCaptcha-Tools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Matthew17-21%2FCaptcha-Tools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Matthew17-21%2FCaptcha-Tools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Matthew17-21%2FCaptcha-Tools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Matthew17-21","download_url":"https://codeload.github.com/Matthew17-21/Captcha-Tools/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223329804,"owners_count":17127658,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["2captcha","2captcha-api","anticaptcha","anticaptcha-client","capsolver","capsolvercom","captcha","hcaptcha","recaptcha","scraper","scraping","scraping-api","sneakerbot","sneakerbots","sneakers"],"created_at":"2024-08-01T16:00:50.964Z","updated_at":"2024-11-06T11:31:06.885Z","avatar_url":"https://github.com/Matthew17-21.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# Captcha Tools\nPython module to help solve captchas with Capmonster, 2Captcha and Anticaptcha API's!\n\n#### Go(lang)\nTo see documentation for the Go implementation, [click here](https://github.com/Matthew17-21/Captcha-Tools/tree/main/captchatools-go)\n\n# Install\n```python\npip3 install captchatools\n```\n##### To update\n```python\npip3 install -U captchatools\n```\n# How to use\n### Basic usage\n```python\nimport captchatools\nsolver = captchatools.new_harvester(solving_site=\"capmonster\", api_key=\"YOUR API KEY\", sitekey=\"6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-\", captcha_url=\"https://www.google.com/recaptcha/api2/demo\")\ncaptcha_answer = solver.get_token()\n```\nor\n```python\nfrom captchatools import new_harvester\nsolver = new_harvester(solving_site=1, api_key=\"YOUR API KEY\", sitekey=\"6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-\", captcha_url=\"https://www.google.com/recaptcha/api2/demo\")\ncaptcha_answer = solver.get_token()\n```\n### new_harvester() Parameters:\n| Parameter | Required |  Type  | Default | Description|\n| :-------------: |:-------------:| :-----:| :-----:| :-----:|\n| api_key | true | String| -| The API Key for the captcha solving site|\n| solving_site| true| String (name of site) or int (site ID) | \"capmonster\"| The captcha solving site that will be used. Refer to [the site IDs](https://github.com/Matthew17-21/Captcha-Tools/tree/main/captchatools-go#site-specific-support)|\n| sitekey| true | String | - | Sitekey from the site where captcha is loaded|\n| captcha_url | true| String | - | URL where the captcha is located|\n| captcha_type| false| String | \"v2\" | Type of captcha you are solving. Either captcha `image`, `v2`, `v3`,`hcaptcha` (`hcap` works aswell) or `hcaptchaturbo`|\n| invisible_captcha| false | bool | false | If the captcha is invisible or not.\u003cbr /\u003e__This param is only required when solving invisible captchas__|\n| min_score | false | double |0.7 | Minimum score for v3 captchas.\u003cbr /\u003e__This param is only required when solving V3 and it needs a higher / lower score__|\n| action | false | String | \"verify\" | Action that is associated with the V3 captcha.\u003cbr /\u003e__This param is only required when solving V3 captchas__|\n| soft_id | false | int | - |2captcha Developer ID. \u003cbr /\u003e Developers get 10% of spendings of their software users. |\n### get_token() Parameters:\n| Field | Required |  Type  |  Description|\n| :-------------: |:-------------:|  :-----:| :-----:|\n| b64_img | false | string |  Base64 encoded captcha image\u003cbr /\u003e__This param is only required when solving image captchas__|\n| proxy| false | string |  Proxy to be used to solve captchas.\u003cbr /\u003eThis will make the captcha be solved from the proxy ip\u003cbr /\u003e\u003cbr /\u003eFormat: `ip:port:user:pass` |\n| proxy_type | false | string |  Type of the proxy being used. Options are:\u003cbr /\u003e `HTTP`, `HTTPS`, `SOCKS4`, `SOCKS5`|\n| user_agent | false | string |  UserAgent that will be passed to the service and used to solve the captcha |\n| rq_data | false | string |  Custom data that is used in some implementations of hCaptcha. Most of the times, you want to set the  `invisible_captcha` param to `true`.|\n### Examples\n##### Example - V2 Captcha / Basic usage\n```python\nfrom captchatools import new_harvester\n\ndef main():\n    harvester = new_harvester(\n        api_key=\"CHANGE THIS\", \n        solving_site=\"capsolver\",\n        captcha_type=\"v2\",\n        sitekey=\"6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-\",\n        captcha_url=\"https://www.google.com/recaptcha/api2/demo\"\n    )\n    answer = harvester.get_token()\n```\n##### Example - V3 Captcha\n```python\nfrom captchatools import new_harvester\n\ndef main():\n    harvester = new_harvester(\n    \n        api_key=\"CHANGE THIS\", \n        solving_site=\"capsolver\",\n        \n        captcha_type=\"v3\",\n        sitekey=\"6LcR_okUAAAAAPYrPe-HK_0RULO1aZM15ENyM-Mf\",\n        captcha_url=\"https://antcpt.com/score_detector/\",\n        action=\"homepage\",\n        min_score=0.7\n    )\n    token = harvester.get_token()\n```\n##### Example - Image captcha\n```python\nfrom captchatools import new_harvester\n\ndef main():\n    harvester = new_harvester(\n        api_key=\"CHANGE THIS\", \n        solving_site=\"capsolver\",\n        captcha_type=\"image\",\n    )\n    token = harvester.get_token(b64_img=\"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\")\n```\n##### Example - Additional captcha data\n```python\nfrom captchatools import new_harvester\n\ndef main():\n    harvester = new_harvester(\n        api_key=\"CHANGE THIS\", \n        solving_site=\"capsolver\",\n        captcha_type=\"v2\",\n        sitekey=\"6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-\",\n        captcha_url=\"https://www.google.com/recaptcha/api2/demo\"\n    )\n    \n    token = harvester.get_token(\n        proxy=\"ip:port:user:pass\", \n        proxy_type=\"http\", \n        user_agent=\"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/108.0.0.0 Safari/537.36\"\n    )\n```\n\n# Supported Sites\n- **[Capmonster](https://capmonster.cloud/)**\n- **[2Captcha](https://www.2captcha.com/)**\n- **[Anticaptcha](https://www.anti-captcha.com/)**\n- **[Capsolver](https://www.capsolver.com/)**\n- **[CaptchaAI](https://captchaai.com/)**\n\n### Site-Specific Support:\n| Site            | Site ID |Captcha Types  Supported    |  Task Types Supported|\n| :-------------: |:-------------:| :-----:| :-----:|\n| Capmonster      | captchatools.CapmonsterSite| Image captchas,\u003cbr/\u003e Recaptcha V2,\u003cbr /\u003eRecaptcha V3,\u003cbr /\u003eHCaptcha | ImageToTextTask,\u003cbr/\u003eNoCaptchaTask,\u003cbr/\u003e NoCaptchaTaskProxyless,\u003cbr/\u003e RecaptchaV3TaskProxyless,\u003cbr /\u003eHCaptchaTaskProxyless |\n| Anticaptcha     | captchatools.AnticaptchaSite| Image captchas,\u003cbr/\u003e Recaptcha V2,\u003cbr /\u003eRecaptcha V3,\u003cbr /\u003eHCaptcha      |    ImageToTextTask,\u003cbr/\u003e RecaptchaV2Task\u003cbr/\u003e  RecaptchaV2TaskProxyless,\u003cbr /\u003eRecaptchaV3TaskProxyless,\u003cbr /\u003eHCaptchaTaskProxyless |\n| 2Captcha        | captchatools.TwoCaptchaSite| Image captchas,\u003cbr/\u003e Recaptcha V2,\u003cbr /\u003eRecaptcha V3,\u003cbr /\u003eHCaptcha      |   - |\n| Capsolver        | captchatools.CapsolverSite| Image captchas,\u003cbr/\u003e Recaptcha V2,\u003cbr /\u003eRecaptcha V3,\u003cbr /\u003eHCaptcha\u003cbr /\u003eHcaptchaTurbo      |   - |\n| CaptchaAI        | captchatools.CaptchaAISite| Image captchas,\u003cbr/\u003e Recaptcha V2,\u003cbr /\u003eRecaptcha V3,\u003cbr /\u003eHCaptcha      |   - |\n\n\n\n# Recommendations\n1. For 2Captcha, don't run more than 60 tasks per API key.\n2. Handle errors appropriately.\n    * If a `ErrNoBalance` is thrown, tasks should stop. Some sites will temporarily ban IP's if constant requests come in.\n\n# Errors\n| Errors | Returned When |\n| :--------:| :-----:|\n| `ErrNoBalance` | Balance is below 0 for captcha solving site|\n| `ErrWrongAPIKey` | Incorrect API Key for captcha solving site|\n| `ErrWrongSitekey` | Incorrect sitekey |\n| `ErrIncorrectCapType` | Incorrectly chose a captcha type. When initializing a new harvester. Refer to [the captcha types](https://github.com/Matthew17-21/Captcha-Tools/tree/main/captchatools-go#config-struct-fields) |\n| `ErrNoHarvester` | When the user did not / incorrectly chose a captcha harvester. Refer to the [\"how to use\" guide](https://github.com/Matthew17-21/Captcha-Tools/tree/main/captchatools-go#how-to-use) |\n\n##### Error Handling\n```python\nfrom captchatools import new_harvester, exceptions as captchaExceptions,\n\ndef main():\n    try:\n        harvester = new_harvester()\n        token = harvester.get_token()\n    except captchaExceptions.NoHarvesterException:\n        print(\"I need to set my captcha harvester!\")\n```\n\n\n\n# Changelog\n### 1.4.1\n##### What's new\n1. Added CaptchaAI\n2. Removed internal redundant code\n3. Fix creating a new harvester if pass in the ID\n### 1.3.0\n##### What's new\n1. Get Balance Support\n2. Proxy Support\n3. User Agent Support\n4. Text image captcha support\n5. Better internal handling\n6. Capsolver support \n\n##### Important Changes\n* It is recommend to use the `new_harvester` function rather than the old `captcha_harvesters`","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMatthew17-21%2FCaptcha-Tools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FMatthew17-21%2FCaptcha-Tools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FMatthew17-21%2FCaptcha-Tools/lists"}