Mira los anuncios de tu competencia y descubre qué lanzar.

Tu competencia ya probó por ti. Aprovéchalo.

Cada anuncio que corre en Facebook e Instagram queda guardado en la Biblioteca de anuncios de Meta, a la vista de cualquiera. El problema es leerla: cientos de anuncios por marca, sin resultados y sin orden. /spy hace ese trabajo por ti: lee tu marca, encuentra a tus competidores, baja sus anuncios con imágenes y textos, y te dice qué les funciona, qué apagaron rápido y qué deberías hacer en tu cuenta.

La diferencia con mirar la biblioteca a mano es que primero entiende tu marca: qué vendes, a qué precio, a quién le hablas y cómo. Por eso las conclusiones no son genéricas. Los anuncios que te propone usan tu oferta y tus precios reales, y cada uno cita los anuncios de la competencia que lo inspiraron.

Sirve para cualquier negocio que tenga competidores anunciando en Facebook o Instagram: tiendas online, marcas de producto, cursos, servicios, apps o locales. Funciona en cualquier país que tenga anuncios en la biblioteca y escribe el informe en tu idioma.

Tres programas y tu plan de Claude

Se instalan una sola vez. Si ya programas con Claude Code, seguramente tienes casi todo. En la sección siguiente tienes los comandos para instalar cada uno.

Si todavía no tienes Claude Code

Instálalo con el comando de tu sistema y después escribe claude en la terminal para iniciar sesión con tu cuenta. Si prefieres no usar la terminal, descarga la app de escritorio de Claude desde claude.com: trae Claude Code adentro.

# Windows, en PowerShell
$ irm https://claude.ai/install.ps1 | iex
# Mac y Linux, en la Terminal
$ curl -fsSL https://claude.ai/install.sh | bash

Elige tu camino según tu computadora

Las tres primeras formas son con la terminal y llevan un par de minutos. Si nunca abriste una terminal, la de "Desde Claude" es para ti: se lo pides a Claude y lo instala solo. En todos los casos el skill queda en la carpeta .claude/skills/spy de tu usuario.

$ winget install -e --id OpenJS.NodeJS.LTS --accept-source-agreements --accept-package-agreements
$ winget install -e --id Git.Git --accept-source-agreements --accept-package-agreements
$ winget install -e --id Google.Chrome --accept-source-agreements --accept-package-agreements

$ git clone https://github.com/paidbyfacu/spy "$env:USERPROFILE\.claude\skills\spy"
$ npm.cmd install --prefix "$env:USERPROFILE\.claude\skills\spy\scripts"

$ xcode-select --install
$ node --version

$ git clone https://github.com/paidbyfacu/spy ~/.claude/skills/spy
$ npm install --prefix ~/.claude/skills/spy/scripts

$ sudo apt install -y git curl
$ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
$ source ~/.bashrc && nvm install --lts
$ node --version

$ git clone https://github.com/paidbyfacu/spy ~/.claude/skills/spy
$ npm install --prefix ~/.claude/skills/spy/scripts

$ cd ~/.claude/skills/spy/scripts
$ npx playwright-core install --with-deps chromium

Comprueba que quedó

1. Abre un chat nuevo de Claude Code y escribe /. En la lista de comandos tiene que aparecer spy.
2. Si quieres probar los scripts, corre el de abajo en la terminal: tiene que mostrar la lista de comandos que empieza con "Uso:". Si dice que falta playwright-core, repite el comando de npm.

# Windows
$ node "$env:USERPROFILE\.claude\skills\spy\scripts\scrape.mjs"
# Mac y Linux
$ node ~/.claude/skills/spy/scripts/scrape.mjs

Un comando con tu marca

Escribe /spy y listo: antes de preguntarte nada busca lo que Claude Code ya sabe de tu marca, y te pregunta solo lo que falta. Si prefieres darle los datos de entrada, sigue con tu Instagram, tu web y lo que vendes, separados por comas:

> /spy instagram.com/tumarca, web: tumarca.com, nicho: lo que vendes

Cómo escribir cada dato

El orden no importa y todo es opcional. Lo que no escribas lo busca en tu proyecto, en tu Instagram y en tu web, y si no lo encuentra te lo pregunta. Si le das solo tu Instagram o solo tu web, busca el otro.

Lo que ya sabe de tu marca

Antes de preguntarte nada, junta lo que Claude Code tiene a mano sobre tu marca. Usa el primer lugar donde aparece cada dato, en este orden:

Las preguntas que te hace

Solo te pregunta lo que no encontró, en tarjetas con opciones armadas con lo que leyó de tu marca. La opción más probable va primera y dice de dónde salió, y siempre puedes escribir otra respuesta. Son tres tarjetas como máximo, y muchas veces una sola:

Tus respuestas quedan en el perfil de tu marca y no te las vuelve a preguntar. Lo que dedujo sin que lo confirmes aparece en la pestaña Tu marca del informe, en una línea de supuestos, para que veas de dónde salió cada cosa.

Así se ve una corrida

✳ Recreación de una corrida real, con el nombre de la marca cambiado. Los mensajes exactos varían según tu marca.

Siete pasos, de tu marca al plan

Claude dirige y unos scripts hacen el trabajo pesado con el navegador. Todo queda guardado en tu computadora, en la carpeta Documentos/spy, con una carpeta por marca y por fecha.

Cinco pestañas, una pregunta cada una

Fondo blanco, los azules de Meta y todo con botones: saltas de una pestaña a otra, filtras anuncios y tocas cualquier miniatura para verla en grande. Se lee bien en el teléfono y en la computadora. Toca cada pestaña para ver cómo queda:

Resumen Tu marca Competencia Anuncios Qué hacer

La conclusión más importante en una frase, los números clave y los hallazgos, cada uno con los anuncios que lo prueban.

INFORME · RESUMEN

Lo que se ve de tu marca desde afuera: tu Instagram, tu web, tu oferta y tus anuncios activos, más tu objetivo y tu presupuesto si se los diste. Debajo, una línea dice qué dedujo sin que se lo confirmes. Si algo está mal entendido, se lo dices a Claude y lo corrige.

INFORME · TU MARCA

Una ficha por competidor: cuántos anuncios tiene activos, cuántos subió en la semana, cuánto le duran, a dónde manda el tráfico, qué le funciona y qué probó y apagó.

INFORME · COMPETENCIA

Todos los anuncios en tarjetas grandes como en el feed, con el texto completo y, arriba, una nota de por qué importa cada uno. Filtras por marca y por tipo, y los ordenas como quieras.

INFORME · ANUNCIOS

Qué cambiar en tu cuenta publicitaria, los anuncios listos para lanzar y un plan de prueba en orden. Cada punto muestra los anuncios reales en los que se basa.

INFORME · QUÉ HACER

Los anuncios que te propone

Es la parte más útil. Cada anuncio se ve como quedaría en el feed, con tu nombre, tu texto y la idea para la creatividad. Al lado tienes por qué conviene, los anuncios reales que lo inspiraron y un botón para copiar el texto y pegarlo directo en el Administrador de anuncios.

INFORME · ANUNCIO PARA LANZAR

Meta no muestra resultados. Pero deja pistas.

La biblioteca no dice cuánto vendió un anuncio ni cuánto gastó. Lo que sí muestra es el orden por impresiones, desde cuándo corre y si sigue activo. Con eso el informe marca cada anuncio así:

Prompts listos para copiar

Cambia lo resaltado por tu caso. Los primeros arman un informe. Los segundos se usan en el mismo chat después de que el informe está listo, porque Claude ya tiene todos los anuncios leídos.

Para armar el informe

✳ Para "Un solo competidor a fondo", elige "Solo los que nombré" en la tarjeta. El link de la biblioteca sirve cuando el nombre de la marca se confunde con otra: búscala en la biblioteca, entra a su página y copia la dirección.

Con el informe listo

Para los que quieren ver el motor

No necesitas nada de esta sección para usar /spy: Claude corre estos comandos por ti. Sirve si quieres repetir un solo paso, automatizarlo o entender qué archivo es cada cosa.

Una corrida a mano, paso a paso

Se corre desde la carpeta scripts del skill. En Windows, cambia ~ por $env:USERPROFILE y pon las rutas entre comillas.

$ cd ~/.claude/skills/spy/scripts
# 1. Leer tu marca
$ node scrape.mjs marca --ig tumarca --web tumarca.com --nicho "lo que vendes" --out ~/Documents/spy/tumarca
# 2. Encontrar a tu competencia
$ node scrape.mjs descubrir --q "palabra 1" --q "palabra 2" --pais AR --out ~/Documents/spy/tumarca
# 3. Leer sus anuncios, con tu página como --propia si ya anuncias
$ node scrape.mjs paginas --pagina "Marca A" --pagina 123456789 --propia 987654321 --pais AR --out ~/Documents/spy/tumarca
# 4. Claude escribe analisis.json con sus conclusiones
# 5. Bajar las imágenes que falten y armar el informe
$ node scrape.mjs imagenes --out ~/Documents/spy/tumarca
$ node render.mjs ~/Documents/spy/tumarca --modo html

✳ El paso 4 no tiene comando: analisis.json lo escribe Claude siguiendo plantilla-analisis.json. Sin ese archivo, render.mjs avisa que falta y no arma el informe.

Comandos

Opciones

Qué queda en tu computadora

Cada informe tiene su carpeta en Documentos/spy, con el nombre de tu marca y la fecha:

marca.json        lo que leyó de tu Instagram y tu web
descubrir.json    anunciantes encontrados y su peso
paginas/          un archivo por competidor con todos sus anuncios
img/              imágenes de los anuncios y hojas de contacto
resumen.json      lo que lee Claude para analizar
analisis.json     las conclusiones de Claude
informe.html      el informe para abrir o mandar
artifact/         la versión que se publica como Artifact

Aparte, el perfil de cada marca queda en .claude/skills/spy/marcas/tumarca.json: nombre, Instagram, web, página de Facebook, rubro, oferta, precio, público, país, objetivo, presupuesto, palabras clave, competidores y qué datos le confirmaste. Es lo que permite que la próxima vez no te pregunte lo mismo. Si cambia tu oferta, díselo a Claude y lo actualiza; si quieres que olvide una marca, borra ese archivo.

Siempre al día, sin perder tus marcas

No tienes que hacer nada: cada vez que escribes /spy, el skill revisa su repositorio de GitHub y, si hay una versión nueva, se pone al día solo antes de empezar, sin interrumpirte. Meta cambia la biblioteca de vez en cuando, y así siempre corres la versión que le sigue el paso. Funciona igual con Git o con el ZIP, nunca borra los perfiles de tus marcas ni tus informes, y si no hay internet sigue con la versión que tienes.

Si clonaste el repo y le hiciste cambios propios, no los pisa: no se actualiza hasta que los guardes o los descartes.

Apagar la actualización automática

Crea un archivo vacío llamado .sin-actualizar en la carpeta del skill. Para volver a prenderla, bórralo.

# Windows, en PowerShell
$ New-Item "$env:USERPROFILE\.claude\skills\spy\.sin-actualizar"
# Mac y Linux, en la Terminal
$ touch ~/.claude/skills/spy/.sin-actualizar

Actualizar a mano

Con la automática apagada, si instalaste con Git:

# Windows, en PowerShell
$ git -C "$env:USERPROFILE\.claude\skills\spy" pull
$ npm.cmd install --prefix "$env:USERPROFILE\.claude\skills\spy\scripts"
# Mac y Linux, en la Terminal
$ git -C ~/.claude/skills/spy pull
$ npm install --prefix ~/.claude/skills/spy/scripts

Desinstalar

Borra la carpeta del skill. Los informes de Documentos/spy quedan hasta que los borres tú.

# Windows, en PowerShell
$ Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\skills\spy"
# Mac y Linux, en la Terminal
$ rm -rf ~/.claude/skills/spy

Lo que hace y lo que no

Conviene saberlo antes de sacar conclusiones o de mandarle el informe a un cliente.

Problemas comunes y cómo salir

Los links que necesitas

/spy es un skill de paidbyfacu. Las capturas son de un informe de ejemplo hecho con una marca española de cosmética natural; los anuncios que aparecen son públicos y salen de la Biblioteca de anuncios de Meta.