SuperAPI AI 工具集

xiaohongshu-top-account

营销与增长

查看项目

更新于 10-16 08:41

技能介绍

用途:查询小红书头部账号榜单,支持日榜、周榜、月榜,可按赛道筛选,输出排名、博主、粉丝数、互动等字段,并附一句对标洞察。适用于头部账号对标、竞品跟踪、起号找标杆、达人初筛和赛道热度研究。

主要能力:通过脚本调用 doubaoya.com 接口获取榜单数据。三个参数:--period(day/week/month,默认 day)、--type(赛道,默认综合全部)、--rank-date(默认昨天)。赛道含综合全部、美味佳肴、化妆美容、时尚穿搭、旅行度假、亲子育儿、数码科技、居家装修、学习教育、宠物天地、体育锻炼等。

使用方式:先配置环境变量 export DOUBAOYA_API_KEY="dyh_你的口令",口令在 doubaoya.com 口令中心生成。调用示例:python3 "$SKILL_PATH/scripts/fetch_xhs_top_account.py" --period week --type 美味佳肴;查历史日期加 --rank-date 2026-06-01。脚本将 data 以 JSON 打到 stdout,每次查询只跑一次并读完整输出。随后从 data.items 取 rank、nickname、fansCount 等字段渲染表格,字段缺失留空或标暂无。

接口:POST https://doubaoya.com/api/apis/xiaohongshu/xiaohongshu-top-account/call,鉴权头 Authorization: Bearer $DOUBAOYA_API_KEY,请求体含 period、rankDate、type。返回信封先看 success,为 true 才读 data,否则读 error.code/message。

限制:口令不得打印、写入文件或回显,请求只发往 doubaoya.com。常见错误:401 口令缺失或无效,400 参数不合法,402 额度不足,502 上游故障(自动退款,可安全重试)。某赛道某天返回空可能是榜单未结算,可将日期前移一两天。