Spytrend MCP
Análisis de publicidad en Meta y TikTok con anuncios, creatividades, anunciantes, rankings y seis flujos de trabajo.
Servidor MCP alojado
npx add-mcp 'https://mcp.spytrend.com/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
Servidor MCP de Spytrend
Spytrend es una plataforma de analítica publicitaria. Este repositorio es el hogar oficial de su servidor MCP: una URL, un inicio de sesión en el navegador, y tu asistente de IA trabaja directamente con datos publicitarios de Meta y TikTok — anuncios, las imágenes y videos detrás de ellos, anunciantes, y quién los publica. No hay nada que instalar ni ninguna clave que pegar: el servidor se ejecuta en nuestro lado y inicias sesión con tu cuenta de Spytrend, la misma que usas en el sitio. La conexión funciona en todos los planes, incluido el gratuito; el uso se mide en tokens, y pagas por resultados, no por preguntar — una llamada que no devuelve nada no cuesta nada. Un anuncio es un solo fotograma. Aquí ves todo lo que un competidor publica.
Qué es este repositorio
Este repositorio contiene los metadatos públicos del catálogo de un servidor que alojamos (ver server.json), además de
instrucciones de configuración y recetas. El servidor en sí es parte de la plataforma Spytrend y su código
fuente no es abierto. No hay ningún paquete aquí para descargar ni código para ejecutar — conectarse es una URL y un
botón de inicio de sesión.
Conectar
Endpoint
https://mcp.spytrend.com/mcp
Inicio de sesión: tu cuenta de Spytrend, en el navegador. Sin clave de API, sin token que pegar.
Dónde encontrarlo en tu cuenta: Configuración → IA / MCP, o la página de conexión en https://spytrend.com/mcp/.
Tres pasos, sea cual sea el cliente que uses:
- Abre la configuración de conectores de tu cliente.
- Añade un servidor MCP remoto y dale la URL anterior.
- Inicia sesión cuando se abra la ventana del navegador, y empieza a preguntar.
Instrucciones por cliente: docs/quickstart.md.
Claude — escritorio, CLI y web
Añade un conector personalizado en Configuración → Conectores, pega la URL del endpoint y completa el inicio de sesión en la ventana del navegador que se abre. Guía completa: docs/quickstart.md#claude.
ChatGPT
Añade el endpoint como conector en Configuración, luego inicia sesión con tu cuenta de Spytrend. Guía completa: docs/quickstart.md#chatgpt.
Cursor · Codex · VS Code
Añade el endpoint anterior como servidor MCP remoto de tipo streamable-http, luego inicia sesión a través del
navegador cuando se te solicite. Guía completa: docs/quickstart.md.
Cualquier cliente que hable Streamable HTTP funcionará — los cuatro anteriores son simplemente los que hemos documentado.
Qué obtienes
Búsqueda. Pregunta qué se está anunciando en un mercado, una categoría o un país — por palabra clave, por categoría de negocio, por formato, por fechas de publicación. Busca también en el propio material publicitario: las imágenes y videos que una persona realmente ve.
Un registro, completo. Abre un solo anuncio, un anunciante, o la cuenta detrás de un grupo de anuncios, y obtén el registro completo: el texto, el material, las páginas, los dominios, los países, las fechas de publicación.
Rankings. Ve qué está ganando tracción recientemente en un país, una categoría o una aplicación — un punto de partida cuando no tienes ningún competidor específico en mente.
Carpetas y saldo. Guarda lo que encuentres en una carpeta y recupéralo más tarde. Consulta tu saldo, gratis, en cualquier momento.
Agentes autónomos. Un agente puede registrarse y empezar a muestrear la base de datos antes de que nadie se registre: resultados de archivo, rankings a nivel de mercado, diez filas por llamada, sin medios. Vincularlo a una cuenta de Spytrend abre el resto. Ver docs/quickstart.md.
Todo lo que un competidor publica
Un anuncio es un solo fotograma. Aquí ves todo el cuerpo de trabajo: cada anuncio, cada video, cada página, cada dominio, cada país y cada fecha de publicación, reunidos en un solo registro. Abre la cuenta detrás de la publicidad una vez y toda la imagen ya está ensamblada — no estás haciendo clic entre pestañas construyéndola tú mismo.
La mayoría de los servicios responden una pregunta: muéstrame este anuncio. Este responde una pregunta diferente: ¿quién lo publica, y qué más están publicando?
Herramientas
| Herramienta | Qué hace | Costo |
|---|---|---|
search_ads | Busca anuncios de Meta y TikTok por palabra clave, país, categoría de negocio, formato y fechas de publicación | 1 token por fila devuelta |
search_creatives | Busca en el propio material publicitario — las imágenes y videos que una persona realmente ve | 1 token por fila devuelta |
search_advertisers | Encuentra anunciantes por nombre, dominio, país o categoría de negocio | 1 token por fila devuelta |
search_webmasters | Encuentra la empresa o persona detrás de un grupo de anuncios — una cuenta que publica muchos anuncios en páginas, dominios y países | 1 token por fila devuelta |
search_hubs | Explora a dónde envía la publicidad a las personas, agrupado por destino: plataformas sociales, tiendas de aplicaciones, marketplaces, tiendas | Catálogo de destinos: gratis. Perfiles dentro de uno: 1 token por fila |
search_shops | Consulta un dominio como superficie de tráfico, con estimaciones de visitas mensuales y qué tan confiable es cada estimación | 1 token por fila devuelta |
get_ad | Devuelve el registro completo de un anuncio: texto, material, anunciante, países, fechas de publicación, página de destino | 1 token |
get_advertiser | Devuelve un anunciante completo: páginas, países, categorías de negocio | 1 token |
get_webmaster | Devuelve todo lo que la cuenta detrás de un grupo de anuncios publica, en un solo registro | 1 token |
get_creative | Devuelve el registro de una imagen o video: dónde se publicó y con qué frecuencia se reutilizó | 1 token |
get_shop | Devuelve el perfil completo de un dominio | 1 token |
get_media | Descarga el archivo de imagen o video en sí | 1 token por anuncio · 10 por creativo |
get_trends | Devuelve rankings para un país, categoría o aplicación, incluyendo lo que está ganando tracción recientemente | 1 token por fila devuelta |
get_ads_analytics | Devuelve la forma de una selección de anuncios en lugar de los anuncios: cuántos hay y cómo se desglosan por estado, país, categoría de negocio, destino y anunciante | Pro y superior · 1 token por fila de desglose |
find_similar_ads | Encuentra anuncios que llevan el mismo material que uno que ya tienes | 1 token por fila devuelta |
find_similar_creatives | Encuentra imágenes y videos que se ven iguales a uno que ya tienes | 1 token por fila devuelta |
find_similar_webmasters | Encuentra cuentas que anuncian de manera similar a una que ya tienes | 1 token por fila devuelta |
get_webmaster_similarity_facets | Muestra en qué aspectos dos cuentas se parecen, antes de que pidas la lista | Gratis |
add_to_favorites | Guarda un anuncio, una imagen o video, un anunciante, un destino o una cuenta en una carpeta | Anuncios 1 token · creativos 10 · todo lo demás gratis |
list_favorites | Devuelve lo que hay en tus carpetas | Gratis |
get_usage | Muestra tu plan, tu saldo y cuánto cuesta cada llamada | Gratis |
Una página devuelve 20 filas a menos que pidas más, y nunca más de 200. Se te cobra por las filas realmente entregadas — una página más corta reembolsa la diferencia automáticamente. El corpus de TikTok (
source=tiktok, plan Pro y superior) tiene un precio separado de 100 tokens por fila entregada.
Cada herramienta con su guía de cuándo usar / cuándo no usar, su forma de retorno y una solicitud de ejemplo: docs/tools.md.
Una palabra explicada. En este producto, un webmaster es la empresa o persona detrás de un grupo de anuncios: una cuenta que publica muchos anuncios en diferentes páginas, dominios y países. Los nombres de las herramientas conservan la palabra original; las descripciones no dependen de ella.
Habilidades
Seis flujos de trabajo listos para Claude Code y Codex viven en skills/: mapear un sector, perfilar un anunciante o la cuenta detrás de un grupo de anuncios, revisar un sitio web, buscar por palabra clave, descubrir tiendas. Cada habilidad es una carpeta simple — cópiala en el directorio de habilidades de tu asistente y pide en lenguaje natural; la habilidad decide qué herramientas llamar y genera un informe. Pasos de instalación y el contrato compartido: skills/README.md.
Instalación con un comando: /plugin marketplace add Spytrend/spytrend-mcp luego /plugin install spytrend-mcp-skills@spytrend-mcp para Claude Code; npx skills add Spytrend/spytrend-mcp para Claude Code, Codex, Cursor, Copilot, Gemini CLI y más de 70 más.
Recetas
Estas son las cosas que la gente le pide a su asistente el primer día. Escribe la solicitud con tus propias palabras — el asistente elige las herramientas.
| Receta | Qué pides |
|---|---|
| Encuentra quién más está anunciando en tu mercado | Quién está anunciando en tu espacio ahora mismo, y qué están publicando |
| Coincide con un tipo de negocio | Publicidad de negocios como el tuyo — sin necesidad de nombres de competidores |
| Principales anuncios en un mercado | Qué se está publicando en una categoría, ordenado por cuánto tiempo lleva activo |
| Qué se está publicando ahora mismo en una industria | Qué es nuevo y está ganando tracción, y qué ha estado publicándose durante un tiempo |
Créditos y planes
El uso se mide en tokens, desde un solo saldo. Pagas por resultados, no por preguntar: una llamada que no devuelve nada no cuesta nada, y una página más corta de lo que pediste reembolsa la diferencia.
- Una fila o registro entregado — 1 token. Eso cubre una fila de resultados de búsqueda, una fila de rankings, y un anunciante, cuenta, destino o creativo abierto en su totalidad.
- Descargar el material en sí — 1 token por un anuncio, 10 por un creativo.
- El corpus de TikTok (
source=tiktok, Pro y superior) — 100 tokens por fila entregada. - Consultar tu saldo, listar tus carpetas y el catálogo de destinos — gratis.
El plan gratuito Starter incluye 500 tokens, y no caducan. Cada plan de pago incluye 40,000 tokens al mes — alrededor de 2,000 búsquedas de tamaño predeterminado. Los límites empresariales se establecen con soporte.
La conexión funciona en todos los planes, incluido el gratuito. En el plan gratuito Starter los resultados se
limitan al archivo — nada de los últimos 90 días. La publicidad reciente es lo que proporcionan los planes
de pago; es el mismo límite que el nivel gratuito en el sitio. Tu asistente siempre puede preguntar
get_usage — es gratis y responde desde el propio servidor. Precios actuales:
https://spytrend.com/pricing/
Detalles, junto con lo que el asistente ve cuando el saldo se agota: docs/limits.md.
Documentación
| Archivo | Qué contiene |
|---|---|
| docs/quickstart.md | Conectarse en cinco minutos, por cliente |
| docs/tools.md | Cada herramienta: qué hace, cuándo usarla, cuándo no, qué devuelve |
| docs/limits.md | Créditos, límites, planes y cómo se ve un error |
| examples/ | Cuatro recetas: qué preguntar, qué devuelve, cómo leerlo |
| skills/ | Seis flujos de trabajo listos para Claude Code y Codex, con pasos de instalación y el contrato compartido |
| server.json | Metadatos del catálogo, publicados en el registro oficial de MCP |
| llms.txt | Un mapa corto legible por máquina de esta conexión para asistentes de IA |
Soporte
Preguntas sobre conexión, acceso o tu cuenta: https://spytrend.com/contact/
Algo incorrecto en este repositorio — un enlace roto, una instrucción que no coincide con lo que ves en pantalla: abre un issue.
Los informes de seguridad van por una vía separada, nunca a través de issues: ver SECURITY.md.
Licencia
MIT — ver LICENSE. La licencia cubre el contenido de este repositorio: documentación, metadatos y ejemplos. El servidor en sí es parte de la plataforma Spytrend.