OrbiAds

173 ferramentas para automatizar o Google Ad Manager — campanhas, criativos, inventário, relatórios via linguagem natural

GitHub

Experimente este MCPPatrocinado

Documentação

OrbiAds — Google Ad Manager MCP Server

English · Français

_{MCP hospedado para agentes de IA, além de um CLI Python para fluxos de terminal e CI.}

O OrbiAds é um servidor MCP hospedado do Google Ad Manager que dá aos assistentes de IA — Claude, ChatGPT, Gemini, Cursor e OpenAI Codex — acesso direto e em linguagem natural ao Google Ad Manager. Ele cobre mais de 270 operações em campanhas, pedidos, itens de linha, criativos, inventário, segmentação e relatórios, na API GAM atual (v202605), com OAuth e proteções de confirmação antes da escrita.

→ Comece gratuitamente em orbiads.com · ★ Dê uma estrela neste repositório

Experimente em 3 Minutos

MCP hospedado, sem instalação local

Crie uma conta gratuita OrbiAds em orbiads.com e conecte o Google Ad Manager.
Adicione este endpoint MCP ao Claude, ChatGPT, Gemini, Cursor, Codex ou Warp:
```
https://orbiads.com/mcp
```

Pergunte ao seu agente:

Connect to my GAM account and show me my active networks.

Teste rápido do CLI

pip install orbiads-cli
orbiads auth login
orbiads network info

Quer um caminho de configuração mais completo? Comece pelo guia do CLI ou pelos guias de instalação para agentes.

Sinais de Confiança

Sinal	Status	Link
Repositório público	Espelho licenciado MIT da distribuição MCP do OrbiAds	LICENSE
CLI no PyPI	Publicado como `orbiads-cli` para fluxos de terminal e CI	pypi.org/project/orbiads-cli
MCP hospedado	Endpoint HTTP remoto Streamable com OAuth	`https://orbiads.com/mcp`
Glama	Página de registro MCP indexada	glama.ai
MCP.so	Página de diretório MCP indexada	mcp.so
Registro MCP oficial	Manifesto `server.json` pronto para publicação no registro	server.json
Smithery	Alvo de submissão preparado para listagem MCP hospedada/externa	smithery.ai/new
Modelo de segurança	Planejar → confirmar → executar em ações de escrita	Documentação de segurança

Duas Formas de Conectar

O OrbiAds oferece dois métodos de integração — escolha o que se adapta ao seu fluxo de trabalho.

Opção A: Servidor MCP (agentes de IA)

Conecte seu assistente de IA (Claude, ChatGPT, Gemini) ao GAM por meio do endpoint MCP hospedado. Conversacional, guiado, sem instalação.

MCP endpoint: https://orbiads.com/mcp

Opção B: CLI (terminal e scripts)

Um CLI Python leve para desenvolvedores, pipelines de CI/CD e automação headless. Mesma API, mesmos créditos, mesmas proteções.

pip install orbiads-cli
orbiads auth login
orbiads network info

[!IMPORTANT] Aviso de PATH no Windows/macOS/Linux: Se você instalar o CLI via pip (especialmente com --user), certifique-se de que o diretório de scripts do Python seja adicionado ao seu PATH de usuário. Sem isso, seu terminal e agentes de IA locais (como Claude Code, Cursor ou Gemini) não conseguirão encontrar ou executar o comando orbiads. Consulte a seção de Solução de Problemas no Guia do CLI para comandos rápidos de configuração.

Comparação

Critério	Servidor MCP	CLI
Interface	Agente de IA (Claude, ChatGPT, Gemini)	Terminal / linha de comando
Instalação	URL para colar nas configurações do agente	`pip install orbiads-cli`
Autenticação	OAuth via navegador (automático)	Fluxo de Dispositivo OAuth (código exibido)
Melhor para	Exploração, conversas, fluxos guiados	Scripts, CI/CD, automação headless
Formato de saída	Linguagem natural via agente	JSON ou tabela estruturada
Créditos	Mesma grade de consumo	Mesma grade de consumo
Offline	Não — requer internet	Não — requer internet
Python necessário	Não	Sim (3.10+)

Ambos os métodos compartilham o mesmo backend, créditos e proteções de segurança.

Referência Rápida do CLI

Comando	Descrição
`orbiads auth login`	Autenticar via Fluxo de Dispositivo OAuth do Google
`orbiads auth status`	Verificar status de autenticação
`orbiads network info`	Mostrar detalhes da rede GAM atual
`orbiads network list`	Listar redes GAM acessíveis
`orbiads orders list`	Listar pedidos na rede
`orbiads line-items list --order ID`	Listar itens de linha de um pedido
`orbiads creatives list`	Listar criativos
`orbiads inventory ad-units`	Listar unidades de anúncio
`orbiads forecast check --ad-unit ID`	Verificar disponibilidade de inventário
`orbiads report run --template ID`	Executar um relatório de entrega

Referência completa de comandos: orbiads.com/docs/cli/commands

Guia de Instalação

O OrbiAds oferece três caminhos de integração dependendo do seu ambiente.

1. Servidor MCP sem instalação (ChatGPT, Gemini, Claude Desktop)

Conecte seu assistente de IA ao nosso servidor hospedado usando o Model Context Protocol:

Claude Desktop: Adicione isto ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "orbiads": {
      "type": "http",
      "url": "https://orbiads.com/mcp"
    }
  }
}

Gemini / AI Studio: Vá em Ferramentas → Configuração MCP → Adicionar https://orbiads.com/mcp
ChatGPT: Vá em Configurações → Conectores → Adicionar conector → URL MCP: https://orbiads.com/mcp
GLAMA / Registro MCP: Acesse, teste e conecte o servidor diretamente no seu navegador via glama.ai/mcp/servers/OrbiAds/Orbiads-GAM-MCP
Outros ambientes (Cursor, Codex, Warp): Adicione o endpoint https://orbiads.com/mcp à sua configuração e copie AGENTS.md para a raiz do seu projeto.

2. Plugin Claude Code (Comandos de Barra)

Adicione o conjunto de comandos /adops diretamente no seu terminal CLI do Claude Code:

claude plugin install orbiads

3. Habilidades de Agente (Fluxos de Trabalho Estruturados)

Instale permanentemente nossas diretrizes baseadas em markdown na memória do Claude Code:

Clone este repositório localmente.
Execute o instalador de habilidades:
```
./install.sh skills --copy
```

Isso copia nossos 6 arquivos de habilidades consolidados para o seu diretório ~/.claude/skills/. O Claude Code os utilizará automaticamente para prevenir alucinações e aplicar rigorosamente o fluxo de trabalho de planejar-antes-de-modificar.

→ Guias de instalação: Claude · ChatGPT · Gemini · OpenAI Codex

O que é o OrbiAds?

O OrbiAds é um servidor MCP hospedado que conecta seu assistente de IA diretamente ao Google Ad Manager (GAM). Em vez de navegar pela interface do GAM ou escrever scripts de API, você descreve o que deseja em linguagem simples — o OrbiAds cuida das chamadas de API, das proteções e do trilho de auditoria.

You: "Check inventory availability on the homepage banner for a 300x250 in France next week"
OrbiAds: [runs forecast] → Available: 1.2M impressions. Pressure: low. Safe to traffic.

You: "Create the line item for Renault, €15 CPM, Monday to Friday"
OrbiAds: [applies guardrails] → Preview ready. Confirm to push?

Sem scripts. Sem tokens de API para gerenciar. Sem alternar entre abas.

Para quem é isso?

Gerentes de AdOps que operam campanhas diariamente e querem ser mais rápidos sem cometer erros
Publishers que gerenciam sua própria rede GAM e querem fluxos de trabalho assistidos por IA
Agências de mídia que gerenciam múltiplas contas GAM e querem um processo consistente e auditável
Desenvolvedores que constroem automação de AdOps sobre Claude, ChatGPT ou Gemini

Plataformas de IA Suportadas

Plataforma	Guia de configuração	Modo
Claude (Desktop / claude.ai / Claude Code)	docs/install/claude.md	Plugin + MCP remoto
ChatGPT (conector Pro)	docs/install/chatgpt.md	MCP remoto (HTTP)
Gemini	docs/install/gemini.md	MCP remoto
GLAMA (registro MCP)	glama.ai/mcp/servers/OrbiAds/Orbiads-GAM-MCP	Registro MCP
Cursor / Codex / Warp / outros	AGENTS.md	AGENTS.md + conexão MCP

Todas as plataformas se conectam ao mesmo endpoint MCP hospedado em https://orbiads.com/mcp.

7 Comandos de Barra

Após instalar o plugin, estes comandos /adops estão disponíveis diretamente no Claude Code.

Comando	O que faz
`/adops campaign`	Ler estado ao vivo, planejar implantação, simulação (`ExecutionPlan`), implantar, pausar, reverter — com gate obrigatório de planejar→confirmar→executar
`/adops audit`	Auditoria de conta multidimensional: entrega, inventário, segurança, criativos, faturamento
`/adops report`	Relatórios personalizados, consultas de entrega, exportação CSV, resumos de faturamento, previsões
`/adops deal`	Acordos PMP, leilões privados, propostas PG/PD do Marketplace
`/adops creative`	Enviar criativos, conformidade de QA, validação SSL, URLs de pré-visualização, associação de itens de linha
`/adops inventory`	Navegar por unidades de anúncio, gerenciar posicionamentos e taxonomia de segmentação, executar blueprints
`/adops admin`	Equipes, sites, rótulos, campos personalizados, configurações de rede (somente superfície MCP)

O que está Incluído (Ferramentas e Habilidades MCP)

A superfície do OrbiAds mapeia a API do Google Ad Manager em ferramentas principais e centenas de ações, organizadas em 6 Habilidades de Agente de domínio principais mais um orquestrador, para manter o uso de contexto limpo. Veja docs/tool-matrix/README.md para as contagens ao vivo de ferramentas e ações geradas.

Clique em qualquer domínio abaixo para ver quais ferramentas e capacidades estão incluídas:

1. Campanhas e QA de Criativos (orbiads-campaigns)

campaign — Ler estado ao vivo da campanha, planejar implantação, simular, implantar, pausar e reverter campanhas.
orders — Criar e listar pedidos, contatos e funções.
line_items — Definir regras de entrega de itens de linha, CPMs e lógica de segmentação.
creatives — Enviar criativos (imagens, HTML5, vídeo/áudio) e configurar estilos nativos.
creative_assets — Gerenciar ativos de imagem e arquivos associados.
creative_qa — Auditar rastreadores de clique, realizar varreduras de conformidade e validar certificados SSL.
creative_wrapper_skill — Gerenciar wrappers de terceiros e predefinições de entrega.
formats — Descobrir e configurar formatos de criativos de anúncio.
jobs e gam_jobs — Monitorar compilação assíncrona de campanhas e fluxos de implantação.

2. Inventário e Segmentação (orbiads-inventory)

inventory — Recuperar árvores de unidades de anúncio, tamanhos e gerar manifestos ads.json.
placements — Criar, atualizar e listar grupos de posicionamento de anúncios.
targeting — Gerenciar chaves/valores de segmentação personalizada, países e categorias.
audiences — Recuperar e modificar segmentos de audiência primários.
blueprint — Gerar e enviar blueprints estruturados de inventário de rede.

3. Relatórios e Previsões (orbiads-reporting)

reporting — Executar relatórios personalizados a partir de modelos, verificar entrega de itens de linha e integrar GA4.
preview — Verificar cobertura de inventário e exportar URLs de pré-visualização.
pql — Executar consultas brutas de banco de dados PQL.

4. Acordos Programáticos (orbiads-deals)

deals — Gerenciar acordos PMP, leilões privados e compradores do marketplace.
companies — Gerenciar perfis de empresas de agências e anunciantes.

5. Administração de Rede (orbiads-admin)

gam_admin — Acessar campos avançados, rótulos de rede, equipes e registros de sites.
gam_features — Consultar recursos beta e de sistema ativos do Google Ad Manager.
network — Listar redes acessíveis e alternar o contexto de rede ativa.
settings — Configurar CPMs padrão, ritmo de entrega e modelos de nomenclatura de marca.
tenant_catalog — Acessar catálogos específicos do tenant.

6. Auditorias e Faturamento (orbiads-audit)

* `audit_skill` — Execute auditorias automatizadas de segurança, higiene e cobertura de wrappers. * `billing` — Obtenha saldos de créditos e históricos de transações. * `audit` — Pesquise logs de auditoria da rede.

Veja docs/tool-matrix/README.md para a matriz de paridade completa detalhando custos exatos, gravações e parâmetros para todas as 270+ ações.

Segurança por Design

Toda ação de gravação exige um token ExecutionPlan explícito de pré-visualização e confirmação. Nenhuma campanha vai ao ar por acidente.

Planeje antes de alterar em gravações de campanhas, negócios e produtos — pré-visualize o ExecutionPlan assinado antes de enviar
Modo de teste (dry-run) em todas as ações de implantação — confirmationToken com TTL de 300 segundos
Portão de previsão antes de compromissos de inventário — disponibilidade verificada antecipadamente
Trilha de auditoria em cada ação — quem fez o quê, quando, com qual resultado
Guarda de créditos — operações de leitura são sempre gratuitas, gravações debitam créditos de forma transparente

Início Rápido (3 passos)

1. Crie sua conta gratuita

Acesse orbiads.com e cadastre-se. Você ganha 5 créditos gratuitos — sem necessidade de cartão de crédito.

2. Conecte o Google Ad Manager

No painel da OrbiAds, clique em Conectar GAM e autorize com sua conta Google. A OrbiAds usa OAuth — suas credenciais do GAM nunca saem da infraestrutura do Google.

3. Configure seu assistente de IA

Escolha sua plataforma e siga o guia:

Em seguida, comece com:

"Conecte-se à minha conta GAM e mostre minhas redes ativas"

Detalhes do Servidor MCP

Propriedade	Valor
Endpoint	`https://orbiads.com/mcp`
Transporte	`streamable-http` (padrão) · `sse`
Autenticação	OAuth 2.0 — conta Google via OrbiAds
Versão da API GAM	`v202605`
Protocolo MCP	`2025-03-26`

Estrutura do Repositório

skills/           ← orchestrator skill + 6 consolidated dual-surface domain skills (generated)
                     Each domain skill has SKILL.md (thin) + references/actions.md (full catalogue)
commands/         ← 7 /adops slash commands for Claude Code
agents/           ← Parallel audit subagents (audit-delivery, audit-inventory, …)
hooks/            ← Claude Code hooks (hooks.json)
cli/              ← OrbiAds CLI package (pip install orbiads-cli)
docs/             ← Installation guides, tool matrix, custom-skill authoring guide
_docs/            ← Internal: legacy tool mapping, anti-collision rules
.claude-plugin/   ← Claude plugin manifest (plugin.json, marketplace.json)
AGENTS.md         ← Cross-LLM contract for Cursor, Codex, Gemini, Warp, etc.
CLAUDE.md         ← Claude Code project guidance

As skills e a matriz de ferramentas são geradas a partir do catálogo do backend — não as edite manualmente. Veja CLAUDE.md para a divisão entre gerado e escrito manualmente.

Preços

Plano	Preço	Créditos
Trial	Grátis	5 créditos (sem cartão)
Starter	€39/mês	50 créditos/mês
Acesso Antecipado	€29/mês ← bloqueado para sempre	50 créditos/mês
Pacote S	€29 pagamento único	+50 créditos
Pacote L	€45 pagamento único	+100 créditos

Leituras são sempre gratuitas. Créditos são consumidos apenas em operações de gravação e implantação.

Comece grátis →

Licença

O conteúdo deste repositório — estrutura de distribuição, skills, agentes, workflows, esquemas JSON, cliente CLI, manifestos de integração de plataformas, documentação e exemplos — é lançado sob a Licença MIT.

O backend do servidor MCP da OrbiAds e os serviços Cloud Run aos quais o endpoint hospedado em https://orbiads.com/mcp se conecta NÃO estão neste repositório e são regidos por termos proprietários separados — veja os termos em orbiads.com.