captcha-router 0.1.3

Reusable captcha router with pluggable solver providers.

captcha-router

Reusable captcha router with pluggable providers.

Install

pip install captcha-router

uv add captcha-router

Supported providers

• anticaptcha (alias: anti-captcha)
• 2captcha (alias: twocaptcha)

Router methods

• CaptchaRouter.list_providers(): returns all registered provider names and aliases.
• CaptchaRouter.list_provider_capabilities(include_aliases=False): returns provider -> supported captcha kinds.
• CaptchaRouter.get_supported_task_kinds(provider_name): returns supported captcha kinds for one provider.
• CaptchaRouter.list_supported_task_kinds(): returns union of captcha kinds across providers.
• CaptchaRouter.get_solver(provider_name=None, api_key=None, **kwargs): creates a solver instance and uses env fallbacks when api_key is omitted.

Usage

1) Create a solver

from captcha_router import CaptchaRouter

solver = CaptchaRouter.get_solver(provider_name="anticaptcha", api_key="YOUR_KEY")

2) Solve a task

import asyncio
from captcha_router import CaptchaRouter, CaptchaTaskSpec


async def main():
    solver = CaptchaRouter.get_solver(provider_name="anticaptcha", api_key="YOUR_KEY")
    try:
        result = await solver.solve_task(
            CaptchaTaskSpec(
                kind="recaptcha_v2",
                params={
                    "website_url": "https://example.com",
                    "site_key": "SITE_KEY_HERE",
                },
            )
        )
        print(result.status, result.token, result.error)
    finally:
        await solver.close()


asyncio.run(main())

3) Inspect capabilities

from captcha_router import CaptchaRouter

print(CaptchaRouter.list_providers())
print(CaptchaRouter.list_provider_capabilities())