scarnox-python

Official Python client for the Scarnox captcha-solving API.

One call in, one token out. No task ids, no polling loop, and you only pay for captchas that were actually solved.

from scarnox import Scarnox

client = Scarnox()   # reads SCARNOX_KEY from the environment
token = client.solve(site_key="SITEKEY", site_url="https://example.com/signup").token

Why Scarnox

• Synchronous: solve() returns the token. There is no create-then-poll dance to write or debug.
• Pay per success: failed solves are never charged. Proxyless solving is $0.75 per 1,000 successful solves (pricing).
• Retries built in: the client follows the API's retry policy. Busy and timeout errors back off with jitter, an unsolvable board gets one more try, and account errors are raised straight away.
• No proxy needed: bring your own proxy only if the target site checks that the token was solved from the same IP that submits it.

Install

pip install scarnox

Get an API key at solver.scarnox.com/register, then:

export SCARNOX_KEY=scarnox_XXXXXXXXXXXXXXXXXXXX

Usage

from scarnox import Scarnox, ScarnoxError

client = Scarnox()

try:
    s = client.solve(
        site_key="SITEKEY",                    # the page's data-sitekey attribute
        site_url="https://example.com/signup", # the page the captcha is on
        # proxy="http://user:pass@host:port",  # optional: solve through your own IP
        # invisible=True,                      # optional: invisible widget (no checkbox)
    )
    print(s.token, s.cost, s.balance)
except ScarnoxError as e:
    print(e.code, e.description)               # e.g. ERROR_INSUFFICIENT_BALANCE

Submit the token right away. Tokens expire within about two minutes. Put it in the page's h-captcha-response field (and g-recaptcha-response if present), or pass it to the widget's JavaScript callback.

Playwright

examples/playwright_example.py opens a page, reads its sitekey, solves it, fills the response fields and submits the form, in about 30 lines.

Balance

client.balance()   # 9.994 (USD)

Every successful solve also returns balance, so most integrations never call this.

Errors

Full list: API docs.

Links

• Docs: https://solver.scarnox.com/docs
• OpenAPI spec: https://solver.scarnox.com/openapi.json
• Guides: Python · Playwright & Puppeteer · Error handling

License

MIT