ads-cli

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Ads CLI

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

Env vars:

GOOGLE_ADS_DEVELOPER_TOKEN
GOOGLE_ADS_CLIENT_ID
META_APP_ID
META_APP_SECRET
TIKTOK_ACCESS_TOKEN

Quick start:

bash

python cli.py auth --platform google
python cli.py create-campaign --platform google --objective conversions --budget 50 --targeting "developers"
python cli.py adjust-budget --platform google --campaign-id abc123 --amount "+20%"
python cli.py report --platforms google,meta --date-range 7d --format table
python cli.py pause --platform google --campaign-id abc123

Strategy reference:

Read
```
/Users/phaedrus/.claude/skills/paid-ads/SKILL.md
```
for platform selection, structure, targeting, copy, and optimization.

Structure:

```
cli.py
```
defines Click commands.
```
src/google.py
```
,
```
src/meta.py
```
,
```
src/tiktok.py
```
are per-platform wrappers.
```
src/unified.py
```
routes by platform.

Extend:

Add new platform wrapper with

auth

create_campaign

adjust_budget

get_report

pause_campaign

通过一个CLI和统一客户端管理Google、Meta、TikTok平台的付费广告。

环境变量：

GOOGLE_ADS_DEVELOPER_TOKEN
GOOGLE_ADS_CLIENT_ID
META_APP_ID
META_APP_SECRET
TIKTOK_ACCESS_TOKEN

快速开始：

bash

python cli.py auth --platform google
python cli.py create-campaign --platform google --objective conversions --budget 50 --targeting "developers"
python cli.py adjust-budget --platform google --campaign-id abc123 --amount "+20%"
python cli.py report --platforms google,meta --date-range 7d --format table
python cli.py pause --platform google --campaign-id abc123

策略参考：

查看
```
/Users/phaedrus/.claude/skills/paid-ads/SKILL.md
```
获取平台选择、架构、定向、文案及优化相关内容。

架构说明：

```
cli.py
```
定义Click命令。
```
src/google.py
```
、
```
src/meta.py
```
、
```
src/tiktok.py
```
为各平台的封装器。
```
src/unified.py
```
负责按平台路由请求。

扩展方法：

新增包含

auth

、

create_campaign

、

adjust_budget

、

get_report

、

pause_campaign

方法的平台封装器。

在
```
UnifiedAdsClient
```
中注册该封装器。