MCP를 통해 AI 전원 광고 관리. 8 플랫폼에서 232 도구 - Google 광고, 메타 광고, GA4, 콘솔 검색, 태그 관리자, Matomo, Bing Webmaster 및 PageSpeed Insights.

오픈 소스. 1개의 서버. Claude, Cursor, Windsurf 및 MCP 클라이언트와 함께 작동합니다.

플랫폼

설치

빠른 시작

MCP 클라이언트 구성에 추가 (예: ~/.claude/mcp_servers.json]):

또는 직접 실행:

구성

모든 설정 파일은 에서 라이브 ~/.unified-ads-mcp/. 이 디렉토리를 먼저 만듭니다:

OAuth 토큰은 첫 번째 브라우저 기반 인증 후 자동으로 캐시됩니다.

구글 광고

~/.unified-ads-mcp/google-ads.yaml 만들기:

Aidvertaiser

AI-powered advertising management via MCP. 232 tools across 8 platforms — Google Ads, Meta Ads, GA4, Search Console, Tag Manager, Matomo, Bing Webmaster, and PageSpeed Insights.

Open source. One server. Works with Claude, Cursor, Windsurf, and any MCP client.

Platforms

Installation

# From source
git clone https://github.com/Draivix/aidvertaiser.git
cd aidvertaiser
uv sync

Quick Start

Add to your MCP client config (e.g. ~/.claude/mcp_servers.json):

{
  "aidvertaiser": {
    "command": "uv",
    "args": ["run", "--directory", "/path/to/aidvertaiser", "unified-ads-mcp"]
  }
}

Or run directly:

uv run unified-ads-mcp

Configuration

All config files live in ~/.unified-ads-mcp/. Create this directory first:

mkdir -p ~/.unified-ads-mcp

OAuth tokens are cached here automatically after first browser-based authentication.

Google Ads

Create ~/.unified-ads-mcp/google-ads.yaml:

developer_token: YOUR_DEVELOPER_TOKEN
client_id: YOUR_CLIENT_ID
client_secret: YOUR_CLIENT_SECRET
login_customer_id: YOUR_MCC_ID          # Optional, for MCC access
default_customer_id: YOUR_CUSTOMER_ID   # Optional, skip account listing

Env var override: GOOGLE_ADS_CREDENTIALS=/path/to/google-ads.yaml

Tip: Set ONLY_DEFAULT_ACCOUNT=1 to disable google_list_accounts and force using the default customer ID everywhere. Useful when you only manage one account.

Meta Ads

Create ~/.unified-ads-mcp/meta-ads.yaml:

app_id: YOUR_APP_ID
app_secret: YOUR_APP_SECRET
access_token: YOUR_TOKEN              # Optional, bypasses browser OAuth
default_account_id: act_XXXXXXXXXX    # Optional

Or set environment variables: META_APP_ID, META_APP_SECRET, META_ACCESS_TOKEN.

Env var override: META_ADS_CREDENTIALS=/path/to/meta-ads.yaml

Google Analytics (GA4)

Create ~/.unified-ads-mcp/google-analytics.yaml:

client_id: YOUR_CLIENT_ID
client_secret: YOUR_CLIENT_SECRET
default_property_id: YOUR_PROPERTY_ID   # Optional

Falls back to google-ads.yaml for client_id/client_secret (same Google Cloud project).

Env var override: GOOGLE_ANALYTICS_CREDENTIALS=/path/to/google-analytics.yaml

Google Search Console

Uses google-ads.yaml for client credentials (same Google Cloud project). No separate config needed.