ads-cli（ADS CLI 搜索）

Ads CLI

Manage paid ads across Google/Meta/TikTok via one CLI and unified client.

Auth

Google Ads: file-based auth via ~/google-ads.yaml. No env vars for credentials.

Required env vars (set in ~/.secrets):

export GOOGLE_ADS_LOGIN_CUSTOMER_ID=6445466801   # Canonical MCC (phaedrus@mistystep.io)
export GOOGLE_ADS_CUSTOMER_ID=<sub_account_id>   # Set after account creation unblocked

Meta / TikTok (stubs — not yet implemented):

export META_APP_ID=...
export META_APP_SECRET=...
export TIKTOK_ACCESS_TOKEN=...

Quick Start

cd ~/.claude/skills/ads-cli

# Verify auth + list accessible customers
python cli.py auth --platform google

# Report (requires GOOGLE_ADS_CUSTOMER_ID)
python cli.py report --platforms google --date-range 7d --format table

# Create campaign (PAUSED, requires GOOGLE_ADS_CUSTOMER_ID)
python cli.py create-campaign --platform google --objective conversions --budget 35 --targeting "AI consulting"

# Adjust budget (+20%, absolute, or negative)
python cli.py adjust-budget --platform google --campaign-id <id> --amount "+20%"

# Pause campaign
python cli.py pause --platform google --campaign-id <id>

Account Context (Misty Step)

• Canonical MCC: 6445466801 (phaedrus@mistystep.io)
• Config: ~/google-ads.yaml
• Blocker: MCC has a policy flag blocking sub-account creation via API. Resolve at ads.google.com before creating campaigns.
• MCC 2673211237: Secondary, leave untouched.
• customers/8507948813: Defunct (permission denied), ignore.

First Campaign

When account is unblocked:

python cli.py create-campaign --platform google \
  --objective conversions --budget 35 \
  --targeting "GOOG_Search_AIConsulting_LeadGen_2026Q1"

Full campaign spec in ~/Development/misty-step/marketing/channels/google-ads/README.md.

Structure

• cli.py — Click commands
• src/google.py — Real Google Ads API v23 implementation
• src/meta.py, src/tiktok.py — Stubs
• src/unified.py — Routes by platform

Extend

Add new platform wrapper with auth, create_campaign, adjust_budget, get_report, pause_campaign. Register it in UnifiedAdsClient.

Strategy reference: ~/.claude/skills/paid-ads/SKILL.md