# recurl

> recurl is a drop-in curl replacement with automatic anti-bot bypass. It runs upstream curl on the happy path, detects blocked responses (403, 429, challenges), and escalates through TLS fingerprint impersonation and a headless-browser preflight only when the request actually needs them. Same flags, same exit codes, MIT licensed.

recurl is a CLI for engineers — scraper devs, automation engineers, security researchers testing their own properties, and DevOps debugging anti-bot 403s. The audience is people who already know what JA3 / JA4 / Cloudflare challenge responses look like.

## Docs

- [Home](https://recurl.neullabs.com/): Overview, features, install instructions
- [About](https://recurl.neullabs.com/about/): Why recurl exists and what it refuses to be
- [Blog](https://recurl.neullabs.com/blog/): TLS fingerprinting, bot-wall analysis, scraper architecture
- [Documentation](https://docs.neullabs.com/recurl/): Full CLI reference, daemon configuration, layer internals

## Compare

- [vs curl](https://recurl.neullabs.com/compare/curl/): The baseline. recurl runs real curl, escalates only on block.
- [vs curl-impersonate](https://recurl.neullabs.com/compare/curl-impersonate/): The closest open-source competitor; recurl wraps it and adds detection + JS preflight.

## Optional

- [RSS](https://recurl.neullabs.com/rss.xml): Blog feed
- [GitHub](https://github.com/neul-labs/recurl): Source, issues, releases