# Extensão do Chrome (Beta)

> URL: https://foura.ai/pt/docs/dashboard/chrome-extension
> Updated: 2026-11-05
> Index: https://foura.ai/llms.txt

A extensão FourA Chrome coloca duas ferramentas no seu navegador. O **popup** envia o Chrome através de um dos seus usuários proxy na [porta proxy](https://foura.ai/docs/api/proxy-port). A **aba FourA no DevTools** transforma qualquer request que uma página faz em uma chamada de API pronta.

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

## Instalação

O arquivo zip fica no dashboard: abra **Extension** sob **Tools** na barra lateral e clique em **Download**.

1. Baixe o arquivo 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 escolha 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.

### Atualizações

A extensão verifica se há uma nova versão uma vez por hora e quando você abre o popup, e o botão **Check now** sob **Version** nas configurações do popup verifica imediatamente. Quando uma nova versão é lançada, o popup mostra a versão com um botão **Download**. Descompacte a nova versão e escolha sua pasta com **Load unpacked**. O FourA substitui a versão anterior e mantém suas configurações, independentemente de qual pasta venha a nova versão. Se você a descompactou sobre a pasta atual, basta clicar em **Reload FourA**. Caso venha da versão 0.3.1 ou anterior, ela será instalada como um novo cartão: selecione seu usuário proxy novamente e remova o cartão antigo.

## Antes de Começar

- Um usuário proxy. Crie um na página **Proxy** do dashboard: consulte [Proxy](https://foura.ai/docs/dashboard/proxy).
- O dashboard conectado no mesmo Chrome. A extensão lê seus usuários proxy a partir do dashboard e de nenhum outro lugar. Quando nenhuma aba do dashboard estiver aberta, ela abre uma em segundo plano para fazer a leitura e a fecha em seguida.

## Navegar com o 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 proxy que este navegador utiliza.
2. Pressione o botão principal de ativação.
3. Verifique o **Address sites see**. O FourA mede esse endereço através do túnel em vez de presumi-lo a partir das suas configurações, e exibe **Your address** ao lado para comparação.

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

### Location

- **Rede:** **Compartilhada** (nosso pool, tráfego do plano) ou **Premium** (endereços residenciais, consumidos do tráfego premium do seu plano). Na Compartilhada, **Usar premium quando a compartilhada não carregar uma página** usa uma saída premium quando a rede compartilhada não puder atender à request. Isso só é acionado quando o seu plano inclui tráfego premium e ainda há limite disponível.
- **País:** qualquer país por padrão. Os países usados recentemente ficam a um clique de distância.
- **Região**, **Cidade** e **Operadora de rede:** apenas no premium, após você selecionar um país.
- **Endereço:** **Manter um** preserva a mesma saída, **Novo a cada request** altera o endereço a cada request, e **Novo endereço** obtém um novo agora. No premium com **Manter um**, **Reter por** 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 para a porta do proxy em [Porta do Proxy](https://foura.ai/docs/api/proxy-port).

### Configurações

- **O que passa pelo túnel:** **Tudo exceto** uma lista, ou **Apenas estes**. `example.com` abrange seus subdomínios, `*` funciona como um caractere curinga, e `203.0.113.0/24` é um intervalo.
- **Nunca tunelar a rede local ou esta máquina:** nomes sem ponto, `localhost`, `.local` e as faixas de endereços privados permanecem na sua própria conexão, independentemente do que constar na lista.
- **Permitir que páginas http:// simples usem a minha própria conexão:** a porta do proxy transporta apenas conexões criptografadas. Desativado, uma página simples `http://` não carrega. Ativado, ela carrega pela sua própria conexão e o site visualiza o seu endereço.
- **Impedir que o WebRTC contorne o proxy:** fecha uma brecha que uma página pode usar para identificar seu endereço real enquanto o túnel estiver ativo.
- **Janelas anônimas:** elas também usam o túnel. O FourA só consegue autenticar a senha do proxy nesse modo se você permitir: `chrome://extensions`, FourA, **Detalhes**, **Permitir em modo anônimo**. Até lá, o Chrome solicitará a senha a você na janela anônima.
- **Tema:** **Sistema**, **Claro** ou **Escuro** para a janela popup.
- **Endereço do proxy para outras ferramentas:** o usuário de proxy selecionado formatado como uma URL de proxy, com sua senha, para colar em qualquer cliente compatível. Trate-o como uma senha.
- **Usuários de proxy:** **Recarregar do painel** sincroniza os usuários de proxy que você criou ou alterou. **Esquecer neste computador** remove esses usuários deste navegador.

### Quando o Ícone Fica Vermelho

Um ícone vermelho com um número significa que o proxy recusou essa quantidade de conexões no último minuto. Abra o FourA para entender o motivo. As causas mais comuns:

- **Too many connections at once:** o limite de túneis abertos do seu plano. Partes da página carregam novamente conforme as conexões são encerradas.
- **Too many new connections this minute:** o limite do seu plano para novos túneis por minuto. Aguarde um minuto antes de recarregar, pois cada nova tentativa também conta.
- **This period's proxy traffic is used up** ou **Premium traffic is used up:** adicione tráfego na página **Billing** ou aguarde o próximo período.
- **The proxy is not in your plan:** consulte os planos na página **Billing**.
- **The proxy did not accept the password:** o usuário do proxy pode ter sido rotacionado ou excluído no painel. Selecione-o novamente.
- **Another extension controls the proxy:** enquanto outra extensão controlar as configurações de proxy do Chrome, o FourA não roteará nada. Desative essa extensão e, em seguida, desligue e ligue o interruptor.

Os limites atuais do seu plano estão na página [Usage & Limits](https://foura.ai/docs/dashboard/quota).

## Transformar uma Request em uma Chamada de API

1. Abra o DevTools em qualquer página e selecione a aba **FourA**, ao lado de Network (atrás de `»` quando o DevTools estiver estreito). Se o DevTools já estava aberto quando você instalou o FourA, feche-o e abra-o novamente.
2. Recarregue a página. A aba lista as requests da página da mesma forma que a aba Network. A opção **Hide ads and analytics** fica ativada por padrão, e **This site only** mantém apenas as requests do próprio site.
3. Digite um texto exibido na página em **Find in responses** para localizar a request correspondente. Selecione a request para visualizar **Headers**, **Payload** e **Response**.
4. Em **FourA call**, escolha a engine (Single, Proxy Finder ou Browser) e, no caso do Proxy Finder, um **Exit country** opcional; em seguida, copie a chamada como cURL, Python, Node ou MCP. A chamada inclui os headers e cookies utilizados pela página. A opção **Present the same browser and system as this window** fica ativada por padrão: a chamada solicita o perfil de navegador correspondente a este Chrome ou, no modo Browser, envia o User-Agent desta janela.
5. Clique em **Open in the playground** para carregar a chamada no [Playground](https://foura.ai/docs/dashboard/playground) do painel, ou em **Run through FourA** para executá-la. Após a execução, **The browser got** e **FourA got** exibem 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 **Copy URL**, **Copy response** e **Open in a new tab**.

### A Chave de API para Execuções

O botão **Run through FourA** consome uma API key e seus respectivos créditos. Defina-a em **Settings** na aba:

1. Clique em **Choose from your dashboard** e escolha uma chave, ou cole uma chave em **Or paste an API key**.
2. Marque a opção **Keep the key on this computer** para mantê-la salva após o fechamento do Chrome. Caso contrário, ela permanecerá ativa apenas até o Chrome ser fechado.
3. O botão **Forget the key** remove a chave.

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

## Quanto Custa

A extensão é gratuita. O tráfego que ela envia através das nossas saídas conta para o limite de proxy do seu plano, exatamente 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](https://foura.ai/docs/guides/plans-and-metering).

## O Que Ela Armazena e Envia

- O usuário de proxy escolhido e a senha dele permanecem neste computador.
- Uma chave de API escolhida na aba do DevTools permanece até o Chrome fechar, 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 o ipinfo.io (ou Cloudflare e depois api.ipify.org quando este estiver ocupado) para verificar qual endereço o site vê, consulta o foura.ai uma vez por hora e quando você a abre para checar a versão atual, lê seus usuários de proxy e a lista de países do seu painel, e resolve o endereço do proxy via dns.google ou Cloudflare. Todo o resto ocorre apenas quando você clica em um botão.
- Uma chamada copiada com cookies reproduz a sessão na qual você está conectado. Trate-a como uma senha e não a cole em locais públicos.
- Quando você altera uma configuração com o seletor ativado, o FourA limpa as credenciais de proxy salvas no Chrome para que a nova opção alcance o proxy. A limpeza abrange apenas o endereço do próprio proxy: seus cookies permanecem, assim como a sua sessão no painel.

## Limitações

- Seu navegador estabelece sua própria conexão criptografada através do túnel, de forma que o site vê o nosso endereço e o seu navegador. Páginas que verificam quem está fazendo a requisição e renderização completa de navegador são processadas pela API: consulte [Verificações de sites](https://foura.ai/docs/api/site-checks).
- O Chrome é o único navegador para o qual a extensão foi desenvolvida e testada.
