Guía de resolución de problemas

Aprende a manejar comportamientos inesperados o bajas tasas de éxito al usar Oxylabs Agent Browser.

Síntoma	Causa probable	Solución
401 credenciales inválidas (las credenciales son correctas)	Usando ws:// esquema	Cambia a wss://
401 credenciales inválidas	Base nombre de usuario sin sufijo	Usa el nombre de usuario completo con el token de sufijo del panel de control (p. ej., _ab12)
CDP_SESSION_RATE_LIMIT_REACHED	Estás intentando iniciar demasiados navegadores por segundo	Mantente dentro del 10 límite de sesiones por segundo o contacta con el soporte para aumentar el límite.
CDP_MAX_CONCURRENT_SESSIONS_REACHED	El número de sesiones activas alcanzó el límite	Mantente por debajo de 100 el total de sesiones concurrentes o contacta con el soporte para aumentar el límite.
La inspección de sesión (VNC) no puede conectarse (el navegador se inicia)	Se alcanzó el límite máximo de VNC	Usa menos sesiones de VNC.
Error de TLS / certificado	Validación de certificados en Node.js	Establece NODE_TLS_REJECT_UNAUTHORIZED="0" antes de requerir Playwright (solo pruebas).
CDP_LIMIT_REACHED: límite de perfiles alcanzado	o_profile el recuento supera max_profiles (predeterminado: 5)	Reutiliza un nombre de perfil estable, elimina los perfiles no usados en el panel de control (hb.oxylabs.io/dashboard), o contacta con el soporte para aumentar el límite.
400 session_name debe tener entre 3 y 36 caracteres alfanuméricos o '-'	Guion bajo o caracteres no válidos en session_name	Usa solo letras, dígitos y guiones ([A-Za-z0-9-]).
Perfil restaurado, pero cookies están vacías	La IP de salida cambió entre sesiones	Fija proxy_resi_ses_id + proxy_resi_ses_time con valores idénticos en cada sesión.
Bloqueo de inicio de sesión / baja tasa de éxito	Reputación de IP, geolocalización incorrecta o discrepancia del motor	Establece p_cc (+ p_city), prueba con un diferente p_device, o inténtalo de nuevo en una sesión nueva.
Objetivo bloqueado por completo	Categoría de objetivo restringida	Completa el KYC a través de tu gestor de cuenta dedicado.

¿Sigues atascado? Contacta con el soporte de Oxylabs por chat en vivo o correo electrónico ([e-mail]).

Si experimentas un comportamiento inesperado o bajas tasas de éxito, considera los siguientes pasos:

Entiende nuestro proceso de manejo de CAPTCHA

Familiarízate con nuestros manejo de CAPTCHA métodos y su uso. Esto puede ayudar a determinar si los desafíos CAPTCHA son la causa del problema.

Usa el parámetro de país

Especificar un parámetro de país en tus solicitudes puede aumentar significativamente las tasas de éxito. Esto asegura que tus solicitudes se enruten a través de IPs de una ubicación geográfica específica, filtrando IPs de ubicaciones aleatorias o potencialmente menos fiables.

Puedes especificar un país para tu sesión del navegador añadiendo el ?p_cc parámetro a tu URL de conexión. Puedes encontrar más información en la sección Orientación por geolocalización.

Usa el parámetro de tipo de dispositivo

Probar con un parámetro de dispositivo puede dar lugar a tasas de éxito más altas. Puedes personalizar cómo el navegador emula distintos tipos de dispositivos usando el ?p_device parámetro. Puedes encontrar más información en Tipo de dispositivo sección.

Si los problemas persisten después de probar estos pasos, contacta con tu gestor de cuenta dedicado con los detalles del problema y de los pasos que ya has seguido.

¿Necesitas activar una función?

Algunas funciones de Agent Browser están limitadas de forma predeterminada. Para ajustar tus límites, contacta con el soporte de Oxylabs (chat en vivo o correo electrónico) o tu gestor de cuenta dedicado:

• Más perfiles persistentes – aumenta el límite predeterminado de tu cuenta de 5 perfiles guardados.
• Más sesiones persistentes – aumenta el límite predeterminado de tu cuenta de 5 sesiones persistentes concurrentes.
• Objetivos restringidos – desbloquea más categorías de objetivos mediante el proceso KYC.
• Límites de tasa más altos – aumenta por encima de 100 sesiones concurrentes / 10 por segundo.