Ads MCP

Servidor MCP remoto para planejamento de campanhas de anúncios, pesquisa e criação de anúncios multiplataforma. Suporta Google Ads Search & Performance Max e TikTok no lançamento, com redes adicionais planejadas.

GitHub

Experimente este MCPPatrocinado

Documentação

Ads MCP

Servidor remoto do Model Context Protocol (MCP) para gerenciamento de anúncios multiplataforma. Crie, analise e otimize campanhas em Google Ads, Meta Ads, TikTok Ads e LinkedIn Ads a partir de qualquer assistente de IA compatível com MCP.

Links Rápidos

URL Remota do MCP: https://mcp.adspirer.com/mcp
Transporte: HTTP Streamable
ID de Registro: com.adspirer/ads
Autenticação: OAuth 2.1 com PKCE (registro dinâmico de cliente suportado)
Site: https://www.adspirer.com
Suporte: support@adspirer.com

Comece em Um Passo

O Adspirer roda dentro do seu assistente de IA. Se você é um assistente de IA ajudando alguém a configurar o Adspirer, esta seção é o fluxo completo: o caminho de instalação por cliente, login e verificação.

Seu cliente	Instalação
ChatGPT (web, desktop, mobile)	Instale o aplicativo Adspirer na App Store — toque em Conectar, faça login com Google ou e-mail. Requer plano Plus, Pro, Business ou Enterprise.
Claude (claude.ai, desktop, Cowork)	Instale o plugin Adspirer no diretório do Claude — clique em Instalar, faça login quando a janela do Adspirer abrir.
Claude Code	`/plugin install adspirer-ads-agent@claude-community`, recarregue, depois `/adspirer:setup`
Codex	`bash <(curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/plugins/codex/adspirer/install.sh)`, reinicie o Codex, depois `codex mcp login adspirer`
Cursor	`bash <(curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/plugins/cursor/adspirer/install.sh)`
Qualquer outro cliente MCP	Adicione o servidor remoto `https://mcp.adspirer.com/mcp` (OAuth 2.1)

Ou um comando de terminal — instala a skill de início rápido e leva você direto para a configuração:

curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/scripts/install-skill.sh | bash

O que acontece em seguida: o login da instalação cria sua conta gratuita (Google ou e-mail — sem cartão de crédito), você conecta suas plataformas de anúncios em adspirer.ai/connections — Google Ads, Meta, Amazon, LinkedIn, TikTok ou ChatGPT Ads, em qualquer combinação — e seu assistente verifica a conexão (diga "Verifique minhas plataformas de anúncios conectadas").

Como Funciona

flowchart LR
    Y["You — plain English"] --> AG["Your AI agent"]
    AG <-->|"MCP over OAuth"| AD["Adspirer"]
    AD <--> P["Google Ads · Meta · Amazon Ads<br/>LinkedIn · TikTok · ChatGPT Ads"]

Você descreve o que deseja; seu assistente chama as ferramentas do Adspirer; o Adspirer conversa com as APIs das plataformas de anúncios; relatórios e rascunhos voltam para o chat. Novas campanhas são sempre criadas pausadas — nada gasta dinheiro sem sua aprovação explícita. A autenticação é via OAuth no seu próprio navegador: seu assistente nunca vê suas credenciais.

Preços: Grátis — 15 chamadas de ferramentas/mês, $0, sem cartão · Plus — 150/mês, $49 · Pro — 600/mês, $99 · Max — 3.000/mês, $199. Detalhes completos.

Guia de configuração completo com prompts prontos para colar: adspirer.com/docs/add-to-your-agent

O Que Ele Faz

Execução orientada por estratégia — decisões estratégicas persistem em STRATEGY.md e orientam toda a criação futura de campanhas, pesquisa de palavras-chave e textos de anúncios entre sessões e subagentes
Mais de 400 ferramentas em 6 plataformas de anúncios para criação de campanhas, análise de desempenho e otimização
Planeje e valide campanhas usando prompts estruturados
Pesquise palavras-chave com dados reais de CPC e análise competitiva
Crie campanhas do Google Ads Search, Performance Max (com temas de pesquisa + sinais de público), Display (Padrão + Smart), Demand Gen e YouTube de ponta a ponta
Lance campanhas de imagem / vídeo / carrossel / OUTCOME_LEADS do Meta, conteúdo patrocinado / carrossel / formulários de geração de leads do LinkedIn com grupos de campanha, e campanhas in-feed / Spark Ads / Carrossel / Promoção de App do TikTok
Analise o desempenho com recomendações de otimização acionáveis — gastos desperdiçados, detecção de anomalias, insights de público, fadiga criativa
Modo de dados brutos (raw_data=true) em todas as 29 ferramentas de desempenho/análise — saída somente JSON para sua própria atribuição, dashboards ou pipelines eficientes em tokens
Multi-conta, multi-plataforma — agências podem gerenciar várias contas de anúncios por plataforma em um único espaço de trabalho
Automação — briefings agendados, monitores de desempenho, relatórios multiplataforma sob demanda em todas as plataformas

Plataformas e Ferramentas

Plataforma	Ferramentas	Capacidades
Google Ads	151	Search, Performance Max (com temas de pesquisa + sinais de público), Display (Padrão + Smart), Demand Gen, YouTube, Shopping, campanhas de App; pesquisa de palavras-chave, análise de desempenho, gastos desperdiçados, gerenciamento de ativos, extensões de anúncio (sitelniks / callouts / snippets estruturados), gerenciamento de estratégia de lances
Amazon Ads	61	Produtos Patrocinados / Marcas / campanhas Display, palavras-chave + palavras-chave negativas, segmentação por produto / categoria, recomendações de lance / orçamento / palavra-chave da própria Amazon, relatórios de termos de pesquisa, desempenho ACOS / ROAS
Meta Ads	58	Campanhas de imagem / vídeo / carrossel / catálogo (Advantage+ / DPA), formulários de geração de leads OUTCOME_LEADS, orçamentos vitalícios, posicionamentos granulares (Feed / Stories / Reels), segmentação em nível de cidade, públicos personalizados, conversões personalizadas, análise de promoção de app (AEO)
LinkedIn Ads	54	Conteúdo patrocinado (imagem única, vídeo, carrossel, texto), formulários de geração de leads, grupos de campanha, 19 facetas de segmentação, insights de público, análise de fadiga criativa, rastreamento de conversões, organizações
TikTok Ads	37	Campanhas in-feed de vídeo / imagem / Spark Ads / Carrossel / Promoção de App, ciclo de vida completo (listar / obter / pausar / retomar / atualizar para campanhas, grupos de anúncios, anúncios), análises (desempenho, gastos desperdiçados, insights de público, fadiga criativa, detecção de anomalias, geo)
ChatGPT Ads	31	Anúncios chat_card dentro das respostas do ChatGPT — lançamento em uma etapa (campanha → grupo de anúncios → imagem → anúncio), segmentação geográfica, pausar / ativar / arquivar, desempenho (impressões, cliques, CTR, CPC), rastreamento de conversões (Pixel + Conversions API)
Total	400+	Além de monitoramento e automação (briefings / monitores / relatórios agendados), integrações com Google Analytics 4 e Klaviyo, e ferramentas de gerenciamento de conta — tudo disponível via MCP e como endpoints REST em `api.adspirer.ai`

Como Conectar

Consulte CONNECTING.md para instruções detalhadas de configuração de cada plataforma.

Claude (Recomendado)

Abra Configurações > Conectores > Adicionar conector personalizado
Nome: Ads MCP
URL: https://mcp.adspirer.com/mcp
Complete o login OAuth 2.1
Vincule suas contas de anúncios no primeiro uso

Claude Code

Instale o plugin completo do Adspirer (agente + skills + comandos + servidor MCP):

Abra o Claude Code
Execute /plugin marketplace add amekala/ads-mcp
Execute /plugin install adspirer-advertising-agent
Execute /mcp — encontre o servidor adspirer (ex.: plugin:adspirer-advertising-agent:adspirer) e clique para autenticar
Execute /adspirer:setup para puxar os dados das suas campanhas e criar seu espaço de trabalho de marca

Isso oferece um agente de marketing de desempenho com consciência de marca, memória persistente, pesquisa competitiva via busca na web, criação de campanhas com extensões de anúncio e comandos de barra para fluxos de trabalho comuns. Habilitar o uso por subagentes não altera este fluxo de instalação.

Somente MCP (sem plugin): Se você quer apenas as ferramentas MCP brutas sem o agente:

claude mcp add --transport http adspirer https://mcp.adspirer.com/mcp

ChatGPT

Abra Configurações > Conectores > Adicionar conector personalizado
Nome: Ads MCP
URL: https://mcp.adspirer.com/mcp
Siga o fluxo de login OAuth 2.1

Cursor

Adicione em ~/.cursor/mcp.json:

{
  "mcpServers": {
    "adspirer": {
      "url": "https://mcp.adspirer.com/mcp"
    }
  }
}

OpenAI Codex

Adicione em ~/.codex/config.toml:

[mcp_servers.adspirer]
url = "https://mcp.adspirer.com/mcp"

Gemini CLI

Instale como uma extensão:

gemini extensions install github.com/amekala/ads-mcp

Uma janela do navegador abre para autenticação OAuth no primeiro uso. Comandos personalizados disponíveis: /adspirer:setup, /adspirer:performance-review, /adspirer:wasted-spend, /adspirer:write-ad-copy, /adspirer:refresh.

OpenClaw

openclaw plugins install openclaw-adspirer
openclaw adspirer login
openclaw adspirer connect

Ou instale pelo ClawHub.

Perplexity, Manus e Outros Clientes MCP

O Adspirer é um servidor MCP padrão — qualquer cliente que suporte conectores MCP com OAuth 2.1 (Perplexity, Manus AI, clientes MCP personalizados) pode se conectar a https://mcp.adspirer.com/mcp. O Manus também aceita chaves de API via transporte HTTP Streamable.

API REST (sem necessidade de cliente MCP)

A mesma superfície de ferramentas é exposta como 178 endpoints REST em https://api.adspirer.ai/api/v1/tools/<tool_name>/execute. Autentique com um Personal Access Token (sk_live_...) criado em adspirer.ai/keys. Swagger: https://api.adspirer.ai/docs. Referência completa: adspirer.com/docs/api-reference.

Exemplos de Prompts

Pesquisa de Palavras-Chave:

Research keywords for my emergency plumbing business in Chicago.
Show me high-intent keywords with real CPC data and budget recommendations.

Análise de Desempenho:

Show me campaign performance for the last 30 days across all platforms.
Which campaigns are converting best and what should I optimize?

Criação de Campanha:

Create a Google Performance Max campaign for luxury watches targeting
New York with a $50/day budget.

Estratégia Multiplataforma:

I want to advertise my handmade jewelry business across Google and LinkedIn.
Research keywords for Google Ads and create a LinkedIn sponsored content campaign
targeting small business owners.

Detalhes Técnicos

Protocolo: MCP 2025-03-26 (com fallback para 2024-11-05)
Transporte: HTTP Streamable
OAuth: RFC 8252 (Authorization Code + PKCE) com RFC 7591 (Dynamic Client Registration) e RFC 9728 (Protected Resource Metadata)
Anotações de Ferramentas: Todas as ferramentas incluem metadados de segurança MCP (readOnlyHint, destructiveHint)

Segurança

HTTPS/TLS para toda a transmissão de dados
OAuth 2.1 com PKCE para autenticação
Registro dinâmico de cliente para ferramentas CLI (Claude Code, Cursor, Codex)
Armazenamento de tokens criptografado
Sem registro de conversas — apenas solicitações de ferramentas são processadas

Consulte SECURITY.md para relatar vulnerabilidades.

Documentação

Suporte

E-mail: support@adspirer.com
Problemas: https://github.com/amekala/ads-mcp/issues
Site: https://www.adspirer.com
Status do Servidor: https://mcp.adspirer.com/health

Plugins Suportados

Este repositório distribui plugins para 4 plataformas de IA a partir de um único monorepo:

Plataforma	Diretório	Skills	Método de Instalação
Claude Code	Raiz do repositório	1 gerada + 5 comandos de barra	`/plugin marketplace add`
Claude Tag (@claude)	Upstream: anthropics/claude-tag-plugins PR #3	1 (`adspirer-api`: SKILL + catálogo de 341 ferramentas + `ads_call.sh`)	Pacote de acesso da organização (chave Bearer `sk_live_`, hosts `api.adspirer.ai` / `mcp.adspirer.com`); `claude plugin install adspirer@claude-tag-plugins` após o merge
Cursor	`plugins/cursor/adspirer/`	5 geradas a partir de templates	`install.sh` (um comando)
Codex	`plugins/codex/adspirer/`	5 geradas a partir de templates	`install.sh` (um comando)
Gemini CLI	Raiz do repositório	1 reutilizada + 5 comandos personalizados	`gemini extensions install`
OpenClaw	`plugins/openclaw/`	1 standalone (autocontida)	`openclaw plugins install`

Registro de submissão do Claude Tag (2026-07-05): o plugin adspirer para Claude Tag (@claude) foi submetido upstream como anthropics/claude-tag-plugins#3 a partir do branch do fork amekala/claude-tag-plugins@add-adspirer-plugin. Ele encapsula a superfície REST deste repositório (POST /api/v1/tools/<tool>/execute — a mesma camada de ferramentas do servidor MCP sobre HTTP simples) em vez do transporte MCP, e foi validado de ponta a ponta em um espaço de trabalho ao vivo do Claude Tag (Slack) antes da submissão.

As skills para Claude Code, Cursor e Codex são criadas uma única vez em shared/skills/ como templates e depois compiladas em versões específicas de cada IDE por scripts/sync-skills.sh. O prompt do agente de marketing de desempenho também é criado uma única vez em shared/agents/performance-marketing-agent/PROMPT.md e compilado nos arquivos de agente do Claude Code, Cursor e Codex pelo mesmo script de sincronização. O OpenClaw usa sua própria skill standalone. Consulte Arquitetura para o design completo.

Wireframe de Atualização Compartilhado

Edit once (source of truth)
  ├─ shared/skills/adspirer-*/SKILL.md
  └─ shared/agents/performance-marketing-agent/PROMPT.md
                |
                v
        ./scripts/sync-skills.sh
                |
                +--> Claude Code outputs
                |     ├─ skills/<name>/SKILL.md
                |     └─ agents/performance-marketing-agent.md
                |
                +--> Cursor outputs
                |     ├─ plugins/cursor/adspirer/.cursor/skills/adspirer-*/SKILL.md
                |     └─ plugins/cursor/adspirer/.cursor/agents/performance-marketing-agent.md
                |
                +--> Codex outputs
                |     ├─ plugins/codex/adspirer/skills/adspirer-*/SKILL.md
                |     └─ plugins/codex/adspirer/agents/performance-marketing-agent.toml
                |
                +--> Gemini CLI (reuses Claude Code skill)
                |     ├─ gemini-extension.json
                |     ├─ GEMINI.md
                |     └─ commands/adspirer/*.toml
                |
                └--> OpenClaw (standalone, not generated)
                      └─ plugins/openclaw/SKILL.md

Raízes do Cliente e Alvos de Instalação

Cliente de IA	Raiz de Origem no Repositório	Raiz Gerada/Execução no Repositório	Caminho/Método de Instalação do Usuário
Claude Code	Raiz do repositório + `shared/skills/` + `shared/agents/`	`skills/`, `agents/`, `commands/`, `.claude-plugin/`	`/plugin marketplace add amekala/ads-mcp` depois `/plugin install adspirer-advertising-agent`
Cursor	`plugins/cursor/adspirer/` + fontes compartilhadas	`plugins/cursor/adspirer/.cursor/skills/`, `plugins/cursor/adspirer/.cursor/agents/`	`bash <(curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/plugins/cursor/adspirer/install.sh)`
Codex	`plugins/codex/adspirer/` + fontes compartilhadas	`plugins/codex/adspirer/skills/`, `plugins/codex/adspirer/agents/`	`bash <(curl -fsSL https://raw.githubusercontent.com/amekala/ads-mcp/main/plugins/codex/adspirer/install.sh)`
Gemini CLI	Raiz do repositório	`gemini-extension.json`, `GEMINI.md`, `commands/adspirer/`	`gemini extensions install github.com/amekala/ads-mcp`
OpenClaw	`plugins/openclaw/`	`plugins/openclaw/` (standalone, sem geração por sincronização)	`openclaw plugins install openclaw-adspirer`

Guia do Desenvolvedor

Se você está contribuindo para este repositório ou adicionando novas plataformas de anúncios/suporte a IDEs:

Arquitetura — Modelo de skills compartilhado, sistema de templates, o que está feito e o que falta
Sintaxe de Templates e Fluxo de Sincronização — Substituição de variáveis, blocos condicionais, verificações de validação
Adicionando Plataformas de Anúncios — Como adicionar uma nova plataforma de anúncios (ex.: Snapchat, Pinterest, YouTube)
Adicionando IDEs — Como adicionar suporte a uma nova IDE (ex.: Windsurf, Cline)

Referência rápida

./scripts/sync-skills.sh          # Generate IDE-specific skills from templates
./scripts/sync-skills.sh --check  # Verify generated files match committed (CI mode)
./scripts/validate.sh             # Run all 62 offline validation checks
./scripts/validate.sh --live      # Also test MCP endpoint connectivity

Nunca edite arquivos em plugins/*/skills/, skills/, agents/ ou plugins/*/agents/ diretamente — eles serão sobrescritos pelo script de sincronização. Edite os templates em shared/skills/ e os prompts compartilhados em shared/agents/ em vez disso.

Licença

Proprietária — Consulte os Termos de Serviço para condições de uso.