Meta Ad Library Monitor

Lê os anúncios ativos de uma empresa na Biblioteca de Anúncios da Meta e retorna cada um com sua peça criativa, posicionamento e datas de veiculação.

GitHub
1
Experimente este MCPPatrocinado

Documentação

Servidor MCP Meta Ad Library Monitor

Smithery Glama score MCP Registry npm version npm downloads license mcpservers.org

Um servidor MCP que encontra os anúncios ativos de uma empresa no Facebook e Instagram por meio da API da Meta Ad Library. Ele encapsula o ator Mamba Labs Meta Ad Library Monitor na Apify e retorna linhas JSON planas prontas para Clay para qualquer cliente MCP.

O que está incluído

O que ele faz

Forneça um nome de empresa ou domínio e seu próprio token de acesso da Meta, e ele pesquisa a Meta Ad Library e retorna uma linha plana por anúncio: texto criativo, título, datas de veiculação, as superfícies da Meta em que o anúncio foi exibido e o URL permanente de snapshot da Meta para o anúncio renderizado.

Leia a cobertura primeiro, porque ela decide se esta ferramenta é útil para você. Ela lê a API Graph da Meta Ad Library, que é a única rota sancionada pela Meta, e essa API publica duas coisas: todos os anúncios entregues a um público na UE, independentemente do assunto, e anúncios de questões sociais, eleições e política em todo o mundo. Portanto, uma lista com forte presença na UE obtém boa cobertura de publicidade comercial comum, enquanto uma lista dos EUA ou do Reino Unido de anúncios de produtos comuns geralmente retorna not_found. Isso é um dado da Meta, não uma falha na busca, e cada linha traz uma nota de cobertura informando o que a pesquisa poderia ter encontrado. Impressões e gastos existem apenas para anúncios políticos e chegam como faixas, então um valor nulo ali não significa gasto zero.

Toda a pesquisa é executada na Apify. Este pacote é um cliente leve que chama o ator e devolve o resultado inalterado.

Início rápido

Você precisa do Node.js 18 ou mais recente e de uma conta Apify com um token de API.

Adicione isto à sua configuração do Claude Desktop:

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

Obtenha seu token em https://console.apify.com/account/integrations,, cole-o e reinicie o Claude Desktop. A ferramenta find_meta_ads estará disponível.

Você também precisa do seu próprio token de acesso de aplicativo da Meta, gratuito para criar em developers.facebook.com. Defina-o como META_ACCESS_TOKEN no mesmo bloco env para mantê-lo fora da transcrição do chat, ou passe-o por chamada como o argumento da ferramenta metaAccessToken. Sem nenhum dos dois, a ferramenta retorna um erro antes de qualquer execução da Apify começar, então um token ausente não custa nada.

Pré-requisitos

  • Node.js 18 ou mais recente
  • Uma conta Apify com um token de API
  • Seu próprio token de acesso de aplicativo da Meta, gratuito em developers.facebook.com. A API da Ad Library não é aberta, então isso é obrigatório.
  • Uma identidade verificada na sua conta da Meta se você quiser dados de anúncios políticos e de questões. Esse é um requisito da Meta, não nosso.

Exemplos de prompts

  • "O gymshark.com está veiculando anúncios no Facebook na UE agora? Aqui está meu token da Meta."
  • "Mostre-me os últimos 25 anúncios ativos desta empresa para públicos da UE."
  • "Encontre apenas anúncios em vídeo para este anunciante, ativos e inativos."
  • "Pesquise na Meta Ad Library esta marca no Reino Unido e me diga o que a nota de cobertura diz."

Entradas

  • company_domain (opcional): domínio simples da empresa, por exemplo gymshark.com. Usado para derivar o termo de busca do anunciante quando nenhum nome de empresa é fornecido, e usado pelo portão de identidade para verificar se uma página de anunciante correspondente é realmente esta empresa.
  • company_name (opcional, mas fortemente recomendado): a busca de anunciantes da Meta é uma busca de texto difusa sobre nomes de páginas, então o nome da empresa é o que o portão de identidade compara com uma página correspondente. Sem ele, o portão recorre ao radical do domínio, que é mais fraco.
  • metaAccessToken (obrigatório, a menos que META_ACCESS_TOKEN esteja definido no ambiente do servidor): seu próprio token de acesso de aplicativo da Meta, gratuito para criar em developers.facebook.com. A API da Ad Library não é aberta, então uma chamada sem nenhum dos dois retorna um erro e não inicia nenhuma execução.
  • ad_reached_countries (opcional): quais públicos de países pesquisar. Um de EU, GB, US, DE, FR, NL, ES, IT, IE ou ALL_EU_PLUS_UK. A Meta exige este parâmetro e uma solicitação sem ele falha imediatamente. O conjunto da UE é onde a Ad Library cobre todos os anúncios, e não apenas os políticos, então é o padrão.
  • ad_active_status (opcional): ACTIVE, ALL ou INACTIVE. ACTIVE é o padrão porque um anúncio atualmente em veiculação é o sinal de compra. ALL é o que você quer para um histórico criativo ou uma análise competitiva.
  • ad_type (opcional): ALL retorna todos os anúncios que a Ad Library possui para esses países. POLITICAL_AND_ISSUE_ADS restringe ao arquivo político, que é o único arquivo com impressões e gastos e que exige uma identidade verificada na sua conta da Meta.
  • media_type (opcional): ALL, IMAGE, VIDEO, MEME ou NONE. Útil para uma análise criativa em que você só se importa com vídeo.
  • maxAds (opcional): quantas linhas de anúncios retornar por empresa. Um de 10, 25, 50 ou 100. Isso é um controle de custo, não uma mudança de resposta: a linha sempre informa quantos anúncios corresponderam antes do limite.
  • skipCache (opcional): quando falso (o padrão), uma busca bem-sucedida é armazenada em cache por sete dias e reutilizada. Defina como verdadeiro para forçar uma nova busca.

Saída

A ferramenta retorna as linhas JSON planas do ator, uma por anúncio, em snake_case, sem objetos aninhados. advertiser_match informa como a página do anunciante foi correspondida e advertisers_rejected conta quantos o portão de identidade rejeitou. coverage_note declara o que a pesquisa poderia ter encontrado, então um resultado vazio é legível. impressions e spend são preenchidos apenas para anúncios políticos e de questões. Consulte a página da Apify Store para o esquema completo de saída.

Exemplo de saída

{
  "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"
}

Recursos

  • Uma linha plana por anúncio, com texto criativo, título e datas de veiculação
  • O URL de snapshot permanente da própria Meta para cada anúncio renderizado
  • As superfícies da Meta em que um anúncio foi exibido, em publisher_platforms
  • Lê a API Graph sancionada da Meta Ad Library e nenhuma outra rota
  • Uma nota de cobertura em cada linha, então um resultado vazio é legível
  • Portão de identidade do anunciante, com candidatos rejeitados contados

Documentação completa do ator

Este servidor é um cliente leve e não contém lógica de busca. Para a referência completa de entrada e saída, preços e histórico de execução, consulte a página da Apify Store:

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

Suíte GTM da Mamba Labs

Este servidor é um dos servidores MCP da Suíte GTM da Mamba Labs. Cada ator da suíte recebe um domínio ou uma empresa e retorna uma linha plana, então eles se empilham na mesma tabela Clay sem remodelar nada. O ator por trás deste servidor é o Meta Ad Library Monitor, com ID de ator imutável da Apify J1GWlSXfSGU3u8Wng.

Construído por Mamba Labs | npm | Apify Store

Licença

MIT

Construído por Mamba Labs. https://apify.com/mambalabs