PropellerAds MCP Server

PropellerAds MCP服务器

利用人工智能实现程序化广告的民主化

    ](https://github.com/JanNafta/propellerads-mcp/stargazers) ](https://github.com/JanNafta/propellerads-mcp/network/members)

让AI助手喜欢 克劳德 管理您的广告活动 螺旋桨广告 自动。

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

______________________________________________________________________

这是什么？

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

创建活动、分析绩效、将表现不佳的区域列入黑名单、寻找扩展机会、比较时间段——所有这些都是通过自然对话完成的。

适用于：

• 媒体购买者和性能营销人员
• iGaming和应用程序安装联盟
• 增长黑客和数字机构
• 任何运行PropellerAds活动并希望更快工作的人

______________________________________________________________________

特性

• 完整的活动生命周期 --无需离开聊天室即可创建、更新、启动、停止和克隆活动
• 实时性能分析 --自动计算印象、点击、转化、CTR、CVR、CPC、CPA和ROI
• 期间比较 --将任意两个日期范围与趋势指标并排比较
• 区域级优化 --查找表现不佳的浪费预算的区域和值得列入白名单的顶级区域
• 自动黑名单 --识别不良区域并将其列入黑名单的一个命令（具有干运行安全模式）
• 扩展智能 --自动查找具有高投资回报率和可扩展转化率的营销活动
• 创意绩效分解 --查看哪些创意推动了结果，哪些需要替换
• 设计安全 --API令牌存储在环境变量中，从不在对话中公开
• 干运行安全 --破坏性操作在执行前默认为预览模式

______________________________________________________________________

可用工具

活动管理

过滤器 list_campaigns: status （活动/暂停/挂起/拒绝）， ad_format （推/点击/填隙/页面内推）， name （部分匹配）

统计与分析

常见可选参数： date_from, date_to （YYYY-MM-DD，默认为过去7天）， campaign_id, group_by （日期/活动/地区/国家/创意/设备类型/浏览器/os）

优化

定向

账户

______________________________________________________________________

技术栈

______________________________________________________________________

快速开始

先决条件

1. Propeller广告账户 具有API访问权限

- 最低要求：总支出或存款1000美元 - 获取您的API令牌：https://ssp.propellerads.com/#/app/profile

1. Python 3.10+
2. 克劳德桌面 或 克劳德代码 （或任何兼容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配置文件中：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 视窗: %APPDATA%\Claude\claude_desktop_config.json

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

保存配置后重新启动Claude Desktop。

克劳德代码

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

claude mcp add propellerads -- python -m propellerads_mcp

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

其他MCP客户端

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

python -m propellerads_mcp

服务器读取 PROPELLERADS_API_TOKEN 从环境。通过 env 配置MCP客户端或在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. 分叉 存储库
2. 创建 特征分支(git checkout -b feature/my-feature)
3. 承诺 您的更改(git commit -m "Add my feature")
4. 推 到您的分行(git push origin feature/my-feature)
5. 打开 拉取请求

对于错误和功能请求，请 打开一个问题.

______________________________________________________________________

作者

Jan Naftanaila --媒体买家和人工智能自动化专家

构建弥合人工智能和程序化广告之间差距的工具。专注于使广告技术变得可访问、自动化和智能化。

  ](https://github.com/JanNafta)

______________________________________________________________________

许可证

该项目根据 MIT许可证。请参阅 许可证 文件以获取详细信息。

______________________________________________________________________

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