alimama-cli

万相台 AI 无界（one.alimama.com / 阿里妈妈 onebp）数据查询 + 单元关停 CLI。

给 AI 代理一行命令拉取自家店铺的广告推广数据。查询类全只读；唯一写操作 promo-off（按宝贝ID关停在投单元）默认只列清单，必须 --execute 才执行，不调价/不删除/不新建。

💡 推荐：自己做了一个电商模特图生成站 paitumao.com，
用的是目前最强的模特图生成模型，image-2 定价 ¥0.5/张，专门服务预算有限的小商家。
有需要的话加我微信聊，备注一下来意。

数据结构：每个推广场景都是「大盘 → 计划 → 商品」三层

三个推广场景（人群 / 关键词 / 货品全站）结构完全一样，只是 bizCode 不同。纵向看是三层，每层对应一个命令：

万相台 · 推广
│
├─ 👥 人群推广 (onebpDisplay)
│   ├─ 📊 大盘汇总(大屏) ───────► scene-summary --biz crowd
│   │      展现量·点击·点击率·花费·成交·ROI·加购·转化   (默认过去7天)
│   ├─ 📋 计划层 (campaign) ────► promo-crowd        (+ --item 反查宝贝在哪些计划)
│   │      每条计划: 预算·出价·状态·计划名
│   │      └─ 🔹 商品/单元层 (adgroup) ──► promo-items --campaign <计划ID>
│   │             每个商品: 宝贝ID·标题·开关(onlineStatus)   promo-units [--item <宝贝ID> | --unit <单元ID>]
│   │             （一计划多商品；同商品又散在多条计划）
│   │             └─ ⚙️ 关停 ──► promo-off --item <宝贝ID> [--execute]   ← 唯一写操作
│   └─ 📈 历史报表(按维度复盘) ─► report-crowd / report-campaign / report-item ...
│
├─ 🔑 关键词推广 (onebpSearch) ── 同三层：scene-summary/promo-keyword/promo-units/report-keyword
├─ 🛒 货品全站推广 (onebpSite) ── 同三层（特点：一计划=一商品）
└─ （店铺直选 / 内容营销 / 活动专属：暂未支持）

大盘对应场景总账，计划管理预算出价，商品层管理开关，最底层为单个商品的关停操作。
三个场景的大盘数据之和等于全账户合计（已验证一致）。

📊 报表模块

接口 POST /report/query.json（一个接口，rptType 区分维度）。每个报表含展现量/花费/成交/ROI/点击/CTR等：

🔧 账户/工具

doctor(cookie自检) · account-balance(余额) · activity-list · campaign-list · api(通用探测)

"报表" 与 "推广" 的区别

典型使用场景：

1. 查看昨日报表，了解花费与 ROI
2. 查看当前推广列表，判断计划是否需要调整

装机

git clone [email protected]:rakei076/alimama-cli.git ~/.claude/skills/alimama-cli
# 装 uv（如未装）：
curl -LsSf https://astral.sh/uv/install.sh | sh
# 验证：
~/.claude/skills/alimama-cli/scripts/alimama.sh doctor

前置条件：本机 Chrome 已登录 one.alimama.com（CLI 自动复用浏览器 cookie，不需要重新登录）。

典型用法

1. 查看广告花费

~/.claude/skills/alimama-cli/scripts/alimama.sh charge-summary

输出：

# 万相台 推广花费汇总
# 区间: YYYY-MM-DD ~ YYYY-MM-DD
场景             花费(元)    占比
关键词推广     XX,XXX.XX  5X.X%
人群推广       XX,XXX.XX  4X.X%
总花费         XX,XXX.XX 100.0%

2. 查看各计划的投入产出比

~/.claude/skills/alimama-cli/scripts/alimama.sh report-campaign --limit 20

输出（按花费降序，含 ROI）：

#  名称                            花费    成交     ROI    点击    CTR
1  <计划 A 名字>              ¥XXX   ¥X,XXX  XX.XX   XXX   X.X%   🟢
2  <计划 B 名字>              ¥XXX   ¥X,XXX  XX.XX   XXX   X.X%   🟢
10 <计划 J 名字>              ¥XX    ¥0       0.00    XX   X.X%   🔴

3. 查看当前在投的关键词推广计划

~/.claude/skills/alimama-cli/scripts/alimama.sh promo-keyword --limit 10

输出：

[ 1] ⭐🟢 在投  campaignId=<示例 ID>
     计划名: <你的计划名>
     日预算: ¥XXX  出价: 平均点击成本X.XX元  类型: smart_bid
     投放时段: HH:MM-HH:MM    推广类型: item   创建: YYYY-MM-DD
...

4. 筛选高花费无转化的关键词

~/.claude/skills/alimama-cli/scripts/alimama.sh report-keyword --limit 50 --raw \
  | jq '[.data.list[] | select(.charge > 5 and .alipayInshopAmt == 0)]'

5. 查看货品全站推广在投商品

~/.claude/skills/alimama-cli/scripts/alimama.sh promo-wholesite --limit 20

全部子命令

通用参数：

• 报表类：--date YYYY-MM-DD --end-date YYYY-MM-DD --limit N --window 1|7|15 --raw --out file
• 推广类：--limit N --page N --status start pause --raw --out file；promo-units 支持 --item(宝贝ID) / --unit(单元ID)，promo-items 支持 --campaign（这些 ID 过滤都走服务端，不全量拉）
• scene-summary：--biz --date --end-date --no-realtime

安全护栏

硬约束（确认是风险信号才停）：

软建议（不停止，只 stderr 提示）：

风控按"短时高频"判定，不按"总量"，日常批量拉数据没问题。

读写边界：

• ✅ 查询全只读：findPage / findList / report / query / chargeSum / checkRealBalance
• ⚙️ 唯一写操作 promo-off：只调 /adgroup/updatePart.json 把单元设 pause（关）。默认 dry-run 只列清单；必须 --execute 才真发；执行前应把清单给用户确认。
• ❌ 不调价 / 不删除 / 不新建 / 不批量改预算出价

鉴权机制

• 不开新 Chrome，不用 CDP，不用 Playwright
• 用 browser_cookie3 从本机 Chrome SQLite 直读 alimama.com 域 cookie
• 用 curl_cffi 伪 TLS 指纹（impersonate=chrome120）
• 万相台需要 CSRF：CLI 启动时自动 POST /member/checkAccess.json 拿 csrfId 缓存
• 所有 POST 自动注入 ?bizCode=universalBP&csrfId=xxx

License

MIT — © 2026

联系作者

有想法、有需求，欢迎加微信找我，并注明来意。

• 微信：扫下方二维码加好友
• X / Twitter：@LuJia32473

如果这个工具帮到了你，欢迎给个 ⭐️。

Star History