sensor-tower-fetch-byoklisted

# Sensor Tower API 一键取数（BYOK 自带 Key 版） BYOK 版：**不内置任何 token**，每位使用者用自己的 Sensor Tower API key。给「产品 + 日期区间」即可拉**下载量 + 收入**（可选 DAU）， 自动套可选口径（net=ST原始净收入不÷0.7 / gross=÷0.7还原；CN上修默认关；重算 RPD/ARPDAU），出 3-sheet Excel。不用手动导出 CSV。口径见 数据口径说明.md。 ## 首次使用：配置你自己的 API Key（必做一次） 被触发后，**先确认 key 是否已配置**：跑一次 `--resolve-only`（见 Step 2），若脚本报 「未找到 Sensor Tower API token」，按下面任一方式配好再继续。三选一： 1. **环境变量（推荐，最不易误提交）** ```bash export ST_AUTH_TOKEN=<你的token> ``` 2. **本地配置文件**（已 gitignore，不会被提交）：把 `config.local.example.json` 复制成 `config.local.json` 填入 key ```bash cp .claude/skills/sensor-tower-fetch-byok/config.local.example.json \ .claude/skills/sensor-tower-fetch-byok/config.local.json # 然后编辑 config.local.json 的 "auth_token" ``` 3. **直接改 `config.json` 的 `auth_token`** —— ⚠️ 该文件会被提交，**别把私钥推到公共仓库**，仅自用私库可。 取 token 优先级：环境变量 `ST_AUTH_TOKEN` > `config.local.json` > `config.json`。 > **去哪拿 key**：登录 Sensor Tower 账号 → 后台 API / Integrations 设置里生成 API token（需对应数据订阅权限）。 > 没有 ST 账号/订阅则无法使用本 skill（这是 Sensor Tower 的付费数据，BYOK 仅解决「用谁的 key」，不绕过订阅）。 ## 安装与可用范围（云端 / 本地 / 全局） skill 非云端专属，本地 CLI 一样能跑。两种安装范围： | 范围 | 放哪 | 效果 | |---|---|---| | **仓库级** | 仓库内 `.claude/skills/sensor-tower-fetch-byok/` | 在该仓库目录开 Claude Code 即可用 | | **用户级 / 全局** | 本地 `~/.claude/skills/sensor-tower-fetch-byok/` | 本地任意项目都能调 | 全局安装：`cp -r .claude/skills/sensor-tower-fetch-byok ~/.claude/skills/`（注意：**不要**把你的 `config.local.json` 一起拷到会被提交的地方）。 本地运行需 `pip install pandas numpy openpyxl requests` + 能联网到 `api.sensortower.c