SuperAPI AI 工具集

xiaohongshu-weeklytop

通用与其它

查看项目

更新于 10-16 08:08

技能介绍

用途:按日期 + 分类获取小红书周榜,观察一周内持续走高的笔记,辅助判断中线趋势、识别稳定起势的选题方向,避免被单日热点干扰。触发场景包括小红书周榜、一周爆款、周度趋势、中线选题、周排行、持续走高。

主要能力:调用 doubaoya.com 接口返回榜单数据,返回信封中 data.items 每条含 title(标题)与 likedCount(点赞数),可按点赞数降序铺榜并补充趋势洞察。脚本零依赖,基于 Python 3 标准库(urllib)。

必要用法:先准备密钥——打开 doubaoya.com,登录后进入密钥中心生成形如 dyh_… 的密钥,并设置环境变量 export DOUBAOYA_API_KEY="dyh_你的密钥"。密钥不得打印、写入文件或回显给用户。默认运行:python3 "$SKILL_PATH/scripts/fetch_weekly_top.py";指定日期与分类:python3 "$SKILL_PATH/scripts/fetch_weekly_top.py" --rank-date "$(date -d '-3 days' +%F 2>/dev/null || date -v-3d +%F)" --category 化妆美容。接口为 POST https://doubaoya.com/api/apis/xiaohongshu/xiaohongshu-weekly-top/call,鉴权头 Authorization: Bearer $DOUBAOYA_API_KEY,请求体为 {"rankDate":"YYYY-MM-DD","category":"综合全部"}。

口径与限制:泛分类须写“综合全部”,不能写“综合”;分类为 25 个赛道闭集(综合全部、出行代步、休闲爱好、影视娱乐、数码科技、医疗保健、综合杂项、星座情感、时尚穿搭、婚庆婚礼、拍摄记录、学习教育、化妆美容、居家装修、旅行度假、亲子育儿、个人护理、美味佳肴、职业发展、宠物天地、潮流鞋包、日常生活、科学探索、新闻资讯、体育锻炼)。日期滞后约两天,仅保留最近 30 天,昨天与今天的榜单尚未结算。常见错误:401 密钥无效,400 参数不合法,402 额度不足,422 查无结果(多为分类名不在闭集或日期超范围),502 上游临时故障(已自动退款,可重试)。空结果不扣费。若响应顶层出现 notice 字段,应原样转达给用户。