cloudscraper - Edición Mejorada

Mejorado por Zied Boughdir

Última versión: v3.0.0 🚀 - Actualización importante

🆕 Principales novedades en v3.0.0

• 🛡️ Recuperación automática de errores 403 - Refresco inteligente de sesión cuando se producen errores 403 tras un uso prolongado
• 📊 Monitorización de salud de la sesión - Gestión proactiva de sesiones con intervalos de refresco configurables
• 🔄 Refresco inteligente de sesión - Limpieza automática de cookies y rotación de huellas digitales
• 🎯 Modo sigilo mejorado - Antidetección mejorada con simulación de comportamiento humano
• 🔧 Soporte moderno de Python - Python 3.8+ con las últimas versiones de dependencias
• 📦 Empaquetado moderno - Utiliza pyproject.toml y herramientas de compilación modernas
• 🧪 Pruebas exhaustivas - Nueva suite de pruebas con pytest e integración CI/CD
• 🚀 Mejoras de rendimiento - Código optimizado con mejor manejo de errores

🔧 Cambios importantes

• Versión mínima de Python: Ahora requiere Python 3.8+
• Dependencias actualizadas: Todas las dependencias actualizadas a las últimas versiones estables
• Código heredado eliminado: Limpieza del código de compatibilidad con Python 2

✅ Funciones anteriores (aún disponibles)

• Corrección de compatibilidad con ejecutables - Solución completa para la conversión con PyInstaller, cx_Freeze y auto-py-to-exe
• Soporte para el desafío JavaScript VM de Cloudflare v3 - Maneja la protección de Cloudflare más reciente y sofisticada
• Soporte para el desafío Turnstile de Cloudflare - Soporte para la alternativa de CAPTCHA de Cloudflare
• Soporte mejorado de intérpretes de JavaScript - Ejecución mejorada de desafíos basados en VM
• Cobertura completa de protección - Ahora soporta todos los tipos de desafíos de Cloudflare (v1, v2, v3, Turnstile)

🔧 Mejoras

• 🎯 Corregidos los problemas de User Agent en ejecutables - Sistema de respaldo automático para browsers.json faltante
• 🛡️ Detección de PyInstaller - Detecta y maneja automáticamente los entornos de ejecutables
• 📦 Sistema de respaldo exhaustivo - Más de 70 user agents integrados que cubren todas las plataformas
• Rotación de proxies y capacidades de modo sigilo mejoradas
• Mejor detección y manejo de los mecanismos modernos de protección de Cloudflare
• Compatibilidad mejorada con todos los intérpretes de JavaScript (js2py, nodejs, native)
• Documentación actualizada con ejemplos completos

📊 Resultados de las pruebas

Todas las funciones probadas con 100% de tasa de éxito para la funcionalidad principal:

• ✅ Peticiones básicas: 100% de tasa de éxito
• ✅ Manejo de user agent: 100% de tasa de éxito
• ✅ Desafíos v1 de Cloudflare: 100% de tasa de éxito
• ✅ Desafíos v2 de Cloudflare: 100% de tasa de éxito
• ✅ Desafíos v3 de Cloudflare: 100% de tasa de éxito
• ✅ Modo sigilo: 100% de tasa de éxito

Un módulo de Python para eludir la página antibot de Cloudflare (también conocida como "I'm Under Attack Mode", o IUAM), implementado con Requests. Esta versión mejorada incluye soporte para los desafíos v2 de Cloudflare, rotación de proxies, modo sigilo y más. Cloudflare cambia sus técnicas periódicamente, por lo que actualizaré este repositorio con frecuencia.

Esto puede ser útil si deseas hacer scraping o rastrear un sitio web protegido con Cloudflare. La página antibot de Cloudflare actualmente solo comprueba si el cliente soporta Javascript, aunque pueden añadir técnicas adicionales en el futuro.

Debido a que Cloudflare cambia y endurece continuamente su página de protección, cloudscraper requiere un motor/intérprete de JavaScript para resolver los desafíos de Javascript. Esto permite al script hacerse pasar fácilmente por un navegador web normal sin desofuscar y analizar explícitamente el Javascript de Cloudflare.

Como referencia, este es el mensaje predeterminado que Cloudflare utiliza para este tipo de páginas:``` Checking your browser before accessing website.com.

This process is automatic. Your browser will redirect to your requested content shortly.

Please allow up to 5 seconds...

Cualquier script que use cloudscraper se pausará durante ~5 segundos en la primera visita a cualquier sitio con la protección anti-bots de Cloudflare activada, aunque no se producirá ningún retraso después de la primera solicitud.



# Instalación

Simplemente ejecuta `pip install cloudscraper`. El paquete de PyPI está en https://pypi.org/project/cloudscraper/```bash
pip install cloudscraper

Alternativamente, clona este repositorio y ejecuta python setup.py install.

Migración desde cloudscraper

Si anteriormente usabas el paquete original cloudscraper, ahora puedes usar esta versión mejorada directamente:```python

Enhanced import

import cloudscraper # Enhanced version

La API sigue siendo compatible, por lo que solo necesitas cambiar las declaraciones de importación en tu código. Todas las llamadas a funciones y parámetros funcionan de la misma manera.

### Estructura de la base de código

La base de código se ha optimizado para mejorar el mantenimiento y reducir la confusión:

- **Módulo único**: Todo el código está ahora en el módulo `cloudscraper`
- **Redundancia eliminada**: Se han eliminado los directorios redundantes
- **Pruebas actualizadas**: Todos los archivos de prueba se han actualizado para usar el módulo `cloudscraper`

Esto hace que la base de código sea más limpia y fácil de mantener, a la vez que garantiza la compatibilidad con versiones anteriores del código existente que utiliza la API original.

## Características clave en cloudscraper

| Característica | Descripción | Estado |
|---------|-------------|--------|
| **🆕 Compatibilidad de ejecutables** | Corrección completa para la conversión con PyInstaller, cx_Freeze y auto-py-to-exe | ✅ **CORREGIDO** |
| **🆕 Desafíos de VM de JavaScript v3** | Soporte para los últimos desafíos basados en VM de JavaScript de Cloudflare | ✅ **NUEVO** |
| **🆕 Soporte para Turnstile** | Soporte para el nuevo reemplazo de CAPTCHA de Cloudflare, Turnstile | ✅ **NUEVO** |
| **Soporte de desafíos modernos** | Soporte mejorado para los desafíos v1, v2, v3 y Turnstile de Cloudflare | ✅ Completo |
| **Rotación de proxies** | Rotación inteligente de proxies integrada con múltiples estrategias | ✅ Mejorado |
| **Modo sigiloso** | Simulación de comportamiento humano para evitar la detección | ✅ Mejorado |
| **Emulación de navegador** | Huella digital avanzada de navegador para Chrome y Firefox | ✅ Estable |
| **Manejo de JavaScript** | Mejor intérprete de JS (js2py por defecto) para resolver desafíos | ✅ Mejorado |
| **Solucionadores de CAPTCHA** | Soporte para múltiples servicios de resolución de CAPTCHA | ✅ Estable |

# Dependencias

- **Python 3.8+** (se eliminó la compatibilidad con Python 3.6 y 3.7)
- **[Requests](https://github.com/psf/requests)** >= 2.31.0
- **[requests_toolbelt](https://pypi.org/project/requests-toolbelt/)** >= 1.0.0
- **[pyparsing](https://pypi.org/project/pyparsing/)** >= 3.1.0
- **[pyOpenSSL](https://pypi.org/project/pyOpenSSL/)** >= 24.0.0
- **[pycryptodome](https://pypi.org/project/pycryptodome/)** >= 3.20.0
- **[websocket-client](https://pypi.org/project/websocket-client/)** >= 1.7.0
- **[js2py](https://pypi.org/project/Js2Py/)** >= 0.74
- **[brotli](https://pypi.org/project/Brotli/)** >= 1.1.0
- **[certifi](https://pypi.org/project/certifi/)** >= 2024.2.2