adextract

Servidor MCP Adextract

Adextract é um servidor MCP (Model Context Protocol) que dá inteligência de anúncios a assistentes de IA. Ele pesquisa as bibliotecas de anúncios da Meta (Facebook e Instagram), Google Ads, LinkedIn e TikTok, e analisa criativos de anúncios com ad_reader.

Endpoint hospedado: https://mcp.adextract.co/mcp Plano gratuito: 50 pesquisas gratuitas. Obtenha uma chave de API em adextract.co.

⭐ Se o Adextract ajudar você, dê uma estrela neste repositório. Isso ajuda outros desenvolvedores de IA a encontrá-lo.

---

Assista à demonstração

Também no YouTube.

---

Como funciona

Um servidor MCP, uma chave de API, quatro bibliotecas de anúncios. Seu assistente de IA fala MCP — o Adextract faz a pesquisa e a análise.

---

Início rápido

1. Obtenha uma chave de API gratuita em adextract.co (conta → chaves de API).
2. Adicione o servidor ao Cursor com a configuração abaixo.
3. Pergunte à sua IA: "Mostre-me os anúncios ativos da Nike no Facebook nos EUA".

Não há nada para instalar localmente. O Adextract roda como um servidor MCP hospedado, então funciona em qualquer cliente compatível com MCP.

---

Casos de uso

• Inteligência de anúncios de concorrentes - veja o que seus concorrentes estão veiculando na Meta, Google, LinkedIn e TikTok.
• Análise de criativos - ad_reader divide qualquer criativo de anúncio em formato, público, emoção e arquétipos.
• Monitoramento de marcas - acompanhe anúncios de qualquer marca ou domínio em quatro bibliotecas de anúncios.
• Estratégia de canais - prompts MCP integrados transformam dados de anúncios em planos de canais.

---

Instalação

MCP hospedado (recomendado)

Conecte-se ao servidor hospedado do Adextract:

https://mcp.adextract.co/mcp

Obtenha sua chave de API em adextract.co (conta → chaves de API).

Cursor

Adicione ao ~/.cursor/mcp.json ou ao .cursor/mcp.json do projeto:

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

VS Code

Adicione ao .vscode/mcp.json:

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

Claude Web (OAuth)

1. Abra Claude → Configurações → Conectores → Adicionar conector personalizado
2. Nome: ad-extract
3. URL: https://mcp.adextract.co/mcp
4. Entre e aprove quando solicitado (sem chave de API na URL).

Claude Desktop (mcp-remote)

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

Mais clientes e caminhos de configuração: docs/CLIENT_SETUP.md

---

Ferramentas disponíveis

Ferramenta	Plataforma	Descrição
search_meta_ads	Meta	Pesquisar anúncios do Facebook e Instagram
search_meta_pages	Meta	Descobrir páginas e IDs de localização
get_meta_page_info	Meta	Transparência de páginas e metadados
get_meta_ad_details	Meta	Detalhes de transparência de anúncios na UE/Reino Unido
search_google_ads	Google	Central de Transparência de Anúncios do Google
search_google_ads_advertisers	Google	Pesquisa de anunciantes e domínios
get_google_ad_details	Google	Detalhes de criativos
get_google_ads_advertiser_info	Google	Perfil do anunciante a partir de anúncios de pesquisa
search_linkedin_ads	LinkedIn	Biblioteca de Anúncios do LinkedIn
search_tiktok_ads	TikTok	Biblioteca de Anúncios do TikTok
search_tiktok_advertisers	TikTok	Descoberta de anunciantes no TikTok
get_tiktok_ad_details	TikTok	Detalhes de segmentação e criativos
ad_reader	Todos	Analisar criativos de imagem/vídeo (formato, público, emoção, arquétipos)

Referência completa: docs/TOOLS.md

---

Prompts e recursos

Prompts MCP integrados para fluxos de trabalho comuns:

• adextract_top_ads_for_brand
• adextract_competitor_benchmark
• adextract_channel_strategy
• adextract_analyze_ad_url
• adextract_schedule_watchlist

Os recursos incluem instruções de habilidades do agente e referências de pacotes de prompts (adextract://skill/main, etc.).

---

Autenticação

Método	Melhor para
OAuth 2.0	Claude Web e conectores compatíveis com OAuth
Chave de API Bearer	Cursor, VS Code, Claude Desktop, mcp-remote

Endpoints de descoberta:

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

Cartão do servidor (registro / descoberta de cliente):

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

---

Exemplos 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://..." })

---

FAQ

O que é o Adextract?

O Adextract é um servidor MCP hospedado que permite que assistentes de IA pesquisem as bibliotecas públicas de anúncios da Meta, Google Ads, LinkedIn e TikTok, e analisem criativos de anúncios. Funciona com Claude, Cursor, VS Code e qualquer cliente compatível com MCP.

Quais bibliotecas de anúncios ele cobre?

Biblioteca de Anúncios da Meta (Facebook e Instagram), Central de Transparência de Anúncios do Google, Biblioteca de Anúncios do LinkedIn e Biblioteca de Anúncios do TikTok.

Como obtenho uma chave de API?

Cadastre-se em adextract.co e depois vá para conta → chaves de API. A chave é mostrada uma única vez na criação.

Existe um plano gratuito?

Sim. Novas contas recebem 50 pesquisas gratuitas. Planos pagos estão disponíveis em adextract.co.

O que o ad_reader faz?

Ele analisa qualquer criativo de anúncio público em imagem ou vídeo e retorna JSON estruturado: formato, público-alvo, emoção (Plutchik/VAD), arquétipos e setor/marca.

Preciso executar algum código localmente?

Não. O Adextract é um servidor hospedado. Você só adiciona uma entrada de configuração ao seu cliente.

Posso usar OAuth em vez de uma chave de API?

Sim. O Claude Web e outros conectores compatíveis com OAuth podem entrar diretamente, sem chave de API na URL. Outros clientes usam uma chave de API Bearer.

Como isso é diferente de consultar as bibliotecas de anúncios diretamente?

Cada plataforma de anúncios tem sua própria biblioteca, API e regras de acesso. O Adextract oferece uma interface MCP única para todas as quatro, além de análise de criativos, sem precisar escrever código específico de plataforma.

---

Documentação

Documento	Finalidade
docs/CLIENT_SETUP.md	Configuração por cliente
docs/TOOLS.md	Ferramentas, prompts, recursos
docs/TROUBLESHOOTING.md	Erros comuns e correções
REGISTRY_CHECKLIST.md	Lista de verificação pré-envio
SECURITY.md	Política de segurança
SUPPORT.md	Como obter ajuda

---

Links

• Site: adextract.co
• Endpoint MCP: https://mcp.adextract.co/mcp
• Repositório: github.com/ad-vertly/adextract-mcp-server

---

Comunidade

     

_{Siga-nos para dicas de inteligência de anúncios, atualizações do MCP e o que seus concorrentes estão veiculando.}

---

_{Feito com ❤️ por Adextract}