Extensão para o Chrome (Beta)

A extensão FourA Chrome adiciona duas ferramentas ao seu navegador. O popup direciona o Chrome através de um dos seus usuários de proxy na porta de proxy. A aba FourA no DevTools transforma qualquer request feito por uma página em uma chamada de API pronta para uso.

A extensão está em versão beta. Ela ainda não está na Chrome Web Store, portanto o Chrome a instala no modo de desenvolvedor, e suas telas e configurações ainda podem mudar. Ela requer a versão 116 ou mais recente do Chrome e funciona em todos os planos, incluindo o plano Free.

Instalação

O arquivo zip está disponível no painel: abra Extension sob Tools na barra lateral e clique em Download.

1. Baixe o zip e descompacte-o. Mantenha a pasta: o Chrome carrega a extensão a partir dela.
2. Abra chrome://extensions e ative o Developer mode no canto superior direito.
3. Clique em Load unpacked e selecione a pasta descompactada.
4. Fixe o FourA a partir do ícone de quebra-cabeça na barra de ferramentas. O ícone fica cinza enquanto o FourA estiver desativado e exibe um ponto verde enquanto estiver roteando tráfego.

Atualizações

A extensão verifica se há novas versões uma vez por hora e quando você abre o popup, e o botão Check now sob Version nas Settings do popup faz a verificação imediatamente. Quando uma nova versão estiver disponível, o popup exibirá o número da versão com um botão Download. Descompacte a nova versão e selecione a pasta correspondente usando Load unpacked. O FourA é atualizado mantendo suas configurações, independentemente da pasta de origem da nova versão. Se você descompactou os arquivos sobre a pasta atual, basta clicar em Reload FourA. Se estiver atualizando a partir da versão 0.3.1 ou anterior, a extensão será instalada como um novo card: selecione seu usuário de proxy novamente e remova o card antigo.

Antes de Começar

• Um usuário de proxy. Crie um na página Proxy do painel: consulte Proxy.
• Sessão iniciada no painel, no mesmo Chrome. A extensão lê seus usuários de proxy diretamente do painel e de nenhum outro lugar. Quando nenhuma aba do painel estiver aberta, ela abrirá uma em segundo plano para ler os dados e a fechará em seguida.

Navegue Através do FourA

O popup tem três páginas: Connect, Location e Settings.

Connect

1. Abra o FourA na barra de ferramentas e selecione o usuário de proxy que este navegador usará.
2. Clique no interruptor principal.
3. Verifique o campo Address sites see. O FourA detecta esse endereço diretamente pelo túnel em vez de presumi-lo a partir das suas configurações, exibindo Your address ao lado para comparação.

Traffic this period mostra quanto do tráfego de proxy do seu plano você já utilizou.

Location

• Network: Shared (nosso pool, tráfego do plano) ou Premium (residencial, por GB). No Shared, Use premium when shared cannot carry a page usa uma saída premium quando a rede compartilhada não consegue carregar a requisição. Só é acionado se seu plano incluir tráfego premium e houver saldo disponível.
• Country: qualquer país por padrão. Os países usados recentemente ficam a um clique de distância.
• Region, City e Network operator: apenas premium, após você escolher um país.
• Address: Keep one mantém a mesma saída, New every request altera a cada requisição e New address obtém um novo agora. No premium com Keep one, Hold it for define por quanto tempo o endereço é mantido, em minutos ou horas.

As opções por trás dessas escolhas são as mesmas documentadas na porta do proxy em Proxy Port.

Settings

• What goes through the tunnel: Everything except uma lista, ou Only these. example.com abrange seus subdomínios, * funciona como um caractere curinga e 203.0.113.0/24 é um intervalo.
• Never tunnel the local network or this machine: nomes sem ponto, localhost, .local e os intervalos de endereços privados permanecem na sua própria conexão, independentemente do que a lista contenha.
• Let plain http:// pages use my own connection: a porta do proxy transporta apenas conexões criptografadas. Desativado, uma página http:// simples não carrega. Ativado, ela carrega pela sua própria conexão e o site vê seu endereço.
• Stop WebRTC from finding a way around the proxy: fecha um caminho que uma página pode usar para ler seu endereço real enquanto o túnel estiver ativo.
• Incognito windows: elas também usam o túnel. O FourA só pode fornecer a senha do proxy lá se você permitir: chrome://extensions, FourA, Details, Allow in Incognito. Até lá, o Chrome solicitará a senha a você no modo anônimo.
• Proxy address for other tools: o usuário de proxy escolhido como uma URL de proxy, com sua senha, para colar em qualquer cliente compatível. Trate isso como uma senha.
• Proxy users: Reload from dashboard sincroniza usuários de proxy criados ou modificados por você. Forget on this computer os remove deste navegador.

When the Icon Turns Red

Um ícone vermelho com um número indica que o proxy recusou essa quantidade de conexões no último minuto. Abra o FourA para ver o motivo. Os motivos mais comuns:

• Muitas conexões ao mesmo tempo: limite de túneis abertos do seu plano. Partes da página voltam a carregar conforme as conexões fecham.
• Muitas conexões novas neste minuto: limite do seu plano de novos túneis por minuto. Aguarde um minuto antes de recarregar, pois cada nova tentativa também conta.
• O tráfego de proxy deste período foi esgotado ou O tráfego premium foi esgotado: adicione tráfego na página de Faturamento ou aguarde o próximo período.
• O proxy não está no seu plano: veja os planos na página de Faturamento.
• O proxy não aceitou a senha: o usuário do proxy pode ter sido alterado ou excluído no painel. Selecione-o novamente.
• Outra extensão controla o proxy: enquanto outra extensão mantiver as configurações de proxy do Chrome, o FourA não roteia nada. Desative essa extensão e, em seguida, desligue e ligue o switch.

Os limites atuais do seu plano estão na página Uso e Limites.

Transforme uma Request em uma Chamada de API

1. Abra o DevTools em qualquer página e escolha a aba FourA, ao lado de Rede (atrás de » quando o DevTools estiver estreito). Se o DevTools já estava aberto quando você instalou o FourA, feche e abra novamente.
2. Recarregue a página. A aba lista as requests da página da mesma forma que a aba Rede. Ocultar anúncios e analytics fica ativado por padrão, e Apenas este site mantém apenas as requests da própria página.
3. Digite um texto visto na página em Localizar nas respostas para encontrar a request correspondente. Selecione a request para ver seus Cabeçalhos, Payload e Resposta.
4. Em Chamada FourA, escolha o mecanismo (Single, Proxy Finder ou Browser) e um País de saída opcional, depois copie a chamada como cURL, Python, Node ou MCP. A chamada inclui os cabeçalhos e cookies usados pela página.
5. Clique em Abrir no playground para carregar a chamada no Playground do painel, ou em Executar via FourA para executá-la. Após a execução, O navegador obteve e FourA obteve mostram a resposta da página e a nossa lado a lado.

Clicar com o botão direito em uma request oferece as mesmas opções de cópia, além de Copiar URL, Copiar resposta e Abrir em uma nova aba.

A Chave de API para Execuções

Executar via FourA usa uma chave de API e seus créditos. Defina-a nas Configurações da aba:

1. Clique em Escolher do seu painel e selecione uma chave, ou cole uma em Ou cole uma chave de API.
2. Marque Manter a chave neste computador para salvá-la após fechar o Chrome. Caso contrário, ela permanece apenas até o Chrome ser fechado.
3. Esquecer a chave remove a chave salva.

O playground abre com a mesma chave selecionada se ela pertencer à sua conta. Caso contrário, ele solicitará que você escolha uma.

Custos

A extensão é gratuita. O tráfego enviado pelas nossas saídas é contabilizado no limite de proxy do seu plano, assim como qualquer outro cliente na porta de proxy. Chamadas executadas a partir do DevTools custam o valor cobrado pela API. Consulte Planos e Medição.

O Que é Armazenado e Enviado

• O usuário de proxy escolhido por você e a senha dele permanecem neste computador.
• Uma chave de API que você escolhe na aba DevTools permanece até que o Chrome seja fechado, ou neste computador quando você solicitar.
• Nada sobre as páginas que você visita é armazenado ou enviado para nós.
• Por conta própria, a extensão consulta ipinfo.io (ou Cloudflare e depois api.ipify.org quando esse estiver ocupado) para verificar qual endereço o site visualiza, consulta foura.ai uma vez por hora e quando você a abre para verificar qual versão é a atual, lê seus usuários de proxy e a lista de países do seu painel, e consulta o endereço do proxy a partir de dns.google ou Cloudflare. Todo o restante acontece quando você clica em um botão.
• Uma chamada copiada com cookies reproduz a sessão em que você está conectado. Trate-a como uma senha e não a cole em nenhum local público.

Limites

• Seu navegador estabelece sua própria conexão criptografada através do túnel, portanto o site visualiza nosso endereço e seu navegador. Páginas que verificam quem está fazendo a requisição, além da renderização completa no navegador, são gerenciadas pela API: consulte Site checks.
• O Chrome é o único navegador para o qual a extensão foi desenvolvida e testada.