SuperAPI AI 工具集

douyin-top-account

数据与分析

查看项目

更新于 10-16 08:41

技能介绍

用途:按日期查询抖音最具影响力账号排行,用于观察头部大号格局、高影响力账号集中的赛道以及当下流量风向,也可用于锁定同赛道头部账号做对标研究。

主要能力:支持榜单周期维度 --period(day 日榜 / week 周榜 / month 月榜,默认周榜)与行业分类 --category(默认「全部」),日期 --date 接受 YYYY-MM-DD,默认昨天。返回结果含 rank(名次)、accountName(账号名)、influenceScore(对外称「影响力指数」)等字段。

使用方式:先到 doubaoya.com 登录并在口令中心生成口令(形如 dyh_…),配置环境变量 export DOUBAOYA_API_KEY="dyh_你的口令"。随后运行脚本:python3 "$SKILL_PATH/scripts/fetch_top_account.py";指定维度与日期示例:python3 "$SKILL_PATH/scripts/fetch_top_account.py" --period month --date 2026-06-25 --category 全部。脚本将成功信封中的 data 以 JSON 输出到 stdout,建议完整读取 stdout,不用 head/tail 预览。拿到 data.items 后可渲染 Markdown 榜单表并补一句风向洞察。

接口:POST https://doubaoya.com/api/apis/douyin/douyin-top-account/call,鉴权头 Authorization: Bearer $DOUBAOYA_API_KEY,请求体为 period、rankDate、category。rankDate 需传真实且较近的日期,勿填未来日期;空结果通常表示该日期窗口暂无数据,可往前挪一天重试。

限制与错误:日志只发往 doubaoya.com;口令绝不打印、写入文件或回显。常见错误包括 401(口令缺失或无效)、400(参数不合法)、NO_DATA(该日无榜单)、402(额度不足)、502(上游临时故障,已自动退款,可安全重试)。脚本为 urllib 零依赖实现,失败时向 stderr 打印 [error] CODE: message 并以退出码 1 结束。