Inicio
Obtenga su clave de API
Acceda al panel de control de Agent Browser y obtenga su clave de API en la pestaña de configuración. Utilizaremos esta clave de API en los siguientes pasos.
Parámetros
| Nombre del parámetro | Tipo | Descripción |
|---|---|---|
| token | string | La clave de API generada en el panel de control. |
| sessionTTL | number | Controla la duración de la sesión y cierra automáticamente la instancia del navegador tras el tiempo de espera. Se mide en segundos (s), tiene un valor predeterminado de 180 segundos (3 minutos) y puede personalizarse entre 60 segundos (1 minuto) y 900 segundos (se recomienda un máximo de 15 minutos, aunque pueden establecerse tiempos más largos). Una vez alcanzado el TTL especificado, la sesión expirará y Agent Browser cerrará la instancia del navegador para liberar recursos. |
| sessionName | string | Establezca un nombre para su sesión para facilitar la búsqueda y visualización en la lista de sesiones históricas. |
| sessionRecording | boolean | Indica si se habilita la grabación de la sesión. Cuando está habilitado, todo el proceso de ejecución de la sesión del navegador se grabará automáticamente y, tras finalizar la sesión, podrá reproducirse y visualizarse en los detalles de la lista de sesiones históricas. El valor predeterminado es falso. |
| proxyURL | string | Se utiliza para establecer la URL del proxy del navegador, por ejemplo: http://user:pass@ip:port. Si se establece este parámetro, todos los demás proxy_* parámetros serán ignorados.💡 La funcionalidad de proxy personalizado actualmente solo está disponible para suscriptores. Actualice aquí |
| proxyCountry | string | Especifica el país/región de destino para el enrutamiento del proxy, dirigiendo las solicitudes a través de direcciones IP desde la ubicación seleccionada. Acepta códigos de país ISO (por ejemplo, US para Estados Unidos, GB para el Reino Unido, ANY para selección aleatoria). Admite más de 195 países y territorios. Cuando se combina con proxyState y proxyCity, permite un enfoque geográfico preciso hasta el nivel de ciudad. |
| proxyState | string | (Opcional) Especifica el estado/provincia de destino dentro del país seleccionado para un enrutamiento de proxy más granular. Debe usarse junto con proxyCountry. Acepta códigos de estado (por ejemplo, CA para California, NY para Nueva York). Disponible para países seleccionados con divisiones definidas de estado/provincia. Más información |
| proxyCity | string | (Opcional) Especifica la ciudad de destino dentro del estado/provincia seleccionado para el enrutamiento de proxy a nivel de ciudad. Debe usarse junto con proxyCountry y proxyState. Proporciona el enfoque geográfico más preciso. La disponibilidad depende de la infraestructura de proxy en ciudades específicas. Más información |
| extensionIds | string | Configurar extensión del navegador mediante el ID de extensión, separar por comas para múltiples extensiones |
| fingerprint | string | Una huella digital del navegador es una “huella digital” casi única creada mediante la información de configuración de su navegador y dispositivo, que puede utilizarse para rastrear su actividad en línea incluso sin cookies. Afortunadamente, configurar huellas digitales en Agent Browser es opcional. Ofrecemos una personalización profunda de huellas digitales del navegador, como parámetros clave como el agente de usuario del navegador, zona horaria, idioma y resolución de pantalla, y admitimos la ampliación de funcionalidades mediante parámetros de inicio personalizados. Adecuado para escenarios de gestión de múltiples cuentas, recopilación de datos y protección de privacidad, el uso del navegador Chromium propio de scrapeless evita completamente la detección. Por defecto, nuestro servicio Agent Browser genera una huella digital aleatoria para cada sesión. Referencia |
Ejemplo de una URL completa de conexión WebSocket de Agent Browser:
wss://browser.scrapeless.com/api/v2/browser?token=APIKey&sessionTTL=180&proxyCountry=ANYwss://browser.scrapeless.com/api/v2/browser?token=APIKey&sessionTTL=180&proxyCountry=US&proxyState=CA&proxyCity=Los%20Angeleswss://browser.scrapeless.com/api/v2/browser?token=APIKey&sessionTTL=180&proxyURL=proxyURLNota: Cuando proxyURL se especifica, tiene prioridad, y otros parámetros relacionados con el proxy (proxyCountry, proxyState, proxyCity) serán ignorados. Los parámetros geográficos de proxy deben usarse conjuntamente: proxyState requiere proxyCountry, y proxyCity requiere ambos proxyCountry y proxyState.