O site que não tem API

O que é e porque importa

As horas que perdes a sério são quase sempre num site, não no código. O estúdio de uma rede social onde agendas os posts, o App Store Connect, o CRM, o back office do software de gestão. Painéis onde já tens sessão iniciada, que não têm API, ou têm uma que não chega para o que precisas. Então de cada vez és tu que clicas: carregar, escrever, escolher, verificar.

O Claude in Chrome resolve isto. É uma extensão do browser que o Claude Code usa para conduzir o teu Chrome, o verdadeiro, com as tuas sessões. Abre um separador novo, lê a página, clica, escreve, carrega ficheiros do teu computador e verifica o resultado. Vês-lo mexer-se em tempo real. Quando encontra uma página de login ou um captcha, para e pergunta-te.

Nós usamo-lo todos os dias para agendar os carrosséis da STRIKT numa rede social: carrega os slides, escreve a descrição, escolhe os hashtags do menu, põe data e hora e depois verifica na lista que o post lá está. O segredo não é a extensão. É o procedimento escrito num ficheiro, que o agente volta a ler sempre. Este guia é para quem tem um painel que lhe come horas: no fim vais ter a extensão ligada e o teu procedimento pronto.

1. O que precisas e como o ligas

• Google Chrome ou Microsoft Edge. O Claude Code também reconhece a extensão noutros browsers baseados em Chromium, como Brave, Arc, Vivaldi e Opera. Não funciona no WSL, o Linux dentro do Windows.
• A extensão Claude in Chrome da Chrome Web Store, na versão mais recente, e o Claude Code atualizado.
• Um plano Anthropic direto: Pro, Max, Team ou Enterprise. Tens de entrar no Claude Code com /login: se usas uma chave de API, ou o Claude através do Amazon Bedrock, Google Cloud ou Microsoft Foundry, a integração com o Chrome fica desligada. Desde julho de 2026 já não está em pré-visualização.

1. Instala a extensão e entra com a mesma conta, e a mesma organização, que usas no Claude Code. Se forem diferentes, o Claude diz-te que a extensão não está ligada.
2. No terminal, corre claude --chrome. Da primeira vez aparece uma janela que explica como funcionam as permissões por site: carrega em Enter.
3. Escreve /chrome. Funciona se vires «Status: Enabled» e «Extension: Installed». Daqui também geres as permissões, voltas a ligar a extensão e escolhes o browser se tiveres mais do que um.
4. Se a extensão não for encontrada à primeira, fecha e volta a abrir o Chrome: só lê a configuração do Claude Code ao arrancar.

No /chrome também há «Enabled by default», para não escreveres --chrome sempre. Eu deixo-o desligado: mantém as ferramentas do browser sempre carregadas, e elas gastam contexto.

2. As permissões: o que faz sozinho e onde para

Antes de uma ação no browser, o Claude Code pode pedir-te autorização. O pedido começa com «Claude in Chrome wants to» e oferece-te permitir todas as ações nesse site durante a sessão. As permissões por site, por sua vez, estão nas definições da extensão: é aí que decides em que sites pode navegar, clicar e escrever. Nos planos Team e Enterprise o administrador pode limitar os sites com uma lista.

• Carrega ficheiros do teu computador: até 10 MB no total por cada carregamento. Recusa ficheiros com nomes de credenciais, como .env, .pem, .key ou o que estiver dentro de .ssh, e os que não tem permissão para ler.
• Logins e captchas: para e pede-te para tratares tu disso. Não lhe dês palavras-passe: entras tu, uma vez, no teu Chrome.
• Nas sessões longas a ligação pode adormecer: /chrome e depois «Reconnect extension».

A app de desktop do Claude também tem um browser integrado, mas usa um perfil limpo, sem as tuas sessões: a documentação indica-o para os sites que não precisam de ti, e o Claude in Chrome para agir como tu. Connosco, no browser integrado, carregar ficheiros no estúdio da rede social não funcionava.

3. Escreve o procedimento uma vez

Aqui está a diferença entre um agente que às vezes acerta e um com que podes contar. Da primeira vez fazes o percurso com ele e observas. Depois pedes-lhe que escreva num ficheiro o que funcionou: clique a clique, o que verificar no fim e cada armadilha em que caíram. A partir da vez seguinte dizes-lhe só «lê o procedimento e segue-o».

O nosso chama-se PUBBLICARE.md («publicar» em italiano) e está dividido em seis partes: preparar os ficheiros, carregar, textos, som, definições, depois. Aqui está a mesma estrutura tornada genérica, para adaptares ao teu painel. Troca as partes entre < > e tira os símbolos.

# Publicar em <nome do site> (procedimento que funciona)

Ferramenta: Claude in Chrome, perfil do Chrome <qual>, já com sessão iniciada como <que conta>.
Se encontrares um login ou um captcha: para e chama-me.

## 1. Preparar
- Os ficheiros estão em <pasta>. Ordem: <como estão numerados>.

## 2. Carregar
1. Abre <endereço exato da página de carregamento>.
2. Carrega <todos os ficheiros, por ordem>.
3. Verifica na pré-visualização que a ordem está certa.

## 3. Textos
- Título: <comprimento máximo, o que leva>.
- Descrição: <regras>.
- Tags: <como se inserem para contarem a sério>.

## 4. Definições
- <data e hora, visibilidade, opções a deixar como estão>.
- Antes do botão final mostra-me um resumo: <o que depois já não se pode mudar>.

## 5. Verificação final
- Abre <a página com a lista> e verifica que <a linha com data e hora> lá está.

## Armadilhas conhecidas
- <a armadilha>: <como se evita>.

As armadilhas são a parte que vale mais, porque são as que um agente novo repetiria. Estas são as nossas, tiradas do procedimento real:

• Os hashtags. Se os colares todos de uma vez ficam como texto simples e não contam. É preciso escrever #palavra, esperar uns segundos pelo menu de sugestões e escolhê-lo com Enter, um de cada vez. No fim o agente verifica que cada um passou a ser um elemento à parte, não texto.
• O campo de carregamento escondido. Alguns sites escondem o campo dos ficheiros atrás de um botão. No procedimento está escrito como torná-lo visível para o agente, para carregar todos os ficheiros por ordem de uma só vez.
• A hora que desliza. O seletor da hora é uma lista que desliza: clica-se na hora, depois nos minutos, e depois verifica-se com um zoom que o campo mostra a hora certa.
• O post agendado não se altera. Na nossa rede social um post agendado só se pode apagar, não corrigir. Por isso a verificação faz-se antes do botão final, não depois.

4. Os prompts para copiar

Abre o Chrome em [endereço do painel]. Quero [o quê: agendar um post, atualizar uma ficha, carregar um ficheiro]. Fá-lo um passo de cada vez e diz-me o que vês antes de cada clique que não se pode desfazer. Se encontrares um login ou um captcha, para e chama-me. Não carregues no botão final: espera pela minha autorização.

Escreve em docs/PUBLICAR.md o procedimento que acabámos de fazer, clique a clique: o endereço exato de cada página, o que vai em cada campo, o que verificar no fim e cada armadilha em que caímos, com a maneira certa de a evitar. Nada de palavras-passe, emails ou chaves no ficheiro.

Lê docs/PUBLICAR.md e segue-o para [a pasta de hoje]. Antes do botão final mostra-me um resumo: ficheiros carregados e por que ordem, textos, tags, data e hora. Depois, abre a lista e verifica que o resultado lá está.

Hoje correu mal isto: [o quê]. Reescreve o ponto certo de docs/PUBLICAR.md para não voltar a acontecer. Não acrescentes uma nota no fim: corrige a regra onde ela está.

5. As regras do site vêm primeiro

Antes de automatizar um site, lê as condições de utilização dele sobre automação. Cada plataforma tem as suas regras, mudam com o tempo, e algumas limitam ou proíbem ferramentas automáticas. Se um site diz que não, não o faças. Eu uso-o nas minhas próprias contas, para coisas que faria à mão, uma de cada vez, ao ritmo de uma pessoa.

E continua a ser uma ferramenta que age no teu lugar. A própria Anthropic escreve que, mesmo com os seus controlos de segurança, o Claude in Chrome tem riscos. Dá-lhe só os sites de que precisas, mantém-no longe dos que mexem no teu dinheiro, e faz com que pare antes de cada clique que não se desfaz até o procedimento ter corrido limpo várias vezes.

Os erros mais comuns

• Colar todos os hashtags de uma vez. Ficam como texto simples: têm de ser escolhidos um a um no menu de sugestões.
• Não escrever o procedimento. Sem ficheiro, o agente recomeça do zero de cada vez e erra de cada vez num ponto novo.
• Confiar no «feito». Sem a verificação final na lista, uma gravação falhada parece igual a uma bem-sucedida.
• Usar o perfil do Chrome errado. Se tens vários perfis, escreve no procedimento qual usar: o agente trabalha com as sessões desse perfil.
• Automatizar sem ter lido as regras do site. Se a plataforma não o permitir, arriscas a conta.

Checklist

• A extensão Claude in Chrome está instalada, com a mesma conta e organização do Claude Code
• /chrome mostra «Status: Enabled» e «Extension: Installed»
• Li as regras do site sobre automação
• O procedimento está num ficheiro, com a verificação final e as armadilhas conhecidas
• No ficheiro do procedimento não há palavras-passe, emails da conta nem chaves
• O agente mostra-me um resumo antes do botão final

Perguntas frequentes