광고 플랫폼 API, MCP 서버, AI 에이전트, 크로스 플랫폼 자동화를 위한 오픈소스 원스톱 허브입니다. 14개 플랫폼. 25개 이상의 전문 에이전트. 프로덕션 도구. 실제 광고비를 운용하는 실무자가 만들었습니다.
English | Français | Español | 中文 | Nederlands | Русский | 한국어
연결된 프로젝트: itallstartedwithaidea.com · googleadsagent.ai
키워드: Google Ads API, Meta Ads API, Microsoft Ads, Amazon Ads, LinkedIn Ads, MCP 서버, Model Context Protocol, AI 광고 에이전트, PPC 자동화, 캠페인 관리, GAQL, 디지털 마케팅 AI, 프로그래매틱 광고, 소재 검증, 크로스 플랫폼 리포팅, 유료 미디어 도구, 퍼포먼스 마케팅, Google Ads scripts, Gemini CLI, Claude Code
각 광고 플랫폼마다 저장소가 흩어져 있습니다. 여섯 가지 언어의 SDK, 더 이상 쓰이지 않는 라이브러리, 미디어 바이어가 쓰지 않을 모바일 예제까지요. 이것들을 한데 엮은 곳은 없었습니다.
The Advertising Hub는 단일 플랫폼 저장소가 하지 않는 세 가지를 합니다.
- 큐레이션 — 14개 플랫폼에서 광고에 필요한 저장소만 선별합니다(모바일 SDK 제외, 폐기된 SOAP 라이브러리 제외, 실무에 필요한 것만).
- 연결 — 공유 코어 패키지, 전문 AI 에이전트, MCP 서버로 AI 도구에 실시간 API 접근을 제공합니다.
- 문서화 — 15년 이상의 엔터프라이즈 광고비 운영에서 나온 크로스 플랫폼 패턴, 주의사항, 전략을 정리합니다.
| 당신은 | 원하는 것 | 시작하기 |
|---|---|---|
| 🎯 광고주 / 미디어 바이어 | 캠페인 관리를 돕는 AI 에이전트 | Agent Guide → Paid Media Division |
| 💻 개발자 | 광고 플랫폼 API 위에 구축 | Platform Index → 플랫폼 선택 |
| 🔧 툴 제작자 | 광고 플랫폼용 MCP 서버 구축 | MCP Development Guide → Templates |
| 🤖 AI / 에이전트 제작자 | AI 워크플로에 광고 통합 | MCP Registry → Core Package |
| 플랫폼 | 카테고리 | MCP 서버 | 에이전트 | API 문서 |
|---|---|---|---|---|
| Google Ads | Search / PMax / Shopping | ✅ Live | 4 | developers.google.com |
| Meta Ads | Social / Instagram | 📋 Spec Ready | 2 | developers.facebook.com |
| Microsoft Ads | Search / Audience | 📋 Spec Ready | 1 | learn.microsoft.com |
| Amazon Ads | Sponsored / DSP | 📋 Spec Ready | 1 | advertising.amazon.com |
| LinkedIn Ads | B2B Social / ABM | 📋 Spec Ready | 1 | learn.microsoft.com |
| Pinterest Ads | Visual Commerce | 📋 Planned | 1 | developers.pinterest.com |
| Reddit Ads | Community / Interest | 📋 Planned | 1 | ads-api.reddit.com |
| Spotify Ads | Audio / Podcast | 📋 Planned | 1 | ads.spotify.com |
| The Trade Desk | Programmatic DSP | 📋 Spec Ready | 1 | api.thetradedesk.com |
| Demandbase | ABM / Intent | 📋 Planned | 1 | demandbase.com |
| Criteo | Commerce / Retargeting | 📋 Planned | 1 | developers.criteo.com |
| AdRoll | SMB Retargeting | 📋 Planned | 1 | help.adroll.com |
| Quora Ads | Intent / Q&A | 📋 Planned | 1 | quoraadsupport.zendesk.com |
범례: ✅ Live = 프로덕션 MCP 서버 사용 가능 · 📋 Spec Ready = 아키텍처 문서화 완료, 구축 준비됨 · 📋 Planned = 플랫폼 모듈과 패턴 존재
The Agency Enhanced에서 — googleadsagent.ai의 프로덕션 도구를 갖춘 에이전트 7개:
| 에이전트 | 전문 분야 | 플랫폼 |
|---|---|---|
| 💰 PPC Campaign Strategist | 계정 구조, 입찰, 예산 배분 | Google, Microsoft, Amazon |
| 🔍 Search Query Analyst | 검색어 분석, 제외 키워드, 의도 매핑 | Google, Microsoft |
| 📋 Paid Media Auditor | 200개 이상 점검 항목의 계정 감사, 경쟁 분석 | 전 플랫폼 |
| 📡 Tracking Specialist | GTM, GA4, CAPI, 전환 추적 | 크로스 플랫폼 |
| ✍️ Creative Strategist | RSA 카피, Meta 크리에이티브, PMax 에셋 | Google, Meta |
| 📺 Programmatic Buyer | GDN, DSP, 파트너 미디어, ABM 디스플레이 | TTD, DV360, Demandbase |
| 📱 Paid Social Strategist | 여러 플랫폼의 풀퍼널 소셜 | Meta, LinkedIn, TikTok, Pinterest |
| 에이전트 | 플랫폼 | 전문 분야 |
|---|---|---|
| 🛒 Amazon Ads Specialist | Amazon | Sponsored Products/Brands/Display, DSP |
| 💼 LinkedIn B2B Strategist | ABM, 리드 생성, 매칭 오디언스 | |
| 📌 Pinterest Visual Commerce | Shopping, 시각 검색, 카탈로그 광고 | |
| 🎯 Reddit Ads Specialist | 서브레딧 타겟팅, 대화형 노출 | |
| 🎵 Spotify Audio Specialist | Spotify | 오디오 광고, 팟캐스트 타겟팅 |
| 📺 TTD Programmatic Buyer | The Trade Desk | Open internet DSP, UID2, Kokai |
| 🏢 Demandbase ABM Strategist | Demandbase | Account-based marketing, 인텐트 시그널 |
| 🔄 Criteo Retargeting Specialist | Criteo | 커머스 미디어, 다이내믹 리타겟팅 |
| 🔎 Microsoft PPC Specialist | Microsoft | Bing, audience network, Google에서 가져오기 |
| 에이전트 | 하는 일 |
|---|---|
| 💸 Budget Allocator | 크로스 플랫폼 예산 최적화 및 재배분 |
| 📊 Attribution Analyst | 플랫폼 간 멀티터치 기여 분석 |
| 👥 Audience Architect | 퍼스트파티 데이터를 어디서나 활성화 |
| 🕵️ Competitive Intel | 크로스 플랫폼 경쟁 모니터링 |
| 📈 Reporting Unifier | 통합 크로스 플랫폼 리포팅 |
| 에이전트 | 역할 |
|---|---|
| 🤖 Buddy | 질문을 적절한 에이전트로 라우팅하고 멀티 플랫폼 워크플로를 조율 |
MCP(Model Context Protocol) 서버는 Claude, Cursor, Gemini 같은 AI 도구에 광고 플랫폼 API에 대한 직접 접근을 제공합니다.
| 플랫폼 | 상태 | 저장소 |
|---|---|---|
| Google Ads | ✅ Live | google-ads-mcp |
| Meta Ads | 📋 Spec Ready | Build guide |
| Microsoft Ads | 📋 Spec Ready | Build guide |
| Amazon Ads | 📋 Spec Ready | Build guide |
| LinkedIn Ads | 📋 Spec Ready | Build guide |
| 기타 전부 | 📋 Planned | MCP Development Guide |
MCP 서버를 만들고 싶으신가요? templates와 개발 가이드부터 시작하세요.
core/ 패키지는 14개 플랫폼 모두에서 쓰는 공유 유틸리티를 제공합니다.
core/auth/— 플랫폼별 통합 OAuth2 / API 키 패턴core/models/— 캠페인, 광고 그룹, 광고, 오디언스, 지표의 정규화 모델core/rate_limiting/— 플랫폼별 적응형 속도 제한core/errors/— 플랫폼 오류를 공통 유형으로 매핑하는 통합 오류 분류core/utils/— 통화, 날짜 범위, 페이지네이션, 응답 정규화
이 생태계에서 만들어 배포된 도구입니다.
| 도구 | 하는 일 | 상태 |
|---|---|---|
| google-ads-mcp | Google Ads API 접근용 MCP 서버 | ✅ Live |
| google-ads-api-agent | Claude에서 엔터프라이즈 Google Ads 관리 | ✅ Live |
| google-ads-gemini-extension | Google Ads용 Gemini CLI 확장 | ✅ Live |
| gemini-cli-googleadsagent | Google Ads 명령과 에이전트 스킬이 있는 Gemini CLI 포크 | ✅ Live |
| creative-asset-validator | 멀티 플랫폼 크리에이티브 검증 | ✅ Live |
| googleadsagent.ai | 프로덕션 멀티 에이전트 시스템(Simba, Nemo, Elsa, Baymax, Buddy) | ✅ Live |
# 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.shfrom 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"
)wiki는 지식 베이스입니다. 각 플랫폼, 패턴, 도구에 대한 실무자 문서입니다.
- Platform Guides — 각 플랫폼 API, 인증, 주의사항 심층 설명
- Cross-Platform Patterns — 인증, 추적, 오디언스, 리포팅 비교
- MCP Development Guide — 광고 플랫폼용 MCP 서버 구축 방법
- Agent Guide — 에이전트 사용, 커스터마이즈, 제작 방법
- Use Cases — 단계별 플레이북이 있는 실제 시나리오
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
기여를 환영합니다. 가장 큰 영향을 줄 수 있는 방법:
- 아직 MCP가 없는 플랫폼용 서버 구축 — templates부터 시작
- 플랫폼 전문 에이전트 추가 — 에이전트 템플릿 따르기
- 패턴 문서 작성 — 플랫폼 API 함정에 대한 지식 공유
- 크로스 플랫폼 가이드 개선 — 플랫폼 간 연결을 돕기
자세한 내용은 CONTRIBUTING.md를 참고하세요.
MIT 라이선스 — 상업적·개인적 사용 모두 자유롭습니다.
제작: John Williams — Seer Interactive의 Senior Paid Media Specialist로 Google, Meta, Microsoft, Amazon에서 15년 이상 엔터프라이즈 광고비를 운용했습니다. googleadsagent.ai 제작자. 광고 분야 AI 적용에 대해 Hero Conf에서 발표했습니다.
에이전트 기반: Michael Sitarzewski의 The Agency — MIT 라이선스.
🎯 The Advertising Hub: One Place for Every Platform 🎯