Servidor MCP de PropellerAds

Democratizando la publicidad programática con IA

Deja que asistentes de IA como Claude gestionen tus campañas publicitarias en PropellerAds automáticamente.

Inicio rápido • Herramientas disponibles • Ejemplos de uso • Configuración de MCP

¿Qué es esto?

PropellerAds MCP es un servidor del Protocolo de Contexto de Modelos (MCP) que conecta a los asistentes de IA (Claude y cualquier cliente compatible con MCP) directamente con la API de la plataforma publicitaria PropellerAds. En lugar de iniciar sesión manualmente en los paneles, extraer informes y hacer clic en la configuración, simplemente hablas con tu asistente de IA en lenguaje natural y él se encarga de todo por ti.

Crea campañas, analiza el rendimiento, añade zonas de bajo rendimiento a listas negras, encuentra oportunidades de escalado, compara periodos de tiempo... todo a través de una conversación natural.

Creado para:

• Compradores de medios y especialistas en marketing de rendimiento

• Afiliados de iGaming y de instalación de aplicaciones

• Growth Hackers y agencias digitales

• Cualquier persona que ejecute campañas en PropellerAds y quiera trabajar más rápido

Características

• Ciclo de vida completo de la campaña -- Crea, actualiza, inicia, detén y clona campañas sin salir de tu chat

• Análisis de rendimiento en tiempo real -- Impresiones, clics, conversiones, CTR, CVR, CPC, CPA y ROI calculados automáticamente

• Comparación periodo a periodo -- Compara dos rangos de fechas cualesquiera lado a lado con indicadores de tendencia

• Optimización a nivel de zona -- Encuentra zonas de bajo rendimiento que desperdician presupuesto y zonas principales que vale la pena incluir en listas blancas

• Listas negras automatizadas -- Un comando para identificar y añadir zonas malas a la lista negra (con modo de seguridad de prueba)

• Inteligencia de escalado -- Encuentra automáticamente campañas con un ROI sólido y volumen de conversión listas para escalar

• Desglose del rendimiento creativo -- Mira qué creatividades generan resultados y cuáles necesitan ser reemplazadas

• Seguro por diseño -- Token de API almacenado en variables de entorno, nunca expuesto en la conversación

• Seguridad de prueba (Dry Run) -- Las operaciones destructivas se ejecutan por defecto en modo de vista previa antes de ejecutarse

Herramientas disponibles

Gestión de campañas

Filtros para list_campaigns: status (active/paused/pending/rejected), ad_format (push/onclick/interstitial/in-page-push), name (coincidencia parcial)

Estadísticas y análisis

Parámetros opcionales comunes: date_from, date_to (YYYY-MM-DD, por defecto los últimos 7 días), campaign_id, group_by (date/campaign/zone/country/creative/device_type/browser/os)

Optimización

Segmentación

Cuenta

Stack tecnológico

Inicio rápido

Requisitos previos

1. Cuenta de PropellerAds con acceso a la API

   • Requisito mínimo: $1,000 de gasto total o depósito

   • Obtén tu token de API: https://ssp.propellerads.com/#/app/profile

2. Python 3.10+

3. Claude Desktop o Claude Code (o cualquier cliente compatible con MCP)

Instalación

Opción 1: Instalar desde PyPI (Recomendado)

pip install propellerads-mcp

Opción 2: Instalar desde el código fuente

git clone https://github.com/JanNafta/propellerads-mcp.git
cd propellerads-mcp
pip install -e .

Configura tu token de API

Crea un archivo .env en la raíz del proyecto o exporta la variable de entorno:

export PROPELLERADS_API_TOKEN="your_api_token_here"

Ejemplos de uso

Gestión de campañas

"Show me all my active campaigns sorted by ROI"

"Create a push campaign for gaming offers in Brazil with $100 daily budget"

"Pause all campaigns with negative ROI in the last 7 days"

"Clone my best performing campaign to Mexico, Colombia, and Peru"

Análisis de rendimiento

"What's my campaign performance for the last week?"

"Compare this week's performance vs last week"

"Show me the top 10 zones by conversions for campaign 12345"

"Which creatives have CTR below 0.5%?"

Flujos de trabajo de optimización

"Find all zones spending over $50 without conversions and blacklist them"

"Show me campaigns ready for scaling -- ROI above 50% with at least 10 conversions"

"Find top performing zones for my dating campaigns and add them to a whitelist"

Rutina de optimización diaria

1. "Show me yesterday's performance for all campaigns"
2. "Find and blacklist underperforming zones across all campaigns"
3. "Which campaigns are ready for scaling?"
4. "Increase budget by 50% for profitable campaigns"

Configuración de MCP

Claude Desktop

Añade al archivo de configuración de Claude Desktop:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "propellerads": {
      "command": "python",
      "args": ["-m", "propellerads_mcp"],
      "env": {
        "PROPELLERADS_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Reinicia Claude Desktop después de guardar la configuración.

Claude Code

Añade el servidor MCP a Claude Code usando la CLI:

claude mcp add propellerads -- python -m propellerads_mcp

Asegúrate de que PROPELLERADS_API_TOKEN esté configurado en tu entorno de shell antes de iniciar Claude Code.

Otros clientes MCP

Este servidor utiliza transporte stdio, el método de comunicación estándar de MCP. Cualquier cliente compatible con MCP puede conectarse iniciando el proceso:

python -m propellerads_mcp

El servidor lee PROPELLERADS_API_TOKEN del entorno. Pásalo a través de la configuración env de tu cliente MCP o configúralo en tu shell.

Estructura del proyecto

propellerads-mcp/
├── src/
│   └── propellerads_mcp/
│       ├── __init__.py       # Package init, version, exports
│       ├── __main__.py       # Module entry point (python -m)
│       ├── client.py         # PropellerAds API client (httpx-based)
│       └── server.py         # MCP server, tool definitions & handlers
├── .env.example              # Environment variable template
├── .gitignore
├── LICENSE                   # MIT License
├── pyproject.toml            # Build config, dependencies, metadata
└── README.md

Seguridad y permisos

Contribución

¡Las contribuciones son bienvenidas! Así es como puedes ayudar:

1. Haz un fork del repositorio

2. Crea una rama de características (git checkout -b feature/my-feature)

3. Confirma tus cambios (git commit -m "Add my feature")

4. Envía a tu rama (git push origin feature/my-feature)

5. Abre una Pull Request

Para errores y solicitudes de funciones, por favor abre un issue.

Autor

Jan Naftanaila -- Comprador de medios y especialista en automatización de IA

Construyendo herramientas que cierran la brecha entre la IA y la publicidad programática. Enfocado en hacer que la tecnología publicitaria sea accesible, automatizada e inteligente.

Licencia

Este proyecto está bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.

PropellerAds MCP -- Código abierto. Creado para la comunidad de publicidad programática.