OrbiAds

173 herramientas para automatizar Google Ad Manager: campañas, creativos, inventario, informes mediante lenguaje natural

GitHub

Prueba este MCPPatrocinado

Documentación

OrbiAds — Servidor MCP de Google Ad Manager

English · Français

_{MCP alojado para agentes de IA, además de un CLI de Python para flujos de terminal y CI.}

OrbiAds es un servidor MCP alojado de Google Ad Manager que brinda a los asistentes de IA — Claude, ChatGPT, Gemini, Cursor y OpenAI Codex — acceso directo en lenguaje natural a Google Ad Manager. Cubre más de 270 operaciones en campañas, pedidos, elementos de línea, creatividades, inventario, segmentación e informes, en la API GAM actual (v202605), con OAuth y protecciones de confirmación antes de escribir.

→ Comienza gratis en orbiads.com · ★ Marca este repositorio con una estrella

Pruébalo en 3 minutos

MCP alojado, sin instalación local

Crea una cuenta gratuita de OrbiAds en orbiads.com y conecta Google Ad Manager.
Añade este endpoint MCP a Claude, ChatGPT, Gemini, Cursor, Codex o Warp:
```
https://orbiads.com/mcp
```

Pregunta a tu agente:

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

Prueba rápida del CLI

pip install orbiads-cli
orbiads auth login
orbiads network info

¿Quieres una ruta de configuración más detallada? Comienza con la guía del CLI o las guías de instalación para agentes.

Señales de confianza

Señal	Estado	Enlace
Repositorio público	Espejo con licencia MIT de la distribución MCP de OrbiAds	LICENCIA
CLI en PyPI	Publicado como `orbiads-cli` para flujos de terminal y CI	pypi.org/project/orbiads-cli
MCP alojado	Endpoint HTTP remoto y transmisible con OAuth	`https://orbiads.com/mcp`
Glama	Página de registro MCP indexada	glama.ai
MCP.so	Página de directorio MCP indexada	mcp.so
Registro MCP oficial	Manifiesto `server.json` listo para publicación en el registro	server.json
Smithery	Objetivo de envío preparado para listado MCP alojado/externo	smithery.ai/new
Modelo de seguridad	Planificar → confirmar → ejecutar en acciones de escritura	Documentación de seguridad

Dos formas de conectarse

OrbiAds ofrece dos métodos de integración: elige el que se adapte a tu flujo de trabajo.

Opción A: Servidor MCP (agentes de IA)

Conecta tu asistente de IA (Claude, ChatGPT, Gemini) a GAM mediante el endpoint MCP alojado. Conversacional, guiado y sin instalación.

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

Opción B: CLI (terminal y scripts)

Un CLI de Python ligero para desarrolladores, pipelines de CI/CD y automatización sin interfaz. Misma API, mismos créditos, mismas protecciones.

pip install orbiads-cli
orbiads auth login
orbiads network info

[!IMPORTANTE] Advertencia sobre PATH en Windows/macOS/Linux: Si instalas el CLI mediante pip (especialmente con --user), asegúrate de que el directorio de scripts de Python se añada a tu PATH de usuario. Sin esto, tu terminal y tus agentes de IA locales (como Claude Code, Cursor o Gemini) no podrán encontrar ni ejecutar el comando orbiads. Consulta la sección de solución de problemas en la Guía del CLI para comandos de configuración rápidos.

Comparación

Criterio	Servidor MCP	CLI
Interfaz	Agente de IA (Claude, ChatGPT, Gemini)	Terminal / línea de comandos
Instalación	URL para pegar en la configuración del agente	`pip install orbiads-cli`
Autenticación	OAuth mediante navegador (automático)	Flujo de dispositivo OAuth (código mostrado)
Ideal para	Exploración, conversaciones, flujos guiados	Scripts, CI/CD, automatización sin interfaz
Formato de salida	Lenguaje natural a través del agente	JSON o tabla estructurada
Créditos	Misma cuadrícula de consumo	Misma cuadrícula de consumo
Sin conexión	No: requiere internet	No: requiere internet
Python requerido	No	Sí (3.10+)

Ambos métodos comparten el mismo backend, créditos y protecciones de seguridad.

Referencia rápida del CLI

Comando	Descripción
`orbiads auth login`	Autenticarse mediante el flujo de dispositivo OAuth de Google
`orbiads auth status`	Comprobar el estado de autenticación
`orbiads network info`	Mostrar los detalles actuales de la red GAM
`orbiads network list`	Listar las redes GAM accesibles
`orbiads orders list`	Listar pedidos en la red
`orbiads line-items list --order ID`	Listar elementos de línea de un pedido
`orbiads creatives list`	Listar creatividades
`orbiads inventory ad-units`	Listar unidades publicitarias
`orbiads forecast check --ad-unit ID`	Comprobar la disponibilidad de inventario
`orbiads report run --template ID`	Ejecutar un informe de entrega

Referencia completa de comandos: orbiads.com/docs/cli/commands

Guía de instalación

OrbiAds ofrece tres vías de integración según tu entorno.

1. Servidor MCP sin instalación (ChatGPT, Gemini, Claude Desktop)

Conecta tu asistente de IA a nuestro servidor alojado mediante el Protocolo de Contexto de Modelo:

Claude Desktop: Añade esto a tu claude_desktop_config.json:

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

Gemini / AI Studio: Ve a Herramientas → Configuración de MCP → Añadir https://orbiads.com/mcp
ChatGPT: Ve a Configuración → Conectores → Añadir conector → URL de MCP: https://orbiads.com/mcp
GLAMA / Registro MCP: Accede, prueba y conecta el servidor directamente en tu navegador mediante glama.ai/mcp/servers/OrbiAds/Orbiads-GAM-MCP
Otros entornos (Cursor, Codex, Warp): Añade el endpoint https://orbiads.com/mcp a tu configuración y copia AGENTS.md a la raíz de tu proyecto.

2. Plugin de Claude Code (comandos de barra)

Añade el conjunto de comandos /adops directamente a tu terminal de Claude Code CLI:

claude plugin install orbiads

3. Habilidades de agente (flujos de trabajo estructurados)

Instala nuestras pautas basadas en Markdown de forma permanente en la memoria de Claude Code:

Clona este repositorio localmente.
Ejecuta el instalador de habilidades:
```
./install.sh skills --copy
```

Esto copia nuestros 6 archivos de habilidades consolidados a tu directorio ~/.claude/skills/. Claude Code los aprovechará automáticamente para evitar alucinaciones y aplicar estrictamente el flujo de trabajo de planificar antes de mutar.

→ Guías de instalación: Claude · ChatGPT · Gemini · OpenAI Codex

¿Qué es OrbiAds?

OrbiAds es un servidor MCP alojado que conecta tu asistente de IA directamente a Google Ad Manager (GAM). En lugar de navegar por la interfaz de GAM o escribir scripts de API, describes lo que quieres en lenguaje natural: OrbiAds gestiona las llamadas a la API, las protecciones y el registro de auditoría.

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?

Sin scripts. Sin tokens de API que gestionar. Sin cambiar de pestañas.

¿Para quién es?

Gestores de AdOps que gestionan campañas a diario y quieren avanzar más rápido sin cometer errores
Editores que gestionan su propia red GAM y quieren flujos de trabajo asistidos por IA
Agencias de medios que gestionan varias cuentas GAM y quieren un proceso coherente y auditable
Desarrolladores que crean automatización de AdOps sobre Claude, ChatGPT o Gemini

Plataformas de IA compatibles

Plataforma	Guía de configuración	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 / otros	AGENTS.md	AGENTS.md + conexión MCP

Todas las plataformas se conectan al mismo endpoint MCP alojado en https://orbiads.com/mcp.

7 comandos de barra

Después de instalar el plugin, estos comandos /adops están disponibles directamente en Claude Code.

Comando	Qué hace
`/adops campaign`	Leer el estado en vivo, planificar el despliegue, simulación (`ExecutionPlan`), desplegar, pausar, revertir — con puerta obligatoria de planificar→confirmar→ejecutar
`/adops audit`	Auditoría de cuenta multidimensional: entrega, inventario, seguridad, creatividades, facturación
`/adops report`	Informes personalizados, consultas de entrega, exportación CSV, resúmenes de facturación, previsiones
`/adops deal`	Acuerdos PMP, subastas privadas, propuestas PG/PD de Marketplace
`/adops creative`	Subir creatividades, cumplimiento de QA, validación SSL, URL de vista previa, asociación de elementos de línea
`/adops inventory`	Explorar unidades publicitarias, gestionar ubicaciones y taxonomía de segmentación, ejecutar planos
`/adops admin`	Equipos, sitios, etiquetas, campos personalizados, configuración de red (solo superficie MCP)

Qué incluye (herramientas y habilidades MCP)

La superficie de OrbiAds asigna la API de Google Ad Manager a herramientas principales y cientos de acciones, organizadas en 6 habilidades de agente de dominio central más un orquestador, para mantener limpio el uso de contexto. Consulta docs/tool-matrix/README.md para ver los recuentos de herramientas y acciones generados en vivo.

Haz clic en cualquier dominio a continuación para ver qué herramientas y capacidades incluye:

1. Campañas y QA de creatividades (orbiads-campaigns)

campaign — Leer el estado en vivo de la campaña, planificar el despliegue, simulación, desplegar, pausar y revertir campañas.
orders — Crear y listar pedidos, contactos y roles.
line_items — Definir reglas de entrega de elementos de línea, CPM y lógica de segmentación.
creatives — Subir creatividades (imágenes, HTML5, video/audio) y configurar estilos nativos.
creative_assets — Gestionar activos de imagen y archivo asociados.
creative_qa — Auditar rastreadores de clics, realizar escaneos de cumplimiento y validar certificados SSL.
creative_wrapper_skill — Gestionar envoltorios de terceros y ajustes preestablecidos de entrega.
formats — Descubrir y configurar formatos de creatividades publicitarias.
jobs y gam_jobs — Supervisar flujos de trabajo asíncronos de compilación y despliegue de campañas.

2. Inventario y segmentación (orbiads-inventory)

inventory — Recuperar árboles de unidades publicitarias, tamaños y generar manifiestos ads.json.
placements — Crear, actualizar y listar grupos de ubicaciones publicitarias.
targeting — Gestionar claves/valores de segmentación personalizados, países y categorías.
audiences — Recuperar y modificar segmentos de audiencia de origen propio.
blueprint — Generar y enviar planos de inventario de red estructurados.

3. Informes y previsiones (orbiads-reporting)

reporting — Ejecutar informes personalizados a partir de plantillas, comprobar la entrega de elementos de línea e integrar GA4.
preview — Verificar la cobertura de inventario y exportar URL de vista previa.
pql — Ejecutar consultas PQL sin procesar.

4. Acuerdos programáticos (orbiads-deals)

deals — Gestionar acuerdos PMP, subastas privadas y compradores de Marketplace.
companies — Gestionar perfiles de empresas de agencias y anunciantes.

5. Administración de red (orbiads-admin)

gam_admin — Acceder a campos avanzados, etiquetas de red, equipos y registros de sitios.
gam_features — Consultar funciones beta y del sistema activas de Google Ad Manager.
network — Listar redes accesibles y cambiar el contexto de red activo.
settings — Configurar CPM predeterminados, ritmo y plantillas de nomenclatura de marca.
tenant_catalog — Acceder a catálogos específicos del inquilino.

6. Auditorías y facturación (orbiads-audit)

* `audit_skill` — Ejecuta auditorías automatizadas de seguridad, higiene y cobertura de wrappers. * `billing` — Obtén saldos de créditos e historiales de transacciones. * `audit` — Busca en los registros de auditoría de la red.

Consulta docs/tool-matrix/README.md para la matriz de paridad completa que detalla costos exactos, escrituras y parámetros de las más de 270 acciones.

Seguridad por Diseño

Cada acción de escritura requiere una vista previa explícita de ExecutionPlan y un token de confirmación. Ninguna campaña se publica por accidente.

Planificar antes de mutar en escrituras de campañas, acuerdos y productos: previsualiza el ExecutionPlan firmado antes de enviar
Modo de prueba en seco en todas las acciones de despliegue: confirmationToken TTL 300 segundos
Compuerta de pronóstico antes de confirmar inventario: disponibilidad verificada de antemano
Registro de auditoría en cada acción: quién hizo qué, cuándo y con qué resultado
Protector de créditos: las operaciones de lectura siempre son gratuitas; las escrituras descuentan créditos de forma transparente

Inicio Rápido (3 pasos)

1. Crea tu cuenta gratuita

Ve a orbiads.com y regístrate. Obtienes 5 créditos gratis, sin necesidad de tarjeta de crédito.

2. Conecta Google Ad Manager

Desde el panel de OrbiAds, haz clic en Conectar GAM y autoriza con tu cuenta de Google. OrbiAds usa OAuth: tus credenciales de GAM nunca salen de la infraestructura de Google.

3. Configura tu asistente de IA

Elige tu plataforma y sigue la guía:

Luego comienza con:

"Conéctate a mi cuenta de GAM y muéstrame mis redes activas"

Detalles del Servidor MCP

Propiedad	Valor
Endpoint	`https://orbiads.com/mcp`
Transporte	`streamable-http` (predeterminado) · `sse`
Autenticación	OAuth 2.0: cuenta de Google a través de OrbiAds
Versión de la API de GAM	`v202605`
Protocolo MCP	`2025-03-26`

Estructura del Repositorio

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

Las skills y la matriz de herramientas se generan a partir del catálogo del backend; no las edites manualmente. Consulta CLAUDE.md para el desglose de lo generado frente a lo escrito a mano.

Precios

Plan	Precio	Créditos
Prueba	Gratis	5 créditos (sin tarjeta)
Starter	39 €/mes	50 créditos/mes
Acceso anticipado	29 €/mes ← bloqueado de por vida	50 créditos/mes
Pack S	29 € único	+50 créditos
Pack L	45 € único	+100 créditos

Las lecturas siempre son gratuitas. Los créditos solo se consumen en operaciones de escritura y despliegue.

Empieza gratis →

Licencia

El contenido de este repositorio (andamiaje de distribución, skills, agentes, flujos de trabajo, esquemas JSON, cliente CLI, manifiestos de integración de plataformas, documentación y ejemplos) se publica bajo la Licencia MIT.

El backend del servidor MCP de OrbiAds y los servicios de Cloud Run a los que se conecta el endpoint alojado en https://orbiads.com/mcp NO están en este repositorio y se rigen por términos propietarios separados: consulta los términos en orbiads.com.