Instalação

Claude Code: Você precisa ter o Claude Code, a ferramenta de programação com IA da Anthropic, instalado e com login feito.

Node.js e um navegador: As verificações carregam as páginas em um navegador no seu próprio computador, então você também precisa do Node.js 24 ou mais recente e do Google Chrome, Microsoft Edge, Brave ou Chromium. Se o seu navegador estiver instalado em um local fora do padrão, defina a variável de ambiente COOKIEPAL_BROWSER com o caminho do executável dele.

Conta: Você não precisa de uma conta da CookiePal para verificar uma página. Ela só é necessária para escanear, instalar e verificar o banner em um site que você administra, e você pode criá-la pelo Claude Code no terceiro passo.

Instale no Claude Code: Abra o Claude Code e execute estes três comandos, um de cada vez.

1/plugin marketplace add cookiepal/cookiepal-plugin
2/plugin install cookiepal@cookiepal
3/reload-plugins

Ou instale pelo terminal: Execute estes dois comandos e depois execute /reload-plugins em qualquer sessão do Claude Code que já esteja aberta.

1claude plugin marketplace add cookiepal/cookiepal-plugin
2claude plugin install cookiepal@cookiepal

Confira a conexão: Execute /mcp no Claude Code. Você deve ver plugin:cookiepal:cookiepal na lista como conectado. Todos os comandos da CookiePal começam com /cookiepal:, então basta digitar isso para ver todos.

Execute o comando: Execute /cookiepal:connect-account. Uma página da CookiePal abre no seu navegador.

1/cookiepal:connect-account

Entre ou cadastre-se: Se você já estiver conectado à CookiePal nesse navegador, clique em Connect e pronto. Se não, entre, continue com o Google ou crie uma conta gratuita, depois volte à página e clique em Connect. Sua senha nunca passa pelo Claude Code.

O que você vê: O Claude informa o e-mail, a organização e o domínio padrão aos quais ele está conectado. Conectar não altera mais nada na sua conta. Depois de conectado, você pode perguntar ao Claude quais domínios sua conta tem ou pedir que ele adicione um novo. Um domínio adicionado assim começa no plano gratuito, e você pode adicionar até 10 por dia.

Pergunta sobre o ID de instalação: Se você aceitou compartilhar um ID de instalação na sua primeira verificação, toda vez que você se conectar o plugin vai perguntar se você quer vinculá-lo a esta conta. A resposta padrão é não, e a conexão funciona de qualquer forma. O vínculo é excluído depois de 180 dias, ou quando você responde não em uma conexão posterior.

Quando usar: Execute /cookiepal:check-one-page com o endereço de uma página para descobrir quais cookies e rastreadores ela define antes de o visitante concordar com qualquer coisa, e o que os botões de aceitar e rejeitar do banner realmente fazem. Funciona com qualquer página que o seu computador consiga acessar, incluindo localhost e sites ainda não publicados.

1/cookiepal:check-one-page https://example.com

Como funciona: A página é carregada três vezes, cada uma em um perfil de navegador temporário e limpo no seu computador. A rodada de chegada registra o que foi definido antes de qualquer clique, a rodada de aceite clica no botão de aceitar do banner e a rodada de rejeição clica no botão de rejeitar. A verificação nunca clica em um botão sobre o qual não tenha certeza: se não encontrar o banner, ou se mais de um botão corresponder, mostra o resultado da rodada de chegada e avisa que os botões não foram testados.

Como ler o resultado: Você recebe cada cookie com sua categoria, cada host de terceiros que a página contatou e o que mudou entre as três rodadas. Preste mais atenção ao que continua rodando depois da rejeição. Em seguida, o resultado explica o que foi encontrado em relação ao GDPR, à CCPA e à CPRA, à LGPD e à Lei 25 do Quebec, com uma resposta separada para cada lei. Ele nunca diz que um site está em conformidade e não é aconselhamento jurídico.

Como escolher o formato: Adicione html, markdown ou terminal depois do endereço para receber um arquivo HTML local, um arquivo Markdown local ou o resultado direto no terminal. Adicione artifact para publicá-lo no claude.ai, o que pede sua confirmação antes e exige um plano pago do claude.ai. Sem formato, a primeira verificação pergunta se você quer publicar no claude.ai. A resposta padrão é não, que mantém o resultado em um arquivo HTML local, e sua resposta fica salva. Os arquivos das suas últimas 20 verificações ficam na pasta de dados do plugin. Executar o comando com um formato e sem endereço torna esse formato o padrão.

ID de instalação: A primeira verificação pergunta se você quer compartilhar um ID de instalação aleatório, para que a CookiePal possa contar pessoas em vez de verificações. A resposta padrão é não, e a verificação funciona de qualquer forma. Execute /cookiepal:check-one-page stop-sharing a qualquer momento para parar de compartilhá-lo, excluir as verificações vinculadas a ele e desvinculá-lo da sua conta da CookiePal.

Quando usar: Execute /cookiepal:run-scan para rastrear um dos seus domínios conectados e atualizar o relatório de cookies dele na CookiePal. O rastreamento roda no seu computador, nunca nos servidores da CookiePal. Ele usa seu domínio padrão, a menos que você informe outro. É preciso ter uma conta conectada e um banner verificado, exceto no primeiro escaneamento de um domínio que você adicionou pelo Claude Code.

1/cookiepal:run-scan

Como ler o resultado: O rastreamento de várias páginas pode levar alguns minutos, e o Claude avisa enquanto ele está em andamento. Ao terminar, o relatório fica salvo na CookiePal marcado como escaneamento local, e o Claude informa quantas páginas e cookies ele abrange. Peça ao Claude para ler o relatório se quiser a lista completa de cookies.

Se for recusado: O escaneamento de um domínio cujo banner não está verificado é recusado, então verifique a instalação primeiro. O escaneamento também é recusado quando o domínio já usou sua cota mensal de escaneamentos: o Claude informa os números, e a cota é renovada no início do mês seguinte. Se o robots.txt do site bloquear o rastreamento, o Claude informa qual página foi bloqueada e o que liberar.

Quando usar: Execute /cookiepal:detect-stack no repositório do seu site para descobrir com qual framework ele foi feito e qual arquivo gera o head da página, sem alterar nada. Ele reconhece Next.js, Nuxt, Astro, Vite, Remix, React Router v7, SvelteKit e temas da Shopify e, se não reconhecer, trata o site como um build personalizado.

1/cookiepal:detect-stack

Como ler o resultado: O Claude informa o framework, o arquivo do head e o sinal que o identificou. Quando ele diz que é um build personalizado, trata-se de uma estimativa a partir do seu HTML, não de um framework reconhecido. Se mais de um arquivo puder ser o do head, ele lista todos e pergunta qual deles as suas páginas no ar usam.

Quando usar: Execute /cookiepal:install-banner no repositório do seu site, depois de conectar seu domínio, para adicionar a tag do banner da CookiePal ao seu código. Ele coloca a tag no head da página o mais cedo que o seu framework permite, para que o banner consiga bloquear scripts antes que eles carreguem.

1/cookiepal:install-banner

Como ler o resultado: O Claude mostra a alteração como um diff e não faz commit dela. Ele nunca faz commit nem push, então revise a alteração, faça o commit e publique seu site como você costuma fazer. Um repositório que já tem a tag fica como está, e, se houver uma tag de outro domínio, ela é sinalizada em vez de o comando adicionar um segundo banner.

Quando usar: Execute /cookiepal:match-site-design no repositório do seu site para dar ao banner cores e uma posição que combinem com ele. O comando lê os seus design tokens, como uma configuração do Tailwind, variáveis CSS ou um arquivo de tema.

1/cookiepal:match-site-design

Como ler o resultado: O Claude propõe as cores e a posição, verificando se cada cor atende ao contraste WCAG AA. Qualquer cor que não passe é ajustada o mínimo necessário, e a alteração é mostrada. Nada é salvo até você dizer que sim. Se o seu repositório não tiver design tokens, o Claude avisa e o banner mantém o estilo atual.

Quando usar: Depois de publicar a alteração, execute /cookiepal:verify-installation para confirmar que o banner está no ar. É preciso ter uma conta conectada, e ele verifica sua página inicial, a menos que você adicione o endereço de outra página, por exemplo /cookiepal:verify-installation https://example.com/shop. Ele carrega sua página em um navegador no seu computador e atualiza o status de instalação do seu domínio na CookiePal. Você também pode usá-lo só para pegar a tag do banner, se preferir colá-la você mesmo.

1/cookiepal:verify-installation

Verificado: O banner está no ar e seu domínio aparece como instalado na CookiePal. Se a página carregar mais de um script de banner da CookiePal, remova o que sobrar, porque dois banners disputam o consentimento.

Falhou: O Claude informa o motivo, como a falta da tag na página ou uma tag de outro domínio. Se a tag estiver lá, mas o banner nunca tiver rodado, normalmente outra ferramenta de consentimento ou uma política de segurança de conteúdo o está bloqueando. Libere o script da CookiePal desse bloqueio em vez de colar a tag de novo.

Inconclusivo: Não foi possível ler a página, por exemplo porque ela retornou um erro, demorou demais ou redirecionou para outro site. Seu status na CookiePal não muda. Corrija a causa e verifique de novo.

Quando usar: Se o seu site usa tags do Google, execute /cookiepal:check-gcm para conferir se o Google Consent Mode está configurado corretamente. É preciso ter uma conta conectada, e ele lê sua página inicial, a menos que você adicione o endereço de outra página. A página é lida no seu computador, e o resultado atualiza o status de Consent Mode do seu domínio na CookiePal. Execute quantas vezes precisar enquanto corrige um problema: cada verificação substitui a anterior.

1/cookiepal:check-gcm

Como ler o resultado: O Claude diz que o Consent Mode está configurado corretamente ou aponta um destes três problemas, com a correção: o Consent Mode não foi encontrado na página, os valores padrão não estão definidos, ou estão definidos tarde demais para ter efeito. O problema continua no seu domínio na CookiePal até que uma verificação passe.

As páginas são carregadas no seu computador: A CookiePal nunca carrega suas páginas. Os cookies são categorizados no seu computador com base no catálogo de cookies de código aberto da CookiePal, e a verificação nunca abre o seu próprio perfil de navegador, então seus cookies e logins nunca são lidos.

Uma verificação de página envia: o endereço da página sem a query string; o nome, domínio, caminho, validade, flags e categoria de cada cookie, mas nunca o valor dele; os hosts de terceiros; o que os botões de aceitar e rejeitar fizeram; a versão do plugin; o país de onde a verificação foi feita, deduzido do seu endereço IP, que não é armazenado; e um ID de instalação aleatório só se você aceitou compartilhá-lo.

Os outros comandos enviam só o que precisam, quando você os executa: a verificação da instalação envia o script da CookiePal encontrado na página, um escaneamento envia o número de páginas e os dados de cada cookie sem os valores, uma verificação do Consent Mode envia os nomes das entradas de consentimento e as alterações no banner enviam as configurações que você pediu. As alterações no banner entram no ar na hora, então o Claude Code pede que você confirme cada uma antes.

Todos os detalhes: As verificações salvas são excluídas após 180 dias. Leia o aviso de privacidade para saber tudo o que o plugin envia e guarda, e os termos de serviço do serviço hospedado.

Atualizar: Execute estes comandos no terminal e depois execute /reload-plugins em qualquer sessão do Claude Code que já esteja aberta.

1claude plugin marketplace update cookiepal
2claude plugin update cookiepal@cookiepal

Desinstalar: Execute estes comandos para remover o plugin por completo. Desinstalar também remove o ID de instalação do seu computador, mas não as verificações vinculadas a ele, então execute /cookiepal:check-one-page stop-sharing antes se quiser excluí-las.

1claude plugin uninstall cookiepal@cookiepal
2claude plugin marketplace remove cookiepal

Os comandos não aparecem: Execute /reload-plugins e depois /mcp, e confira se plugin:cookiepal:cookiepal aparece como conectado.

Nenhum navegador foi encontrado: Instale o Google Chrome, Microsoft Edge, Brave ou Chromium, ou defina COOKIEPAL_BROWSER com o caminho do executável do navegador que você tem.

O login não abre: Execute /mcp, escolha cookiepal, escolha Authenticate e execute /cookiepal:connect-account de novo.

Ainda com problemas: Envie um e-mail para support@cookiepal.io com o comando que você executou e o que o Claude respondeu.