用途:按关键词拉取一批小红书爆款数据,从真实跑量笔记中提炼封面套路、确定封面选题方向,适用于需要小红书封面参考、首图灵感或爆款封面选题的场景。
主要能力:通过 doubaoya.com 接口获取四类榜单数据(低粉爆款、点赞 TOP500、单日互动、七日增长),返回 data.items,每项含 rank 与 item(如 item.title、item.likedCount),可据此归纳封面规律并给出可套用的封面方向。
使用方式:先到 doubaoya.com 登录并在密钥中心生成密钥(形如 dyh_…),设置环境变量 export DOUBAOYA_API_KEY="dyh_你的密钥"。脚本零依赖,使用 Python 3 标准库,运行:python3 "$SKILL_PATH/scripts/fetch_cover_data.py" --keyword 露营。--keyword 为必填;--start-date 日常不要传,因为该爆款榜按批次归档,传近期起始日期会把四张榜过滤成空,不传才回落到最新一批满榜数据。脚本将成功信封中的 data 以 JSON 输出到 stdout,每次只跑一次并读完整 stdout。
接口契约:POST https://doubaoya.com/api/apis/xiaohongshu/xiaohongshu-coze/call,鉴权头 Authorization: Bearer $DOUBAOYA_API_KEY,请求体 {"keyword": "露营"}。返回信封含 success、requestId、data、error,先判断 success 为 true 再读 data。
限制与错误:密钥绝不打印、不写入文件、不回显;请求只发往 doubaoya.com。错误码包括 401(密钥缺失或无效)、400(参数不合法)、402(额度不足)、422(查不到数据,可换关键词)、502(上游临时故障,已自动退款,可安全重试)。若暂时取不到数据,多为上游波动,稍后再试且不扣费。若返回顶层 notice 字段,应原样转达给用户。字段缺失时建议防御式读取并留空。