Primeiros Passos
Obtenha Sua Chave de API
Acesse o painel de controle do Agent Browser e obtenha sua chave de API na aba de configurações. Usaremos essa chave de API nas etapas seguintes.
Parâmetros
| Nome do Parâmetro | Tipo | Descrição |
|---|---|---|
| token | string | A chave de API gerada no painel de controle. |
| sessionTTL | number | Controla a duração da sessão e fecha automaticamente a instância do navegador após o tempo limite. Medido em segundos (s), com valor padrão de 180 segundos (3 minutos), personalizável entre 60 segundos (1 minuto) e 900 segundos (máximo recomendado de 15 minutos, mas tempos maiores podem ser definidos). Uma vez atingido o TTL especificado, a sessão expira e o Agent Browser fecha a instância do navegador para liberar recursos. |
| sessionName | string | Defina um nome para sua sessão para facilitar a busca e a visualização na lista de sessões do histórico. |
| sessionRecording | boolean | Se deve habilitar a gravação da sessão. Quando habilitado, todo o processo de execução da sessão do navegador será gravado automaticamente e, após a conclusão da sessão, ele poderá ser reproduzido e visualizado nos detalhes da lista de sessões do histórico. O valor padrão é false. |
| proxyURL | string | Usado para definir a URL de proxy do navegador, por exemplo: http://user:pass@ip:port. Se este parâmetro for definido, todos os outros parâmetros proxy_* serão ignorados.💡A funcionalidade de proxy personalizado está atualmente disponível apenas para assinantes. Faça upgrade aqui |
| proxyCountry | string | Especifica o país/região de destino para o roteamento do proxy, direcionando as requisições por meio de endereços IP da localização selecionada. Aceita códigos de país ISO (por exemplo, US para Estados Unidos, GB para Reino Unido, ANY para seleção aleatória). Suporta 195+ países e territórios. Quando combinado com proxyState e proxyCity, permite segmentação geográfica precisa até o nível de cidade. |
| proxyState | string | (Opcional) Especifica o estado/província de destino dentro do país selecionado para um roteamento de proxy mais granular. Deve ser usado em conjunto com proxyCountry. Aceita códigos de estado (por exemplo, CA para Califórnia, NY para Nova York). Disponível para países selecionados com divisões de estado/província definidas. saiba mais |
| proxyCity | string | (Opcional) Especifica a cidade de destino dentro do estado/província selecionado para roteamento de proxy em nível de cidade. Deve ser usado em conjunto com proxyCountry e proxyState. Fornece a segmentação geográfica mais precisa. A disponibilidade depende da infraestrutura de proxy em cidades específicas. saiba mais |
| extensionIds | string | configura a extensão do navegador pelo id da extensão, separadas por vírgula para múltiplas extensões |
| fingerprint | string | Uma impressão digital do navegador é uma “impressão digital” quase única criada usando as informações de configuração do seu navegador e dispositivo, que pode ser usada para rastrear sua atividade online mesmo sem cookies. Felizmente, a configuração de impressões digitais no Agent Browser é opcional. Oferecemos personalização profunda das impressões digitais do navegador, como parâmetros essenciais como user agent do navegador, fuso horário, idioma e resolução da tela, além de suportar a extensão de funcionalidades por meio de parâmetros de inicialização personalizados. Adequado para cenários de gerenciamento de múltiplas contas, coleta de dados e proteção de privacidade, usar o próprio navegador Chromium da scrapeless evita completamente a detecção. Por padrão, nosso serviço Agent Browser gera uma impressão digital aleatória para cada sessão. Referência |
Exemplo de uma URL completa de conexão WebSocket do 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=proxyURLObservação: Quando proxyURL é especificado, ele tem precedência, e os outros parâmetros relacionados a proxy (proxyCountry, proxyState, proxyCity) serão ignorados. Os parâmetros de proxy geográfico devem ser usados em conjunto: proxyState requer proxyCountry, e proxyCity requer tanto proxyCountry quanto proxyState.