/nopecha-python

Automated CAPTCHA solver for Python.

Primary LanguagePythonMIT LicenseMIT

NopeCHA

API bindings for the NopeCHA CAPTCHA service.

Installation

To install from PyPI, run python3 -m pip install nopecha.

API Usage

This package provides API wrappers for the following http packages:

Note: You will need to install the http package you want to use separately (except for urllib, as it's built-in but not recommended).

Requests example

from nopecha.api.requests import RequestsAPIClient

api = RequestsAPIClient("YOUR_API_KEY")
solution = api.solve_hcaptcha("b4c45857-0e23-48e6-9017-e28fff99ffb2", "https://nopecha.com/demo/hcaptcha#easy")

print("token is", solution["data"])

Async HTTPX example

from nopecha.api.httpx import AsyncHTTPXAPIClient

async def main():
    api = AsyncHTTPXAPIClient("YOUR_API_KEY")
    solution = await api.solve_hcaptcha("b4c45857-0e23-48e6-9017-e28fff99ffb2", "https://nopecha.com/demo/hcaptcha#easy")
    print("token is", solution["data"])

asyncio.run(main())

Extension builder

This package also provides a extension builder for Automation builds which includes:

  1. downloading the extension
  2. updating the extension
  3. updating the extension's manifest to include your settings

Example

from nopecha.extension import build_chromium

# will download the extension to the current working directory
output = build_chromium({
    "key": "YOUR_API_KEY",
})

# custom output directory
from pathlib import Path
output = build_chromium({
    "key": "YOUR_API_KEY",
}, Path("extension"))

You can plug the output path directly into your browser's extension manager to load the extension:

import undetected_chromedriver as uc
from nopecha.extension import build_chromium

output = build_chromium({
    "key": "YOUR_API_KEY",
})

options = uc.ChromeOptions()
options.add_argument(f"load-extension={output}")

Building

To build from source, you will need to install build (python3 -m pip install --upgrade build ).

Then simply run python3 -m build to build the package.

Uploading to PyPI

To upload to PyPI, you will need to install twine (python3 -m pip install --upgrade twine).

Then simply run python3 -m twine upload dist/* to upload the package.