Uma extensão age conforme as permissões do perfil onde foi instalada. CDP se conecta a um endereço de depuração e depois seleciona um alvo. Para usar uma página já autenticada, confirme o perfil e a aba que o conector consegue alcançar. O mesmo endereço pode mostrar estados diferentes em perfis distintos.
Um desenvolvedor esperava um perfil autenticado, mas o conector abriu outro navegador. Outro relatou impacto do Chrome 136 numa ferramenta de extensões que usava CDP. São falhas diferentes: sessão errada e caminho de conexão indisponível. r/ClaudeAI · r/Playwright
Pontos principais
Avalie uma extensão aprovada para usar uma aba autenticada com supervisão humana.
Use CDP direto com um perfil dedicado para tarefas repetidas que controlam a abertura e o encerramento do navegador.
Uma extensão pode usar CDP internamente. Verifique quem concede permissões e quem consegue se conectar.
Antes de alterar dados, confira a permissão ou o endereço, o espaço exibido e o resultado esperado.
Como a conexão começa
A extensão é instalada no perfil. O manifesto e as permissões concedidas definem as APIs e os sites disponíveis. Um conector pode solicitar uma aba ou usar activeTab. Essa autorização temporária começa com uma ação do usuário e geralmente acaba ao fechar a aba ou mudar de origem. Confira os direitos concretos.
Permissões de extensões · Permissão activeTab · Conexões do Playwright · API de depuração de extensões
Separe transporte e autorização
Uma extensão pode usar a API de depuração se tiver a permissão adequada. Alguns conectores a usam como ponte. Compare como os direitos são dados, como o alvo é escolhido e quem consegue chegar até ele.
Na implantação, verifique quem pode chamar o conector, quais ações o navegador permite e qual conta está aberta. A API de depuração das extensões do Chrome permite apenas alguns domínios CDP. O endpoint direto tem seus próprios controles de acesso. A escolha de uma aba em um cliente não restringe os pedidos de outros clientes com acesso ao mesmo endpoint. Chrome debugger
Para uma sessão supervisionada, siga as etapas para Conectar um navegador existente. Os guias Navegador para agente e Agente de navegador descrevem ferramentas que podem acompanhar a conexão.
Onde o CDP se conecta
O endereço ou URL WebSocket aponta para uma instância preparada para depuração. Ele não indica a janela ativa no desktop. Depois de conectar, enumere os alvos e confira a aba e o estado visível. Versões e políticas de empresa podem restringir o acesso.
Protocolo CDP · Mudança na depuração do Chrome
A partir do Chrome 136, as opções de depuração remota por porta ou canal exigem um diretório de dados diferente do padrão no Chrome. Para automação, o Chrome recomenda o Chrome for Testing. Em ambientes remotos, use um canal privado e restrinja o acesso. O endereço de loopback pertence à máquina que executa o navegador. Chrome
| Decisão | Extensão | CDP |
|---|---|---|
| Aprovação inicial | Rever permissões de API e site | Aprovar o endereço e dono do perfil |
| Alvo | Confirmar a aba autorizada | Listar alvos e conferir estado |
| Encerramento | Revogar acesso ou fechar o escopo | Fechar navegador e endereço próprios |
Se a falha for intermitente, investigue a inicialização e a conexão separadamente. Consulte Automação web para o fluxo geral e Depurar com DevTools para examinar a página.
Quais sites a permissão cobre
A imagem arquivada ilustra a autorização pelo nome do host. O script leu um marcador fictício em 127.0.0.1 e recebeu uma negativa em localhost. Os dois nomes acessavam o mesmo serviço, mas o manifesto autorizava apenas um deles. O alcance depende do manifesto de cada extensão.
{
"manifest_version": 3,
"permissions": ["scripting"],
"host_permissions": ["http://127.0.0.1/*"]
}
Como conferir o perfil da conexão CDP
A segunda imagem de arquivo mostra um marcador fictício em um perfil dedicado. Se duas instâncias abrirem a mesma URL, compare o nome exibido do espaço de trabalho com o esperado antes de editar. A resposta do endpoint confirma que ele está disponível. Confira também a aba.
Se tarefas recorrentes usam perfis nomeados, veja como selecionar a sessão em Sessões do agent-browser.
Escolha por supervisão e exposição
Para tarefas supervisionadas, avalie uma extensão aprovada com acesso restrito a sites e escolha de aba. Para QA autônomo, use um navegador dedicado e transporte local ou gerenciado. Feche a sessão no fim. O loopback de um executor remoto indica a máquina dele.
| Cenário | Opção a avaliar | Primeira verificação |
|---|---|---|
| Pessoa supervisiona uma aba | Extensão aprovada e limitada | Aba visível e sites permitidos |
| QA repetível em segundo plano | Navegador CDP dedicado | Localização e perfil temporário |
| Política bloqueia acesso | Implantação aprovada | Permissão e conta de teste |
Planeje as tarefas sem supervisão com Agente de automação e revise permissões e aprovações com Segurança dos agentes.
Verifique antes de alterar dados
Confira domínio, aba e marcador visível. Saiba quem pode alcançar o ponto de depuração ou ampliar permissões. Se houver bloqueio, use a opção aprovada pelo administrador. Depois da ação, confirme o resultado na página.
Registre antes e depois
Anote o dono, o site permitido e o marcador esperado. Faça uma leitura para confirmar e confira de novo após agir. Se o alvo ou a permissão falhar, pare antes de gravar.
Use o Checklist da primeira tarefa para testar em modo somente leitura antes de conceder acesso de escrita.
Perguntas frequentes
Uma extensão vê todas as abas?
Depende dos direitos, das permissões por site e das políticas.
CDP conecta à janela que estou vendo?
Ele conecta ao endereço configurado. Depois você escolhe o alvo.
Uma URL pode mostrar dois estados?
Sim. Perfis distintos podem guardar cookies ou dados diferentes para a mesma URL. Confira o espaço de trabalho ou a conta exibida antes de fazer alterações.
O que mudou no Chrome 136?
O Chrome documentou que os parâmetros de depuração não funcionam no diretório padrão de dados.
E se a empresa bloquear a depuração?
Use o conector ou ambiente aprovado pelo administrador.
O que guardar como evidência?
Registre rota, aba ou perfil, escopo, estado e fechamento, sem dados pessoais.