Meta Ad Library Monitor

Lee los anuncios activos de una empresa en la Biblioteca de Anuncios de Meta y devuelve cada uno con su creativo, ubicación y fechas de publicación.

GitHub

Prueba este MCPPatrocinado

Documentación

Servidor MCP Meta Ad Library Monitor

Un servidor MCP que encuentra los anuncios activos de una empresa en Facebook e Instagram a través de la API de Meta Ad Library. Envuelve el actor Meta Ad Library Monitor de Mamba Labs en Apify y devuelve filas JSON planas listas para Clay a cualquier cliente MCP.

Qué hace

Dale un nombre de empresa o dominio y tu propio token de acceso de Meta, y buscará en Meta Ad Library y devolverá una fila plana por anuncio: texto creativo, titular, fechas de entrega, las superficies de Meta en las que se mostró el anuncio y la URL de instantánea permanente de Meta para el anuncio renderizado.

Lee primero la cobertura, porque decide si esta herramienta te sirve o no. Lee la API Graph de Meta Ad Library, que es la única vía que Meta sanciona, y esa API publica dos cosas: todos los anuncios entregados a una audiencia en la UE, sea cual sea su contenido, y anuncios de temas sociales, elecciones y política en todo el mundo. Así, una lista con mucho peso en la UE obtiene buena cobertura de publicidad comercial ordinaria, mientras que una lista de EE. UU. o Reino Unido de anuncios de productos ordinarios vuelve en su mayoría not_found. Eso es el conjunto de datos de Meta, no un fallo de la búsqueda, y cada fila lleva una nota de cobertura que indica qué podría haber encontrado la búsqueda. Las impresiones y el gasto existen solo para anuncios políticos y llegan como rangos, así que un valor nulo ahí no significa gasto cero.

Toda la búsqueda se ejecuta en Apify. Este paquete es un cliente ligero que llama al actor y devuelve el resultado sin cambios.

Inicio rápido

Necesitas Node.js 18 o superior y una cuenta de Apify con un token de API.

Añade esto a tu configuración de Claude Desktop:

{
  "mcpServers": {
    "mamba-meta-ad-library-monitor": {
      "command": "npx",
      "args": ["-y", "@mambalabsdev/mcp-meta-ad-library-monitor"],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

Obtén tu token en https://console.apify.com/account/integrations,, pégalo y reinicia Claude Desktop. La herramienta find_meta_ads estará disponible.

También necesitas tu propio token de acceso de la aplicación de Meta, gratuito de crear en developers.facebook.com. Configúralo como META_ACCESS_TOKEN en el mismo bloque env para mantenerlo fuera de la transcripción del chat, o pásalo por llamada como argumento de la herramienta metaAccessToken. Sin ninguno de los dos, la herramienta devuelve un error antes de que comience cualquier ejecución de Apify, así que un token faltante no cuesta nada.

Requisitos previos

Node.js 18 o superior
Una cuenta de Apify con un token de API
Tu propio token de acceso de la aplicación de Meta, gratuito en developers.facebook.com. La API de Ad Library no es abierta, así que esto es obligatorio.
Una identidad verificada en tu cuenta de Meta si quieres datos de anuncios políticos y de temas sociales. Eso es un requisito de Meta, no nuestro.

Ejemplos de prompts

"¿Está gymshark.com ejecutando anuncios de Facebook en la UE ahora mismo? Aquí está mi token de Meta."
"Muéstrame los últimos 25 anuncios activos de esta empresa para audiencias de la UE."
"Encuentra solo anuncios de video para este anunciante, activos e inactivos."
"Busca en Meta Ad Library esta marca en el Reino Unido y dime qué dice la nota de cobertura."

Entradas

company_domain (opcional): dominio desnudo de la empresa, por ejemplo gymshark.com. Se usa para derivar el término de búsqueda del anunciante cuando no se da un nombre de empresa, y lo usa la puerta de identidad para comprobar que una página de anunciante coincidente es realmente esta empresa.
company_name (opcional pero muy recomendado): la búsqueda de anunciantes de Meta es una búsqueda de texto difusa sobre nombres de páginas, así que el nombre de la empresa es lo que la puerta de identidad compara con una página coincidente. Sin él, la puerta recurre al tallo del dominio, que es más débil.
metaAccessToken (obligatorio a menos que META_ACCESS_TOKEN esté configurado en el entorno del servidor): tu propio token de acceso de la aplicación de Meta, gratuito de crear en developers.facebook.com. La API de Ad Library no es abierta, así que una llamada sin ninguno de los dos devuelve un error y no inicia ninguna ejecución.
ad_reached_countries (opcional): qué audiencias de país buscar. Uno de EU, GB, US, DE, FR, NL, ES, IT, IE o ALL_EU_PLUS_UK. Meta requiere este parámetro y una solicitud sin él falla por completo. El conjunto de la UE es donde Ad Library cubre todos los anuncios en lugar de solo los políticos, así que es el predeterminado.
ad_active_status (opcional): ACTIVE, ALL o INACTIVE. ACTIVE es el predeterminado porque un anuncio actualmente en ejecución es la señal de compra. ALL es lo que quieres para un historial creativo o un análisis competitivo.
ad_type (opcional): ALL devuelve todos los anuncios que Ad Library tiene para esos países. POLITICAL_AND_ISSUE_ADS se limita al archivo político, que es el único archivo que lleva impresiones y gasto y que requiere una identidad verificada en tu cuenta de Meta.
media_type (opcional): ALL, IMAGE, VIDEO, MEME o NONE. Útil para un análisis creativo donde solo te importa el video.
maxAds (opcional): cuántas filas de anuncios devolver por empresa. Uno de 10, 25, 50 o 100. Esto es un dial de costo, no un cambio de respuesta: la fila siempre informa cuántos anuncios coincidieron antes del límite.
skipCache (opcional): cuando es falso (el predeterminado), una búsqueda exitosa se almacena en caché durante siete días y se reutiliza. Configúralo como verdadero para forzar una obtención nueva.

Salida

La herramienta devuelve las filas JSON planas del actor, una por anuncio, en snake_case sin objetos anidados. advertiser_match dice cómo se coincidió la página del anunciante y advertisers_rejected cuenta las que la puerta de identidad rechazó. coverage_note indica qué podría haber encontrado la búsqueda, así que un resultado vacío es legible. impressions y spend se completan solo para anuncios políticos y de temas sociales. Consulta la página de Apify Store para el esquema completo de salida.

Ejemplo de salida

{
  "degraded": false,
  "degradation_reason": null,
  "company_domain": "gymshark.com",
  "company_name": "Gymshark",
  "page_id": "102590181603009",
  "page_name": "Gymshark Women",
  "advertiser_match": "name_match",
  "advertisers_rejected": 9,
  "ad_id": "2824771397896004",
  "ad_creative_body": "Hol dir die soften, leichten Gymsets fürs Training (und den chaotischen Alltag) ✨",
  "ad_creative_link_title": "Everyday Seamless ab 30 € 💸",
  "ad_creation_time": "2026-08-21",
  "ad_delivery_start_time": "2026-08-21",
  "ad_delivery_stop_time": null,
  "ad_snapshot_url": "https://www.facebook.com/ads/library/?id=2824771397896004",
  "publisher_platforms": "facebook, instagram, audience_network, messenger, threads",
  "languages": "de",
  "impressions": null,
  "spend": null,
  "currency": null,
  "ads_matched": 10,
  "coverage_note": "Searched EU audiences, where the Ad Library covers all ads, plus non EU audiences where it covers only political and issue ads. A commercial advertiser outside the EU is legitimately absent.",
  "coverage": 1,
  "fetch_status": "ok",
  "run_date": "2026-08-23T05:50:09.867Z"
}

Características

Una fila plana por anuncio, con texto creativo, titular y fechas de entrega
La URL de instantánea permanente propia de Meta para cada anuncio renderizado
Las superficies de Meta en las que se mostró un anuncio, en publisher_platforms
Lee la API Graph de Meta Ad Library sancionada y ninguna otra vía
Una nota de cobertura en cada fila, así que un resultado vacío es legible
Puerta de identidad del anunciante, con candidatos rechazados contados

Documentación completa del actor

Este servidor es un cliente ligero y no contiene lógica de búsqueda. Para la referencia completa de entradas y salidas, precios e historial de ejecuciones, consulta la página de Apify Store:

https://apify.com/mambalabs/meta-ad-library-monitor

Suite GTM de Mamba Labs

Este servidor es uno de los servidores MCP de la Suite GTM de Mamba Labs. Cada actor de la suite toma un dominio o una empresa y devuelve una fila plana, así que se apilan en la misma tabla de Clay sin remodelar nada. El actor detrás de este servidor es Meta Ad Library Monitor, con ID de actor inmutable de Apify J1GWlSXfSGU3u8Wng.

Construido por Mamba Labs | npm | Apify Store

Licencia

MIT

Construido por Mamba Labs. https://apify.com/mambalabs