PropellerAds MCP 服务器

用 AI 普及程序化广告

让像 Claude 这样的 AI 助手自动管理您在 PropellerAds 上的广告系列。

快速开始 • 可用工具 • 使用示例 • MCP 配置

这是什么？

PropellerAds MCP 是一个 模型上下文协议 (Model Context Protocol) 服务器，它将 AI 助手（Claude 以及任何兼容 MCP 的客户端）直接连接到 PropellerAds 广告平台 API。无需手动登录仪表板、提取报告和点击设置，您只需用简单的英语与您的 AI 助手交谈，它就会为您处理一切。

创建广告系列、分析性能、屏蔽表现不佳的广告位、寻找扩展机会、比较时间段——所有这些都可以通过自然对话完成。

专为以下人群打造：

• 媒体买家和效果营销人员

• iGaming 和应用安装联盟营销人员

• 增长黑客和数字营销代理机构

• 任何希望提高工作效率的 PropellerAds 广告系列运营者

功能特性

• 完整的广告系列生命周期 -- 无需离开聊天界面即可创建、更新、启动、停止和克隆广告系列

• 实时性能分析 -- 自动计算展示量、点击量、转化量、CTR、CVR、CPC、CPA 和 ROI

• 周期对比 -- 并排比较任意两个日期范围，并带有趋势指标

• 广告位级优化 -- 找出浪费预算的表现不佳的广告位，以及值得加入白名单的顶级广告位

• 自动屏蔽 -- 一条指令即可识别并屏蔽不良广告位（带有试运行安全模式）

• 智能扩展 -- 自动寻找具有高 ROI 和转化量且准备好扩展的广告系列

• 创意性能细分 -- 查看哪些创意能带来效果，哪些需要更换

• 安全设计 -- API 令牌存储在环境变量中，绝不会在对话中泄露

• 试运行安全机制 -- 破坏性操作在执行前默认为预览模式

可用工具

广告系列管理

list_campaigns 的过滤器： status (active/paused/pending/rejected), ad_format (push/onclick/interstitial/in-page-push), name (部分匹配)

统计与分析

常用可选参数： date_from, date_to (YYYY-MM-DD，默认为过去 7 天), campaign_id, group_by (date/campaign/zone/country/creative/device_type/browser/os)

优化

定向

账户

技术栈

快速开始

先决条件

1. PropellerAds 账户（需具备 API 访问权限）

   • 最低要求：总支出或充值达到 $1,000

   • 获取您的 API 令牌：https://ssp.propellerads.com/#/app/profile

2. Python 3.10+

3. Claude Desktop 或 Claude Code（或任何兼容 MCP 的客户端）

安装

选项 1：从 PyPI 安装（推荐）

pip install propellerads-mcp

选项 2：从源码安装

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

设置您的 API 令牌

在项目根目录创建一个 .env 文件或导出环境变量：

export PROPELLERADS_API_TOKEN="your_api_token_here"

使用示例

广告系列管理

"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"

性能分析

"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%?"

优化工作流

"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"

日常优化流程

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"

MCP 配置

Claude Desktop

添加到您的 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"
      }
    }
  }
}

保存配置后重启 Claude Desktop。

Claude Code

使用 CLI 将 MCP 服务器添加到 Claude Code：

claude mcp add propellerads -- python -m propellerads_mcp

在启动 Claude Code 之前，请确保在 shell 环境中设置了 PROPELLERADS_API_TOKEN。

其他 MCP 客户端

此服务器使用 stdio 传输，这是标准的 MCP 通信方法。任何兼容 MCP 的客户端都可以通过启动该进程进行连接：

python -m propellerads_mcp

服务器从环境中读取 PROPELLERADS_API_TOKEN。请通过 MCP 客户端的 env 配置传递它，或在您的 shell 中设置它。

项目结构

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

安全与权限

贡献

欢迎贡献！您可以这样提供帮助：

1. Fork 本仓库

2. 创建 功能分支 (git checkout -b feature/my-feature)

3. 提交 您的更改 (git commit -m "Add my feature")

4. 推送 到您的分支 (git push origin feature/my-feature)

5. 发起 Pull Request

对于错误报告和功能请求，请 提交 issue。

作者

Jan Naftanaila -- 媒体买家与 AI 自动化专家

致力于构建连接 AI 与程序化广告的工具。专注于让广告技术变得易于访问、自动化且智能化。

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。

PropellerAds MCP -- 开源。为程序化广告社区打造。