螺旋桨广告-MCP
项目介绍
PropellerAds MCP Server 🚀
通过AI实现程序化广告的普及
利用AI驱动的活动优化来改变您的媒体购买。此MCP（模型上下文协议）服务器将PropellerAds的强大程序化广告平台与Claude集成，支持自动活动管理、实时优化和数据驱动决策。
🎯 为什么选择PropellerAds MCP？
在快速变化的程序化广告世界中，成功取决于迅速决策和持续优化。这个MCP服务器将AI的力量带到了您的指尖，让您能够：
- 自动化活动管理：使用自然语言命令创建、更新和优化活动
- 实时性能分析：即时了解ROI、点击率、转化率等指标
- 智能优化：AI驱动的出价调整、创意轮换和目标细化
- 高效扩展：自动识别并利用成功的活动
- 节省时间：专注于策略，让AI处理重复性任务
适合以下人群：
- 📊 媒体买家和绩效营销人员
- 🎰 网络博彩附属机构
- 📱 应用开发者和发布者
- 🚀 成长黑客和数字代理公司
- 💼 运行PropellerAds活动的任何人
🚀 快速开始
先决条件
-
PropellerAds账户：您需要一个具有API访问权限的活跃账户
-
Claude桌面应用：安装Claude桌面应用
-
Python 3.8+：用于MCP服务器
安装
- 克隆仓库：
git clone https://github.com/jannafta/propellerads-mcp.git
cd propellerads-mcp
- 安装依赖项：
pip install -e .
- 设置您的API令牌：
cp .env.example .env
# 编辑.env文件并添加您的PropellerAds API令牌
- 配置Claude桌面应用：
在您的Claude桌面配置文件中添加：
- 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桌面应用，现在您可以开始了！
💬 示例问题及命令
向您的AI助手提出自然问题，获取即时洞察。这里有一些示例帮助您入门：
📈 活动表现及分析
“我的当前账户余额是多少？有多少活动正在运行？”
快速概览您的账户状态和正在进行的活动。
“显示过去7天内所有活动的表现”
查看包括花费、转化率、ROI和CTR在内的综合指标。
“本周哪个活动给我带来了最好的ROI？”
识别顶级表现者以集中精力和预算。
“比较本周和上周的活动表现”
了解趋势并尽早发现机会或问题。
“我所有的游戏活动的平均CPA是多少？”
获取特定活动类别的聚合指标。
🎯 活动管理和优化
“创建一个针对巴西的赌场优惠推送通知活动，每日预算为100美元”
使用一条命令设置新的活动及其所有必要参数。
“暂停今天花费超过50美元且没有转化的所有活动”
快速停止非盈利活动的资金流失。
“将活动12345复制到墨西哥、哥伦比亚和阿根廷，并提高20%的出价”
高效地将成功的活动扩展到新市场。
“将ROI超过100%的活动预算增加到每天500美元”
自动扩展盈利活动。
“查找接近每日预算上限的活动”
主动管理预算上限以避免流量中断。
🔍 深度分析及洞察
“显示我约会活动表现最佳的前10个区域”
识别高价值位置进行白名单设置。
“对于活动12345，一天中的哪些时段产生最多的转化？”
发现最佳时段投放机会。
“过去30天内，我的推送活动的CTR趋势如何？”
发现创意疲劳或市场变化。
“找出昨天生成FTD（首次存款）的所有区域”
识别可扩展的优质库存。
“哪些国家对我的应用安装活动具有最低的CPA？”
寻找新的地理扩张机会。
🚀 智能优化策略
“自动优化所有活动以实现最大ROI”
让AI调整出价、暂停表现不佳的活动并重新分配预算。
“查找没有转化但花费资金的区域，并将其加入黑名单”
自动清理活动目标。
“根据ROI表现将我的1000美元每日预算分配给各活动”
优化预算分配以获得最大回报。
“建议调整出价以使活动12345达到15美元的CPA”
获取基于AI的出价建议。
“根据当前表现，哪些活动准备好扩展？”
系统地识别增长机会。
🎨 创意管理和测试
“显示所有CTR低于0.5%且展示次数超过10,000次的创意”
识别表现不佳的创意进行替换。
“为活动12345轮换创意，仅保留CTR最高的前三名”
自动优化创意表现。
“我的游戏活动按创意的表现分解是什么样的？”
了解哪些信息与受众共鸣。
“暂停所有连续三天未产生转化的创意”
仅保留盈利的创意处于活跃状态。
🎲 针对iGaming的高级策略
“显示在二级地理区域中具有正ROI的赌场优惠活动”
在竞争较少的市场中找到隐藏的宝石。
“过去7天内，我的每个流量来源的FTD率是多少？”
分析超出基本转化的质量指标。
“查找所有针对Android 10+设备的移动用户的活动”
根据技术规格细分表现。
“对于赌场活动，哪些推送通知标题具有最高的CTR？”
根据数据优化文案。
📊 报告和监控
“为所有活动生成每日表现报告”
获取全面总结以供利益相关者更新。
“当任何活动的CTR下降超过30%时提醒我”
设置主动监控规则。
“本月每种广告格式的总支出和ROI是多少？”
了解渠道表现。
“显示过去一个月按周日表现的趋势”
识别模式以更好地安排活动。
🛠️ 可用工具
活动工具
list_campaigns- 查看所有活动及其过滤器get_campaign_details- 获取完整的活动信息create_campaign- 创建新的广告活动update_campaign- 修改活动设置start_campaigns- 启动活动stop_campaigns- 暂停活动clone_campaign- 复制成功的活动
统计工具
get_performance_report- 详细的性能指标get_campaign_performance- 包含见解的活动摘要compare_periods- 时期对比分析get_zone_performance- 放置级别的分析get_creative_performance- 创意表现分解
优化工具
auto_optimize_campaign- 基于AI的活动优化optimize_bids_by_performance- 智能出价调整find_scaling_opportunities- 识别增长潜力distribute_budget_by_performance- 基于ROI的预算分配
创意工具
create_push_creative- 设计推送通知rotate_creatives- 基于表现的轮换create_creative_variations- A/B测试设置
目标工具
manage_zone_targeting- 白名单/黑名单管理set_geo_targeting- 地理定位set_device_targeting- 设备和操作系统定位set_dayparting- 时间定位
🔒 安全与权限
- API令牌：安全存储在环境变量中
- 读操作：无需确认执行
- 写操作：需要明确的用户确认
- 速率限制：遵守PropellerAds API限制
📊 使用案例
日常优化例行程序
1. “显示所有活动昨日的表现”
2. “自动优化至少有10次转化的所有活动”
3. “查找并黑名单表现不佳的区域”
4. “基于CTR表现轮换创意”
5. “根据ROI调整预算”
活动扩展
1. “查找ROI > 100%且至少有50次转化的活动”
2. “将顶级表现者复制到相似的地理区域”
3. “将正ROI的活动预算增加50%”
4. “使用获胜创意创建类似的活动”
故障排除
1. “为什么活动12345停止获取流量？”
2. “显示CTR突然下降的区域”
3. “比较今天的性能与上周同一天”
4. “查找接近预算上限的活动”
🤝 贡献
我们欢迎贡献！请参阅我们的贡献指南以获取详情。
📄 许可证
本项目采用MIT许可证 - 详情见LICENSE文件。
🙏 致谢
- PropellerAds为其强大的广告平台
- Anthropic为MCP协议和Claude
- 程序化广告社区
📞 支持
- 问题：GitHub Issues
- 作者：@jannafta
🏷️ 关键词
propellerads mcp programmatic dsp ssp adtech adops performance-marketing igaming media-buying rtb cpm cpc cpa push-notifications popunder interstitial ai-automation claude claude code MCP anthropic propeller
为程序化广告社区制作 ❤️