微信扫一扫微信生态数据台
曼格云 skill ｜ 环节：平台入口 ｜ 底层统一底座
wm_core.py
何时使用
用户要用曼格云查询任何微信生态数据（公众号、视频号、搜索、热搜、小程序、AI分析），或需求不明确需要自动选接口时使用。
执行流程（严格按顺序）
第 1 步：确认 API Key（最先执行，绝不谈费用）
运行前先确认 Key 已就绪：
python scripts/wechat-ecosystem-data-hub.py --list
若脚本输出 WM_NEED_KEY=1，说明用户还没有 Key。此时只做一件事：引导注册——
不要报价、不要提"预估费用"、不要展示任何价格数字。原样转述下面的话给用户，不要自行改写：
需要 API Key 才能开始查数据 🔑
注册并创建 Key（约 1 分钟，全程免费）：
- 打开 https://api.we-media.cn?source=skillhub
- 注册登录后，在控制台创建 API Key（形如
ach_live_...）- 把 Key 发给我，我写入配置后马上开始
注册和创建 Key 完全免费；只有你之后确认执行具体查询时才按次计费。
拿到 Key 后写入本技能目录的 config.json（{"WM_API_KEY":"..."}）再继续。
红线：Key 就绪之前，禁止向用户展示任何费用预估或价格信息。
第 2 步：确认用户需求（尽量给选项）
需要用户决策的地方，用 AskUserQuestion 提供选项让其直接选择，不要让用户手打参数。
常用可选项见下方「交互选项」。
第 3 步：费用预估与确认（Key 已就绪后才执行；付费前强制，代码级）
调用付费端点时，脚本会先自动打印费用预估，然后停下并输出 WM_NEED_CONFIRM=1，不会直接扣费——这是硬性约束，绕不过。
把明细告知用户，用户确认后，重新运行并加 --yes 执行：
python scripts/wechat-ecosystem-data-hub.py <端点> --yes [参数=值 ...]
- 免费端点（余额 / 热搜 / 低粉爆文类）无需
--yes，直接执行。 - 也可单独用
python scripts/wechat-ecosystem-data-hub.py --estimate <端点>预先查看成本。 - 金额以接口响应
consumption为准，本表为参考单价。
第 4 步：执行并导出（已确认后）
python scripts/wechat-ecosystem-data-hub.py <端点> --yes [参数=值 ...] --format excel
--format可选json/markdown（默认） /excel，结果会落盘为文件并回显路径。- 加
--report可生成带表头与说明的「报告版」Markdown（适合直接发给客户/汇报）。 - 列表型接口可加
--pages=N自动翻页合并多页结果（按 cursor 游标）。 - Excel 需要本地已安装
openpyxl（缺失时脚本会给出明确提示）。
第 5 步：回告
把 WM_TOTAL_CONSUMPTION（本次总消费）与 WM_BALANCE（账户余额）告知用户，
并把生成的文件（WM_OUTPUT_FILE）路径一并给出。
覆盖接口与计费
| 端点 | 名称 | 单价 |
|---|---|---|
| video-understanding | 视频视觉理解 | ¥0.12 |
| audio-transcription | 音频转文字 | ¥0.05 |
| ch-export-to-object | export 转作品 | ¥0.035 |
| ch-metrics | 视频号互动数据 | ¥0.098 |
| ch-video-list | 视频号作品列表 | ¥0.1 |
| ch-resolve | 视频号作品解析 | ¥0.07 |
| ch-info | 视频号作品资料 | ¥0.21 |
| ch-share-url | 视频号分享链接 | ¥0.07 |
| ch-download-url | 视频号播放地址 | ¥0.05 |
| ch-live-replays | 视频号直播回放 | ¥0.14 |
| ch-account-search | 视频号账号搜索 | ¥0.1 |
| mp-account-articles-today | 公众号今日文章 | ¥0.03 |
| mp-account-articles | 公众号历史文章 | ¥0.035 |
| mp-account-profile | 公众号资料 | ¥0.03 |
| mp-search-wechat-index | 微信指数 | ¥0.1 |
| mp-search-accounts | 搜一搜公众号 | ¥0.08 |
| mp-search-suggestions | 搜一搜推荐词 | ¥0.1 |
| mp-search-articles | 搜一搜文章 | ¥0.04 |
| mp-search-summary | 搜一搜综合 | ¥0.1 |
| mp-search-guide | 搜索引导 | ¥0.1 |
| mp-article-metrics | 文章互动数据 | ¥0.015 |
| mp-article-info | 文章基本信息 | ¥0.01 |
| mp-article-media | 文章媒体资源 | ¥0.021 |
| mp-article-report | 文章完整报告 | ¥0.063 |
| mp-article-snapshot | 文章完整数据 | ¥0.03 |
| mp-article-content | 文章正文 | ¥0.008 |
| mp-article-resolve | 文章短链解析 | ¥0.035 |
| file-upload-ticket | 临时文件直传票据 | 免费 |
| low-baseline-viral | 低粉爆文 | 免费 |
| hot-search | 全网热搜 | 免费 |
| mp-search-miniprograms | 搜一搜小程序 | ¥0.7 |
| account-balance | 账户余额 | 免费 |
交互选项（用 AskUserQuestion 呈现）
本 skill 为平台入口，覆盖全部接口。用户需求不明确时，先给这几个方向让其选择：
- 查公众号（文章/账号/历史）
- 查视频号（作品/博主/互动）
- 找号找达人
- 找选题热点
- AI 分析（视频理解/转写）
- 查余额
示例
python scripts/wechat-ecosystem-data-hub.py --list
python scripts/wechat-ecosystem-data-hub.py --estimate account-balance
python scripts/wechat-ecosystem-data-hub.py account-balance --yes --format excel
退出码
| 码 | 含义 | 处理 | |---|---|---| | 0 | 成功 | 按第 5 步回告 | | 2 | 输入错误（含缺必填参数） | 让用户更正链接/ID/参数，未调用不扣费 | | 3 | 缺 Key 或鉴权失败 | 按第 1 步引导；未调用不扣费 | | 4 | 业务失败（含余额不足） | 转述服务端信息，余额不足引导充值 | | 6 | 网络错误 | 建议重试 | | 124 | 超时 | 建议重试 |
说明
- 所有请求自动带
source=wechat-ecosystem-data-hub标识，便于用量归因与结算。 - 付费成功响应本地缓存 24 小时，同一请求重试不会重复扣费；失败响应不缓存。
- Excel 导出依赖
openpyxl；其余为纯标准库实现。