微信生态数据台

曼格云(api.we-media.cn)全接口数据助手。一句话描述需求，自动选择并编排对应接口：公众号文章与账号、视频号作品与博主、搜一搜、微信指数、全网热搜、低粉爆文、小程序、视频视觉理解、音频转写。所有付费调用前先给费用预估。 适用场景：用户要用曼格云查询任何微信生态数据（公众号、视频号、搜索、热搜、小程序、AI分析），或需求不明确需要自动选接口时使用。

曼格云 skill ｜ 环节：平台入口 ｜ 底层统一底座 wm_core.py

何时使用

用户要用曼格云查询任何微信生态数据（公众号、视频号、搜索、热搜、小程序、AI分析），或需求不明确需要自动选接口时使用。

执行流程（严格按顺序）

第 1 步：确认 API Key（最先执行，绝不谈费用）

运行前先确认 Key 已就绪：

bash

python scripts/wechat-ecosystem-data-hub.py --list

若脚本输出 WM_NEED_KEY=1，说明用户还没有 Key。此时只做一件事：引导注册—— 不要报价、不要提"预估费用"、不要展示任何价格数字。原样转述下面的话给用户，不要自行改写：

需要 API Key 才能开始查数据 🔑

注册并创建 Key（约 1 分钟，全程免费）：

1. 打开 https://api.we-media.cn?source=clawhub
2. 注册登录后，在控制台创建 API Key（形如 ach_live_...）
3. 把 Key 发给我，我写入配置后马上开始

注册和创建 Key 完全免费；只有你之后确认执行具体查询时才按次计费。

拿到 Key 后写入本技能目录的 config.json（{"WM_API_KEY":"..."}）再继续。

红线：Key 就绪之前，禁止向用户展示任何费用预估或价格信息。

第 2 步：确认用户需求（尽量给选项）

需要用户决策的地方，用 AskUserQuestion 提供选项让其直接选择，不要让用户手打参数。 常用可选项见下方「交互选项」。

第 3 步：费用预估与确认（Key 已就绪后才执行；付费前强制，代码级）

调用付费端点时，脚本会先自动打印费用预估，然后停下并输出 WM_NEED_CONFIRM=1，不会直接扣费——这是硬性约束，绕不过。

把明细告知用户，用户确认后，重新运行并加 --yes 执行：

bash

python scripts/wechat-ecosystem-data-hub.py <端点> --yes [参数=值 ...]

• 免费端点（余额 / 热搜 / 低粉爆文类）无需 --yes，直接执行。
• 也可单独用 python scripts/wechat-ecosystem-data-hub.py --estimate <端点> 预先查看成本。
• 金额以接口响应 consumption 为准，本表为参考单价。

第 4 步：执行并导出（已确认后）

bash

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 分析（视频理解/转写）
• 查余额

示例

bash

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；其余为纯标准库实现。