sexfrance/RecaptchaV2-Solver — reverse-engineered prompt

Build me a small Python project for testing reCAPTCHA v2 flows on sites I own, using only test keys or pages where I have permission.

I want to give it a page URL and site key, then get back a clear result through either a normal Python function, an async function, or a simple local API endpoint. Please include an example request that posts to a local server and returns a JSON response with either a token style result or a helpful error message.

Make it easy to run from a fresh install, with a requirements file, setup notes, and a quick test script. Add optional proxy settings, basic debug logs, timeout handling, and friendly errors for rate limits or failed challenges. Keep the code organized so I can use it as a library or run it as a service. If you need current browser automation docs, look them up online.