adextract

Servidor MCP de Adextract

Adextract es un servidor MCP (Protocolo de Contexto de Modelo) que brinda inteligencia publicitaria a los asistentes de IA. Busca en las bibliotecas de anuncios de Meta (Facebook e Instagram), Google Ads, LinkedIn y TikTok, y analiza creatividades publicitarias con ad_reader.

Endpoint alojado: https://mcp.adextract.co/mcp Plan gratuito: 50 búsquedas gratuitas. Obtén una clave API en adextract.co.

⭐ Si Adextract te resulta útil, dale una estrella a este repositorio. Ayuda a otros desarrolladores de IA a encontrarlo.

---

Mira la demostración

También en YouTube.

---

Cómo funciona

Un servidor MCP, una clave API, cuatro bibliotecas de anuncios. Tu asistente de IA habla MCP — Adextract se encarga de buscar y analizar.

---

Inicio rápido

1. Obtén una clave API gratuita en adextract.co (cuenta → claves API).
2. Agrega el servidor a Cursor con la configuración a continuación.
3. Pregúntale a tu IA: "Muéstrame los anuncios activos de Nike en Facebook en EE. UU.".

No hay nada que instalar localmente. Adextract se ejecuta como un servidor MCP alojado, por lo que funciona en cualquier cliente compatible con MCP.

---

Casos de uso

• Inteligencia publicitaria de la competencia - ve lo que tus competidores están publicando en Meta, Google, LinkedIn y TikTok.
• Análisis de creatividades - ad_reader desglosa cualquier creatividad publicitaria en formato, audiencia, emoción y arquetipos.
• Monitoreo de marcas - rastrea anuncios de cualquier marca o dominio en las cuatro bibliotecas de anuncios.
• Estrategia de canales - los prompts MCP integrados convierten los datos publicitarios en planes de canal.

---

Instalación

MCP alojado (recomendado)

Conéctate al servidor alojado de Adextract:

https://mcp.adextract.co/mcp

Obtén tu clave API en adextract.co (cuenta → claves API).

Cursor

Agrega a ~/.cursor/mcp.json o al .cursor/mcp.json del proyecto:

{
  "mcpServers": {
    "ad-extract": {
      "url": "https://mcp.adextract.co/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

VS Code

Agrega a .vscode/mcp.json:

{
  "servers": {
    "ad-extract": {
      "type": "http",
      "url": "https://mcp.adextract.co/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Web (OAuth)

1. Abre Claude → Configuración → Conectores → Agregar conector personalizado
2. Nombre: ad-extract
3. URL: https://mcp.adextract.co/mcp
4. Inicia sesión y aprueba cuando se te solicite (sin clave API en la URL).

Claude Desktop (mcp-remote)

{
  "mcpServers": {
    "ad-extract": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.adextract.co/mcp",
        "--header",
        "Authorization: Bearer ***"
      ]
    }
  }
}

Más clientes y rutas de configuración: docs/CLIENT_SETUP.md

---

Herramientas disponibles

Herramienta	Plataforma	Descripción
search_meta_ads	Meta	Buscar anuncios de Facebook e Instagram
search_meta_pages	Meta	Descubrir páginas e IDs de ubicación
get_meta_page_info	Meta	Transparencia de páginas y metadatos
get_meta_ad_details	Meta	Detalles de transparencia publicitaria en UE/Reino Unido
search_google_ads	Google	Centro de Transparencia de Google Ads
search_google_ads_advertisers	Google	Búsqueda de anunciantes y dominios
get_google_ad_details	Google	Detalles de creatividades
get_google_ads_advertiser_info	Google	Perfil del anunciante desde anuncios de búsqueda
search_linkedin_ads	LinkedIn	Biblioteca de Anuncios de LinkedIn
search_tiktok_ads	TikTok	Biblioteca de Anuncios de TikTok
search_tiktok_advertisers	TikTok	Descubrimiento de anunciantes en TikTok
get_tiktok_ad_details	TikTok	Detalles de segmentación y creatividades
ad_reader	Todas	Analizar creatividades de imagen/video (formato, audiencia, emoción, arquetipos)

Referencia completa: docs/TOOLS.md

---

Prompts y recursos

Prompts MCP integrados para flujos de trabajo comunes:

• adextract_top_ads_for_brand
• adextract_competitor_benchmark
• adextract_channel_strategy
• adextract_analyze_ad_url
• adextract_schedule_watchlist

Los recursos incluyen instrucciones de habilidades para agentes y referencias de paquetes de prompts (adextract://skill/main, etc.).

---

Autenticación

Método	Ideal para
OAuth 2.0	Claude Web y conectores compatibles con OAuth
Clave API Bearer	Cursor, VS Code, Claude Desktop, mcp-remote

Endpoints de descubrimiento:

• https://mcp.adextract.co/.well-known/oauth-protected-resource
• https://mcp.adextract.co/.well-known/oauth-authorization-server/oauth

Tarjeta de servidor (registro / descubrimiento de clientes):

• https://mcp.adextract.co/.well-known/mcp.json

---

Ejemplos de prompts

Show me the latest Nike ads on Facebook in the US.
→ search_meta_ads({ q: "nike", country: "US", active_status: "active" })

Find Google ads for tesla.com from the last 30 days.
→ search_google_ads({ domain: "tesla.com", time_period: "last_30_days" })

Analyze this ad creative URL with ad_reader.
→ ad_reader({ url: "https://..." })

---

Preguntas frecuentes

¿Qué es Adextract?

Adextract es un servidor MCP alojado que permite a los asistentes de IA buscar en las bibliotecas públicas de anuncios de Meta, Google Ads, LinkedIn y TikTok, y analizar creatividades publicitarias. Funciona con Claude, Cursor, VS Code y cualquier cliente compatible con MCP.

¿Qué bibliotecas de anuncios cubre?

Biblioteca de Anuncios de Meta (Facebook e Instagram), Centro de Transparencia de Google Ads, Biblioteca de Anuncios de LinkedIn y Biblioteca de Anuncios de TikTok.

¿Cómo obtengo una clave API?

Regístrate en adextract.co, luego ve a cuenta → claves API. La clave se muestra una sola vez al crearla.

¿Hay un plan gratuito?

Sí. Las cuentas nuevas reciben 50 búsquedas gratuitas. Hay planes de pago disponibles en adextract.co.

¿Qué hace ad_reader?

Analiza cualquier creatividad publicitaria pública de imagen o video y devuelve JSON estructurado: formato, audiencia objetivo, emoción (Plutchik/VAD), arquetipos e industria/marca.

¿Necesito ejecutar código localmente?

No. Adextract es un servidor alojado. Solo agregas una entrada de configuración a tu cliente.

¿Puedo usar OAuth en lugar de una clave API?

Sí. Claude Web y otros conectores compatibles con OAuth pueden iniciar sesión directamente, sin clave API en la URL. Otros clientes usan una clave API Bearer.

¿En qué se diferencia de consultar las bibliotecas de anuncios directamente?

Cada plataforma publicitaria tiene su propia biblioteca, API y reglas de acceso. Adextract ofrece una interfaz MCP única para las cuatro, además de análisis de creatividades, sin necesidad de escribir código específico de plataforma.

---

Documentación

Documento	Propósito
docs/CLIENT_SETUP.md	Configuración por cliente
docs/TOOLS.md	Herramientas, prompts, recursos
docs/TROUBLESHOOTING.md	Errores comunes y soluciones
REGISTRY_CHECKLIST.md	Lista de verificación previa al envío
SECURITY.md	Política de seguridad
SUPPORT.md	Cómo obtener ayuda

---

Enlaces

• Sitio web: adextract.co
• Endpoint MCP: https://mcp.adextract.co/mcp
• Repositorio: github.com/ad-vertly/adextract-mcp-server

---

Comunidad

     

_{Síguenos para obtener consejos de inteligencia publicitaria, actualizaciones de MCP y ver qué están publicando tus competidores.}

---

_{Hecho con ❤️ por Adextract}