lexiforest/curl_cffi

Что это?

Ключевые возможности

• 01Имитирует TLS-, JA3- и HTTP/2-отпечатки браузеров, в том числе с использованием собственных отпечатков.
• 02Предоставляет API в стиле requests с сессиями, а также синхронные и asyncio-клиенты.
• 03Поддерживает HTTP/2 и HTTP/3, а также HTTP- и SOCKS-прокси.
• 04Включает WebSocket-клиенты с имитацией браузера при рукопожатии.
• 05В комплект входит CLI curl-cffi для загрузки URL с имитацией браузера.

Сценарии использования

• Загрузка страниц с сайтов, которые блокируют запросы по TLS-отпечатку, если они отправлены через requests или httpx.
• Создание веб-скрейперов, которым нужны параллельные запросы через asyncio и ротация прокси.
• Тестирование реакции сервиса на определённые отпечатки браузеров.
• Использование Scrapy или кода на базе requests с TLS-поведением, похожим на браузерное.

Быстрый старт

1. 1

   Установите пакет из PyPI

   pip install curl_cffi --upgrade
2. 2

   Отправьте запрос, имитирующий Chrome

   python -c "import curl_cffi; r = curl_cffi.get('https://tls.browserleaks.com/json', impersonate='chrome'); print(r.json())"

Что важно знать

• !Для некоторых расширенных функций, например отпечатков http/3, требуется актуальная версия.
• !Коммерческая поддержка и дополнительные отпечатки доступны в платном тарифе.

Темы

Частые вопросы

Что такое curl_cffi?

HTTP-клиент для Python на базе curl, который имитирует TLS-, JA3- и HTTP/2-отпечатки браузеров, помогая обходить блокировки. curl_cffi — это биндинг для Python к форку curl-impersonate, созданный на базе cffi. Он предоставляет API в стиле requests для синхронных и асинхронных HTTP-запросов. В отличие от requests и httpx, библиотека может устанавливать соединения, похожие на соединения настоящих браузеров, имитируя их TLS-, JA3- и HTTP/2-отпечатки.

curl_cffi можно использовать бесплатно? Какая у него лицензия?

curl_cffi распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.

curl_cffi всё ещё поддерживается?

Активно поддерживается. Последний коммит в curl_cffi — 23 окт. 2026 г..

Для чего можно использовать curl_cffi?

Загрузка страниц с сайтов, которые блокируют запросы по TLS-отпечатку, если они отправлены через requests или httpx. Создание веб-скрейперов, которым нужны параллельные запросы через asyncio и ротация прокси. Тестирование реакции сервиса на определённые отпечатки браузеров. Использование Scrapy или кода на базе requests с TLS-поведением, похожим на браузерное.

Как установить curl_cffi?

Установите пакет из PyPI: pip install curl_cffi --upgrade Отправьте запрос, имитирующий Chrome: python -c "import curl_cffi; r = curl_cffi.get('https://tls.browserleaks.com/json', impersonate='chrome'); print(r.json())"

Где скачать curl_cffi?

Исходный код и инструкции по установке — на GitHub: https://github.com/lexiforest/curl_cffi