alimama-cli

# alimama-cli — 万相台 AI 无界 数据查询 + 单元关停 CLI ## 一句话上手 ```bash ~/.claude/skills/alimama-cli/scripts/alimama.sh doctor # 验证 cookie ~/.claude/skills/alimama-cli/scripts/alimama.sh charge-summary # 看昨天广告花了多少 ``` ## 适用人群 阿里��妈广告主自己拉取自家店铺数据 + 关停广告。**查询类全只读**；**唯一的写操作是 `promo-off`（��宝贝ID关停在投单元），默认只列清单不执行，必须显式 `--execute` 才动**，且不调价/不删除/不新建。 ## 前置条件 - macOS（已测试），Linux/Windows 理论可用 - macOS Chrome **已登录** https://one.alimama.com；Windows 首次运行会自动打开专用浏览器，登录一次即可 - 已装 `uv`（推荐）或 `pip install -r requirements.txt` --- ## 重要：模块结构（**别再搞混 "报表" vs "推广"**） ``` 万相台 AI 无界 ├─ 📊 报表（看历史数据复盘） → report-* 子命令 + charge-summary └─ 🚀 推广（看当前在投的计划） → promo-* 子命令 ``` | 维度 | 📊 报表 | 🚀 推广 | |---|---|---| | 时间 | **历史区间** | **当前快照** | | 关心 | "昨天/上周花了多少、ROI 多少、谁转化好" | "现在哪些计划在跑、出价多少、日预算多少" | | 接口 | `/report/query.json`（带 startTime/endTime）| `/campaign/horizontal/findPage.json`（无日期） | | 用户问"昨天花了多少" | ✅ 用这个 | ❌ | | 用户问"现在在投哪些关键词" | ❌ | ✅ 用这个 | --- ## 全部子命令（23 个，含 1 个写操作） ### 🔧 工具/账户类（5 个） | 子命令 | 用途 | |---|---| | `doctor` | 检查 cookie / 登录态 | | `account-balance` | 账户余额（实时） | | `activity-list` | 营销活动列表 | | `campaign-list` | 推广计划清单（仅 ID + 名字，无业务数据） | | `api <path>` | 通用接口探测（debug 用，AI 代理一般不调） | ### 📊 报表类（11 个）—— 看历史数据 每个都接受：`--date YYYY-MM-DD --end-date YYYY-MM-DD --limit N --window 1|7|15 --raw --out file` | 子命�� | 对应万相台页面 | 干嘛用 | |---|---|---| | `charge-summary` | 营销场景报表 | **总览**：各推广场景（关键词推广/人群推广）各花了多少 | | `scene-summary` | 场景大盘(大屏) | **某场景大盘汇总**：展现量(adPv)/点击/花费/成交/ROI/加购/转化，默认过去7天，`--b...