API y MCP

Pregunta a SpyWinAds directamente en ChatGPT y Claude.

Permite que ChatGPT, Claude, Cursor o tus scripts consulten videos de anuncios de Facebook con SpyWinAds: qué antigüedad tiene el video y todas las tiendas que publican ese mismo video.

https://spywinads.com/mcp
Solo lectura5 herramientasPlan gratis: 30 llamadas al díaInicio de sesión OAuth

Conectar

ChatGPT

  1. Abre Plugins en la barra lateral izquierda, pulsa Más arriba a la derecha y elige Añadir servidor MCP personalizado.
  2. Pega https://spywinads.com/mcp.
  3. Cuando una herramienta necesita tu cuenta, ChatGPT te pide iniciar sesión en SpyWinAds y pulsar Allow.

Claude.ai / Claude Desktop

  1. Ve a Customize → Connectors → Add custom connector.
  2. Pega https://spywinads.com/mcp y elige Sign in when needed.
  3. Inicia sesión cuando Claude lo pida y pulsa Allow.

Claude Code · Cursor · VS Code

Claude Code: ejecuta el comando y escribe /mcp para iniciar sesión.

claude mcp add --transport http spywinads https://spywinads.com/mcp

Cursor, VS Code, Windsurf, scripts: envía una clave API en un header:

{ "mcpServers": { "spywinads": {
  "url": "https://spywinads.com/mcp",
  "headers": { "Authorization": "Bearer YOUR_KEY" } } } }

Nunca pongas la clave en un enlace. Puedes revocar claves y desconectar aplicaciones en cualquier momento en Ajustes → API y MCP de SpyWinAds.

Pregunta a tu asistente de IA

“¿Este video de anuncio es nuevo o es un video antiguo que se ha vuelto a publicar? https://www.facebook.com/ads/library/?id=…”
“¿Qué videos de anuncios de Facebook está publicando la tienda example.com y cuántas otras tiendas usan los mismos videos?”
“Exporta este producto de Shopify a un archivo CSV para importarlo en mi tienda: https://store.com/products/…”

Herramienta

Solo lectura. 5 herramientas. Plan gratuito: 30 consultas al día. Permisos: ads:read para consultar datos públicos de anuncios y product:export para generar archivos CSV de productos. No lee datos de tu cuenta ni escribe nada.

spywin_lookup_video_adEntrada

Enlace de la Biblioteca de anuncios de Meta o ID del anuncio

Devuelve

Antigüedad real del video (fecha en que el archivo se subió por primera vez a Facebook, con un margen de 1–2 días), primer anuncio, número de anuncios activos, número de tiendas que publican o han publicado el mismo video, y las tiendas que lo publicaron primero en nuestra base de datos

spywin_spy_store_adsEntrada

Dominio de la tienda

Devuelve

Anuncios activos, anuncios nuevos en 7 días, número de videos, productos, páginas de Facebook y los videos destacados con su antigüedad real y número de tiendas

spywin_get_page_adsEntrada

Enlace o ID de la página de Facebook

Devuelve

Total de anuncios y anuncios activos, número de videos, videos destacados y las tiendas a las que la página dirige el tráfico

spywin_export_shopify_productEntrada

Enlace de producto de Shopify

Devuelve

Nombre, precio, variantes, imágenes, enlace de descarga de un archivo CSV para importar en Shopify (disponible 24 horas) y los videos de anuncios del producto en nuestra base de datos. Permiso product:export

spywin_get_video_reuse_researchEntrada

—

Devuelve

Las cifras principales del informe SpyWinAds Video Reuse Index, con enlaces a la metodología y los datos. No requiere iniciar sesión

Obtener una clave de API gratuita

Para scripts y editores de código (Cursor, VS Code). ChatGPT y Claude no necesitan clave: inician sesión con tu cuenta de SpyWinAds. Introduce tu email, te enviaremos un enlace de confirmación y mostraremos la clave una sola vez.

¿Ya tienes una cuenta de SpyWinAds? Crea una clave en la app: Ajustes → API y MCP.

REST API

curl -H "Authorization: Bearer YOUR_KEY" \
  "https://spywinads.com/api/v1/store?domain=example.com"

Endpoints: /api/v1/video?ad= · /api/v1/store?domain= · /api/v1/page?page= · /api/v1/product?url= · /api/v1/research/video-reuse. Documentación OpenAPI: /api/v1/openapi.json (compatible con GPT Actions y n8n).

Límites y datos

  • Plan gratuito: 30 consultas al día (se restablece a las 0:00, hora de Vietnam), hasta 20 consultas por minuto. Cuentas en prueba: 100 consultas al día.
  • Datos: anuncios de Meta (Facebook, Instagram) mostrados en EE. UU., procedentes de la base de datos de SpyWinAds. Los recuentos son mínimos, no cifras de ventas. No incluye gasto publicitario, alcance ni ingresos. “Tienda más temprana” significa la primera en nuestra base de datos, no el propietario del video.
  • Cada consulta devuelve exactamente lo que muestran las herramientas gratuitas de la web; no hay búsqueda en toda la base de datos.
  • ¿Aún no está en la base de datos? El resultado incluye un enlace a la herramienta web, donde puedes solicitar un escaneo gratuito.

Dudas: support@spywinads.com · Política de privacidad ›