用途:按账号名称对公众号做批量“体检”,返回账号画像、发文表现与健康度,可用于自号自查、竞品对照、批量选号初筛和定期复盘。
主要能力:一次可报多个账号并诊对照;核心字段包括 accountName、avgReadCount(平均阅读)、healthScore(健康度);缺字段标“暂无”,不估算、不打主观分。
使用方式:诊断读库中现有数据,默认直接诊断;带 --sync 会先为每个账号触发一次异步同步(以账号名作 accountId),打印受理回执含 status、retryAfterMinutes,再调诊断接口。同步异步落库需时间,想用新数据需等待后再不带 --sync 重跑。
命令示例: python3 "$SKILL_PATH/scripts/analyze_accounts.py" "账号A" "账号B" python3 "$SKILL_PATH/scripts/analyze_accounts.py" "账号A" "账号B" --sync
鉴权:环境变量 DOUBAOYA_API_KEY,形如 dyh_…,在 doubaoya.com 密钥中心生成。密钥不打印、不写文件、不回显。
接口:诊断 POST https://doubaoya.com/api/apis/gongzhonghao/gongzhonghao-account-analyzer/call,请求体 {"accountNames": ["账号A"]};同步 POST https://doubaoya.com/api/apis/gongzhonghao/gzh-sync-notes/call,请求体 {"accountId": "账号A"}。鉴权头 Authorization: Bearer $DOUBAOYA_API_KEY。返回信封含 success、requestId、data.items、error。先看 success。
限制:诊断依赖库中已有数据;同步为异步,不阻塞本次诊断。错误处理:401 密钥缺失或无效,400 参数不合法,402 额度不足,502 上游临时故障并自动退款,可安全重试。脚本失败时向 stderr 打印 [error] CODE: message 并以退出码 1 结束。若响应顶层出现 notice 字段,需原样转达用户,不影响本次调用。