广告API集成平台

开源一站式广告平台API集成服务,支持14个广告平台的API、MCP服务器和AI代理,适用于广告商、开发者和AI工具构建者。

  • by itallstartedwithaidea
  • Markdown
  • 本地部署
  • 56 星标
  • 更新于
在 GitHub 查看 itallstartedwithaidea/advertising-hub

使用说明

🎯 广告中心

广告平台API、MCP服务器、AI代理和跨平台自动化的开源一站式商店。 14个平台。25+专业代理商。生产工具。由管理实际广告支出的从业者构建。

英语 | 法语 | 西班牙语 | 中文 | 荷兰语 | 俄语 | 韩语

已连接属性: 它始于aidea.com · googleadsagent.cn

关键词: Google Ads API,Meta Ads API,Microsoft Ads,Amazon Ads,LinkedIn Ads,MCP服务器,模型上下文协议,AI广告代理,PPC自动化,活动管理,GAQL,数字营销AI,程序广告,广告创意验证,跨平台报告,付费媒体工具,性能营销,Google Ads脚本,Gemini CLI,Claude Code


🚀 这是什么?

每个广告平台都有分散的存储库——6种语言的SDK、弃用的库、媒体买家永远不会接触的移动示例。 没有人把它们缝合在一起。

Advertising Hub做了三件单一平台仓库做不到的事情:

  1. 助理牧师 来自14个平台的与广告相关的仓库(经过筛选——没有移动SDK,没有弃用的SOAP库,只有从业者需要的)
  2. 连接 他们拥有共享的核心软件包、专门的人工智能代理和MCP服务器,为人工智能工具提供实时API访问
  3. 文件 15年多来管理企业广告支出的跨平台模式、陷阱和策略

这是给谁的

你是 你想要 从这里开始
🎯 广告商/媒体购买者 AI代理帮助管理活动 代理商指南 → 付费媒体部
💻 开发者 基于广告平台API构建 平台指数 → 选择您的平台
🔧 工具生成器 为广告平台构建MCP服务器 MCP开发指南 → 模板
🤖 AI/代理生成器 将广告整合到人工智能工作流程中 MCP注册表 → 核心包

📡 支持的平台

平台 类别 MCP服务器 代理 API文档
Google广告 搜索/PMax/购物 ✅ 活着 4 developers.google.com
元广告 社交/Instagram 📋 规格就绪 2 developers.facebook.com
微软广告 搜索/受众 📋 规格就绪 1 learn.microsoft.com
亚马逊广告 赞助商/DSP 📋 规格就绪 1 广告.amazon.com
LinkedIn广告 B2B社交/ABM📋 规格就绪 1 learn.microsoft.com
Pinterest广告 视觉商务 📋 计划 1 developers.pinterest.com
Reddit广告 社区/兴趣 📋 计划 1 ads-api.redit.com
Spotify广告 音频/播客 📋 计划 1 ads.spotify.com
交易台 程序化DSP 📋 规格就绪 1 api.tradedesk.com
需求基础 ABM/意图 📋 计划 1 网站 demandbase.com
科睿拓 商业/再营销 📋 计划 1 developers.criteo.com
AdRoll SMB重定向 📋 计划 1 help.adroll.com
Quora广告 意向/问答 📋 计划 1 quoraadsupport.zendesk.com

传说: ✅ 直播=生产MCP服务器可用·📋 规范就绪=架构已记录,准备构建·📋 计划=平台模块存在模式


🤖 代理人

付费媒体部门(经过实战测试)

自 该机构增强 --7名代理商提供生产工具 googleadsagent.cn:

代理 专业 平台
💰 PPC营销策略师 账户架构、竞价、预算分配 谷歌、微软、亚马逊
🔍 搜索查询分析师 搜索词挖掘、负面关键词、意图映射 谷歌、微软
📋 付费媒体审核员 200+点客户审计、竞争分析 所有平台
📡 跟踪专家 GTM、GA4、CAPI、转化跟踪 跨平台
✍️ 创意策略师 RSA复制、Meta创意、PMax资产 谷歌、Meta
📺 程序化买家 GDN、DSP、合作媒体、ABM显示器 TTD、DV360、Demandbase
📱 付费社会策略师 跨平台全渠道社交 Meta、LinkedIn、TikTok、Pinterest

平台专家(新)

代理 平台 专业
🛒 亚马逊广告专员 亚马逊 赞助产品/品牌/显示器,DSP
💼 LinkedIn B2B策略师 LinkedIn ABM,潜在客户,匹配的受众
📌 Pinterest视觉商务 Pinterest 购物、视觉搜索、目录广告
🎯 Reddit广告专家 Reddit 子版块定位、对话放置
🎵 Spotify音频专家 Spotify 音频广告、播客定向
📺 TTD程序化买家 交易台 开放式互联网DSP,UID2,Kokai
🏢 需求基地反导策略师 需求基础 基于客户的营销,意图信号
🔄 Criteo重定向专家 Criteo 商业媒体,动态重定向
🔎 微软PPC专家 微软 必应,受众网络,从谷歌导入

跨平台代理(新)

代理 它做什么
💸 预算分配器 跨平台预算优化与再分配
📊 归因分析师 跨平台多点触控归因
👥 观众架构师 无处不在的第一方数据激活
🕵️ 有竞争力的英特尔 跨平台竞争监控
📈 报告统一器 统一的跨平台报告

协调器

代理 角色
🤖 兄弟 将问题发送给合适的代理,协调多平台工作流程

🔌 MCP 服务器

MCP(模型上下文协议)服务器使Claude、Cursor和Gemini等人工智能工具可以直接访问广告平台API。

平台 状态 回购
谷歌广告 ✅ 活着 谷歌广告mcp
元广告 📋 规格就绪 构建指南
微软广告 📋 规格就绪 构建指南
亚马逊广告 📋 规格就绪 构建指南
LinkedIn广告📋 规格就绪 构建指南
所有其他 📋 计划中 MCP开发指南

想要构建MCP服务器吗? 从我们的开始 模板 和 开发指南.


🔧 核心包

这个 core/ 该软件包提供了跨所有14个平台工作的共享实用程序:

  • core/auth/ -针对每个平台的统一OAuth2/neneneba API密钥模式
  • core/models/ --标准化的活动、广告组、广告、受众和指标模型
  • core/rate_limiting/ --平台特定的自适应速率限制
  • core/errors/ --将平台错误映射到常见类型的统一错误分类
  • core/utils/ --货币处理、日期范围、分页、响应规范化

🛠️ 生产工具

从该生态系统构建和部署的工具:

工具 功能 状态
谷歌广告mcp 用于访问Google Ads API的MCP服务器 ✅ 现场直播
谷歌广告api代理 克劳德的企业谷歌广告管理✅ 现场直播
谷歌广告gemini扩展 Google Ads的Gemini CLI扩展✅ 现场直播
gemini-cli-googleadsagent Gemini CLI fork具有Google Ads命令和代理技能 ✅ 现场直播
创意资产验证器 多平台创意验证 ✅ 现场直播
googleadsagent.cn 生产多代理系统(Simba、Nemo、Elsa、Baymax、Buddy) ✅ 现场直播

⚡ 快速开始

使用代理(最快)

# Copy agents to your Claude Code directory
cp -r agents/ ~/.claude/agents/advertising-hub/

# Activate in Claude Code:
# "Use the PPC Campaign Strategist agent to audit this account"
# "Use the Budget Allocator agent to recommend cross-platform spend"

与其他工具一起使用

# Generate integration files for Cursor, Gemini CLI, Windsurf, etc.
./scripts/convert.sh

# Interactive install (auto-detects your tools)
./scripts/install.sh

构建核心包

from core.auth.google import GoogleAdsAuth
from core.auth.meta import MetaAdsAuth
from core.models.campaign import Campaign
from core.models.metrics import NormalizedMetrics

# Unified auth across platforms
google_auth = GoogleAdsAuth(client_id="...", client_secret="...", refresh_token="...")
meta_auth = MetaAdsAuth(access_token="...", app_id="...", app_secret="...")

# Normalized data models work with any platform
campaign = Campaign(
    platform="google-ads",
    name="Brand - US",
    budget_daily=500.00,
    status="active"
)

📖 维基

这个 维基 是知识库——每个平台、模式和工具的从业者编写的文档:


🗂️ 存储库结构

advertising-hub/
├── README.md                    # You are here
├── core/                        # 🔧 Shared utilities across all platforms
│   ├── auth/                    # Unified auth (OAuth2, API keys) per platform
│   ├── models/                  # Normalized campaign/ad/audience/metrics models
│   ├── rate_limiting/           # Adaptive rate limiting per platform
│   ├── errors/                  # Unified error taxonomy
│   └── utils/                   # Currency, dates, pagination, normalization
├── platforms/                   # 📡 Platform modules (14 platforms)
│   ├── google-ads/              # Agents, scripts, patterns, MCP, upstream refs
│   ├── meta-ads/
│   ├── microsoft-ads/
│   ├── amazon-ads/
│   ├── linkedin-ads/
│   ├── pinterest-ads/
│   ├── reddit-ads/
│   ├── spotify-ads/
│   ├── thetradedesk/
│   ├── demandbase/
│   ├── criteo/
│   ├── adroll/
│   └── quora-ads/
├── agents/                      # 🤖 AI agent specs (25+)
│   ├── paid-media/              # Battle-tested paid media agents
│   ├── cross-platform/          # Multi-platform coordination agents
│   ├── platform-specific/       # Platform-native specialists
│   └── orchestrator/            # Buddy + meta-agents
├── mcp-servers/                 # 🔌 MCP server registry + templates
├── wiki/                        # 📖 Complete documentation
├── integrations/                # 🔗 IDE integrations (Claude Code, Cursor, etc.)
├── scripts/                     # 🛠️ Build, install, lint scripts
├── .github/                     # CI/CD workflows
└── examples/                    # 📚 Real-world playbooks

🤝 贡献

我们欢迎捐款!最有效的帮助方式:

  1. 构建MCP服务器 对于一个还没有的平台——从 模板
  2. 添加平台专业代理 --跟随 代理模板
  3. 编写模式文档 -分享有关平台API gotchas的实用知识
  4. 改进跨平台指南 --帮助连接平台之间的点

看 贡献.md 了解全部细节。


📜 许可证

MIT许可证——自由、商业或个人使用。


🙏 鸣谢

建造于 约翰·威廉姆斯 --资深付费媒体专家 Seer互动 拥有15年以上管理谷歌、Meta、微软和亚马逊企业广告支出的经验。建设者 googleadsagent.cn.发言人在 英雄Conf 关于广告中的人工智能应用。

代理基金会: 机构 通过 Michael Sitarzewski --麻省理工学院许可。


🎯 广告中心:每个平台都有一个地方🎯

⭐ 标记此回购 · 🍴 分叉它 · 🐛 报告问题

它始于aidea.com · googleadsagent.cn