Instalación

Claude Code: Necesitas tener Claude Code, la herramienta de programación con IA de Anthropic, instalado y con la sesión iniciada.

Node.js y un navegador: Las revisiones cargan las páginas en un navegador de tu propio equipo, así que también necesitas Node.js 24 o posterior y Google Chrome, Microsoft Edge, Brave o Chromium. Si tu navegador está instalado en una ubicación poco habitual, define la variable de entorno COOKIEPAL_BROWSER con la ruta de su ejecutable.

Cuenta: No necesitas una cuenta de CookiePal para revisar una página. Solo la necesitas para analizar, instalar y verificar el banner en un sitio web que gestionas, y puedes crearla desde Claude Code en el tercer paso.

Instálalo en Claude Code: Abre Claude Code y ejecuta estos tres comandos, uno por uno.

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

O instálalo desde tu terminal: Ejecuta estos dos comandos y después ejecuta /reload-plugins en cualquier sesión de Claude Code que ya esté abierta.

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

Comprueba la conexión: Ejecuta /mcp en Claude Code. Deberías ver plugin:cookiepal:cookiepal en la lista como conectado. Todos los comandos de CookiePal empiezan por /cookiepal:, así que al escribirlo se muestran todos.

Ejecuta el comando: Ejecuta /cookiepal:connect-account. Se abre una página de CookiePal en tu navegador.

1/cookiepal:connect-account

Inicia sesión o regístrate: Si ya has iniciado sesión en CookiePal en ese navegador, pulsa Connect y listo. Si no, inicia sesión, continúa con Google o crea una cuenta gratuita, y después vuelve a la página y pulsa Connect. Tu contraseña nunca pasa por Claude Code.

Lo que verás: Claude te indica el correo electrónico, la organización y el dominio predeterminado con los que se ha conectado. Conectarte no cambia nada más en tu cuenta. Una vez conectado, puedes preguntarle a Claude qué dominios tiene tu cuenta o pedirle que añada uno nuevo. Un dominio añadido así empieza en el plan gratuito, y puedes añadir hasta 10 al día.

Pregunta sobre el ID de instalación: Si aceptaste compartir un ID de instalación en tu primera revisión, cada vez que te conectas se te pregunta si quieres vincularlo a esta cuenta. La respuesta predeterminada es no, y la conexión funciona en ambos casos. El vínculo se elimina a los 180 días, o cuando respondes que no en una conexión posterior.

Cuándo usarlo: Ejecuta /cookiepal:check-one-page con la dirección de una página para saber qué cookies y rastreadores coloca una página antes de que el visitante acepte nada, y qué hacen realmente los botones de aceptar y rechazar de su banner. Funciona con cualquier página a la que pueda acceder tu equipo, incluidos localhost y los sitios aún no publicados.

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

Cómo funciona: La página se carga tres veces, cada una en un perfil de navegador temporal y limpio de tu equipo. La pasada inicial registra lo que se colocó antes de hacer clic en nada, la pasada de aceptación pulsa el botón de aceptar del banner y la pasada de rechazo pulsa su botón de rechazar. La revisión nunca pulsa un botón del que no esté segura: si no encuentra el banner, o si coincide más de un botón, muestra los resultados de la pasada inicial e indica que los botones no se probaron.

Cómo leer el resultado: Obtienes cada cookie con su categoría, cada host de terceros con el que contactó la página y lo que cambió entre las tres pasadas. Presta especial atención a lo que sigue activo después de rechazar. A continuación, el resultado explica lo encontrado con respecto al RGPD, la CCPA y la CPRA, la LGPD y la Ley 25 de Quebec, con una respuesta independiente para cada ley. Nunca afirma que un sitio web cumpla la normativa, y no constituye asesoramiento legal.

Elige el formato: Añade html, markdown o terminal después de la dirección para obtener un archivo HTML local, un archivo Markdown local o el resultado directamente en tu terminal. Añade artifact para publicarlo en claude.ai, lo que te pide confirmación antes y requiere un plan de pago de claude.ai. Sin formato, la primera revisión te pregunta si quieres publicarlo en claude.ai. La respuesta predeterminada es no, que lo guarda en un archivo HTML local, y tu respuesta se recuerda. Los archivos de tus últimas 20 revisiones se guardan en la carpeta de datos del plugin. Si ejecutas el comando con un formato y sin dirección, ese formato pasa a ser el predeterminado.

ID de instalación: La primera revisión te pregunta si quieres compartir un ID de instalación aleatorio, para que CookiePal pueda contar personas en lugar de revisiones. La respuesta predeterminada es no, y la revisión funciona en ambos casos. Ejecuta /cookiepal:check-one-page stop-sharing en cualquier momento para dejar de compartirlo, eliminar las revisiones asociadas a él y desvincularlo de tu cuenta de CookiePal.

Cuándo usarlo: Ejecuta /cookiepal:run-scan para rastrear uno de tus dominios conectados y actualizar su informe de cookies en CookiePal. El rastreo se ejecuta en tu equipo, nunca en los servidores de CookiePal. Usa tu dominio predeterminado, salvo que indiques otro. Necesita una cuenta conectada y un banner verificado, salvo en el primer análisis de un dominio que añadiste desde Claude Code.

1/cookiepal:run-scan

Cómo leer el resultado: El rastreo de varias páginas puede tardar unos minutos, y Claude te avisa de que está en curso. Cuando termina, el informe se guarda en CookiePal marcado como análisis local, y Claude indica cuántas páginas y cookies abarca. Pídele a Claude que te lea el informe para ver la lista completa de cookies.

Si se rechaza: Se rechaza el análisis de un dominio cuyo banner no está verificado, así que primero verifica la instalación. También se rechaza cuando el dominio ha agotado su cuota mensual de análisis: Claude te indica las cifras, y la cuota se renueva a principios del mes siguiente. Si el robots.txt del sitio web bloquea el rastreo, Claude te indica qué página se bloqueó y qué debes permitir.

Cuándo usarlo: Ejecuta /cookiepal:detect-stack en el repositorio de tu sitio web para saber con qué framework está hecho y qué archivo genera el head de la página, sin cambiar nada. Reconoce Next.js, Nuxt, Astro, Vite, Remix, React Router v7, SvelteKit y los temas de Shopify, y si no, lo trata como un desarrollo propio.

1/cookiepal:detect-stack

Cómo leer el resultado: Claude indica el framework, el archivo del head y la señal que lo delató. Cuando dice que es un desarrollo propio, es una estimación a partir de tu HTML, no un framework reconocido. Si más de un archivo podría ser el del head, los enumera y te pregunta cuál usan tus páginas publicadas.

Cuándo usarlo: Ejecuta /cookiepal:install-banner en el repositorio de tu sitio web, una vez conectado tu dominio, para añadir la etiqueta del banner de CookiePal a tu código. Coloca la etiqueta en el head de la página lo antes que permita tu framework, para que el banner pueda bloquear los scripts antes de que se carguen.

1/cookiepal:install-banner

Cómo leer el resultado: Claude muestra el cambio como un diff y lo deja sin hacer commit. Nunca hace commit ni push, así que revisa el cambio, haz el commit y publica tu sitio web como lo haces normalmente. Un repositorio que ya tiene la etiqueta se deja tal cual, y si hay una etiqueta de otro dominio, se señala y no se añade un segundo banner.

Cuándo usarlo: Ejecuta /cookiepal:match-site-design en el repositorio de tu sitio web para dar al banner colores y una posición que encajen con tu sitio. Lee tus design tokens, como una configuración de Tailwind, variables CSS o un archivo de tema.

1/cookiepal:match-site-design

Cómo leer el resultado: Claude propone los colores y la posición, comprobando que cada color cumpla el nivel de contraste WCAG AA. Cualquier color que no lo cumpla se ajusta lo mínimo necesario, y se muestra el cambio. No se guarda nada hasta que digas que sí. Si tu repositorio no tiene design tokens, Claude te lo indica y tu banner mantiene su estilo actual.

Cuándo usarlo: Una vez publicado tu cambio, ejecuta /cookiepal:verify-installation para confirmar que el banner está activo. Necesita una cuenta conectada y revisa tu página de inicio, salvo que añadas la dirección de otra página, por ejemplo /cookiepal:verify-installation https://example.com/shop. Carga tu página en un navegador de tu equipo y actualiza el estado de instalación de tu dominio en CookiePal. También puedes usarlo solo para obtener la etiqueta de tu banner, si prefieres pegarla tú.

1/cookiepal:verify-installation

Verificado: El banner está activo y tu dominio aparece como instalado en CookiePal. Si la página carga más de un script de banner de CookiePal, elimina el que sobra, porque dos banners compiten por el consentimiento.

Fallido: Claude indica el motivo, como que falta la etiqueta en la página o que es la etiqueta de otro dominio. Si la etiqueta está pero el banner nunca se ejecutó, normalmente lo bloquea otra herramienta de consentimiento o una política de seguridad de contenido. Excluye el script de CookiePal de ese bloqueo en lugar de volver a pegar la etiqueta.

No concluyente: No se pudo leer la página, por ejemplo porque devolvió un error, tardó demasiado o redirigió a otro sitio web. Tu estado en CookiePal no cambia. Corrige la causa y vuelve a verificar.

Cuándo usarlo: Si tu sitio web usa etiquetas de Google, ejecuta /cookiepal:check-gcm para comprobar que Google Consent Mode está bien configurado. Necesita una cuenta conectada y lee tu página de inicio, salvo que añadas la dirección de otra página. La página se lee en tu equipo y el resultado actualiza el estado de Consent Mode de tu dominio en CookiePal. Ejecútalo tantas veces como necesites mientras corriges un problema: cada revisión sustituye a la anterior.

1/cookiepal:check-gcm

Cómo leer el resultado: Claude te dice que Consent Mode está bien configurado o te indica uno de estos tres problemas con su solución: no se encontró Consent Mode en la página, sus valores predeterminados no están definidos o se definen demasiado tarde para tener efecto. El problema se mantiene en tu dominio en CookiePal hasta que una revisión salga bien.

Las páginas se cargan en tu equipo: CookiePal nunca carga tus páginas. Las cookies se clasifican en tu equipo con el catálogo de cookies de código abierto de CookiePal, y la revisión nunca abre tu propio perfil de navegador, así que tus cookies y sesiones nunca se leen.

Una revisión de página envía: la dirección de la página sin su cadena de consulta; el nombre, dominio, ruta, caducidad, atributos y categoría de cada cookie (nunca su valor); los hosts de terceros; lo que hicieron los botones de aceptar y rechazar; la versión del plugin; el país desde el que se hizo la revisión, deducido de tu dirección IP (que no se guarda), y un ID de instalación aleatorio solo si aceptaste compartirlo.

Los demás comandos envían solo lo que necesitan, cuando los ejecutas: la verificación envía el script de CookiePal encontrado en la página, un análisis envía el número de páginas y los datos de cada cookie sin valores, una revisión de Consent Mode envía los nombres de sus entradas de consentimiento y los cambios del banner envían la configuración que pediste. Los cambios del banner se aplican de inmediato, así que Claude Code te pide que confirmes cada uno antes.

Todos los detalles: Las revisiones guardadas se eliminan a los 180 días. Lee el aviso de privacidad para conocer todo lo que el plugin envía y guarda, y los términos del servicio que rigen el servicio alojado.

Actualizar: Ejecuta estos comandos en tu terminal y después ejecuta /reload-plugins en cualquier sesión de Claude Code que ya esté abierta.

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

Desinstalar: Ejecuta estos comandos para eliminar el plugin por completo. Al desinstalarlo también se elimina el ID de instalación de tu equipo, pero no las revisiones asociadas a él, así que ejecuta primero /cookiepal:check-one-page stop-sharing si quieres eliminarlas.

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

Los comandos no aparecen: Ejecuta /reload-plugins y después /mcp, y comprueba que plugin:cookiepal:cookiepal aparece como conectado.

No se encontró ningún navegador: Instala Google Chrome, Microsoft Edge, Brave o Chromium, o define COOKIEPAL_BROWSER con la ruta del ejecutable del navegador que tengas.

No se abre el inicio de sesión: Ejecuta /mcp, elige cookiepal, elige Authenticate y vuelve a ejecutar /cookiepal:connect-account.

¿Sigues con problemas?: Escribe a support@cookiepal.io con el comando que ejecutaste y lo que respondió Claude.