Automação Básica do Dolphin {anty}
Informações gerais 📜
Os perfis de navegador baseados no mecanismo "Anty" suportam a inicialização ativada pelo protocolo DevTools. Isso permite que você se conecte ao perfil por meio de uma porta gerada na inicialização e automatize o navegador usando ferramentas como Puppeteer, Playwright, Selenium e outras.
Portanto, a automação básica envolve três etapas básicas:
- Inicie o perfil por meio da API com o protocolo DevTools ativado
- Conecte-se à porta de perfil usando uma ferramenta de automação (Puppeteer, Playwright, Selenium, Postman, etc.).
- Execute seu próprio script de automação por meio de uma conexão aberta.
ℹ️ Para usar automação, o Dolphin Anty deve estar em execução e autorizado a funcionar. A autorização pode ser feita por login e senha ou por solicitação de software usando um token. Você pode criar um token em seu gabinete pessoal.
Parâmetros de solicitação para autorização usando token:
Para evitar o erro 401, é necessário enviar a solicitação
Method: POST
URL: http://localhost:3001/v1.0/auth/login-with-token
Header: Content-Type: application/json
Body:
{ "token": "API_TOKEN"}
Em qualquer lugar onde houver API_TOKEN, você precisará substituí-lo pelo seu token (chave da API) do seu gabinete pessoal em nosso site.
ChromeDriver ⬇️
O ChromeDriver é a ponte entre seu script (por exemplo, Selenium) e o navegador Dolphin{anty}. O driver padrão pode revelar automação, portanto, fornecemos nosso próprio ChromeDriver modificado para cada versão do navegador.
Exemplos de solicitação de autorização ⚙️
✅ Se for bem-sucedido, a resposta será:
{"success": true}
Etapa 1 - Iniciar um perfil via API ▶️
Para iniciar um perfil de navegador via API, envie uma solicitação GET:
http://localhost:3001/v1.0/browser_profiles/PROFILE_ID/start?automation=1
Para headless mode:
http://localhost:3001/v1.0/browser_profiles/PROFILE_ID/start?automation=1&headless=1
PROFILE_ID- ID do perfil do browser (você pode obtê-lo por meio da API ou no aplicativo Dolphin{anty} ao editar um perfil).automation=1- parâmetro obrigatório.
Exemplo de como iniciar uma requisição via Postman
⚠️Notas importantes:
- A API local funciona somente se o Dolphin{anty} estiver em execução.
- As solicitações devem ser enviadas do mesmo computador em que o navegador é executado.
- Por padrão, a API local usa a porta 3001; se estiver ocupada, outra porta será atribuída (verifique na janela Saúde do Dolphin{anty}).
- No plano gratuito, a importação/exportação de cookies via API não está disponível devido à ausência de sincronização na nuvem.
- Limite de requisições (taxa de requisições): 1500 requisições por minuto
API response ✅
Se o perfil tiver sido iniciado com êxito, a resposta terá aproximadamente a seguinte aparência (os valores dos campos port e wsEndpoint podem variar):
{
"success": true,
"automation": {
"port": 50568,
"wsEndpoint": "/devtools/browser/c71c1a9d-f07c-4dd9-84a9-53a4c6df9969" }}
Etapa 2 — Conectando a um perfil 🔌
Puppeteer
Puppeteer — Biblioteca popular do Google para automação e teste da interface do usuário do navegador. Originalmente criada para iniciar o Chrome e verificar a interface do usuário, mas suporta quase todas as ações do navegador. Requer conhecimento de JavaScript/Node.js.
Playwright
Playwright - Uma alternativa mais nova e moderna ao Puppeteer, só que desenvolvida pela Microsoft com API e funcionalidade semelhantes.
Selenium
A conexão do Selenium a um navegador em execução é descrita neste artigo. Vale a pena observar que o Selenium usa o ChromeDriver padrão, mas os sites podem detectar a automação. Portanto, recomendamos o uso de nosso ChromeDriver — faça o download e especifique o caminho em seu código para ocultar o uso do Selenium.
Etapa 3 — Interromper um perfil ⛔️
Para interromper um perfil de navegador via API, envie uma GET request:
http://localhost:3001/v1.0/browser_profiles/PROFILE_ID/stop