SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场xiaohongshu-hot-notes

xiaohongshu-hot-notes

营销与增长

查看项目

更新于 10-16 05:57

技能介绍

一句话定位

给本鸭一个话题 / 赛道关键词，本鸭就去小红书搜一圈笔记，按互动热度（点赞 + 评论）从高到低排出一张榜单，把最热门的爆款顶到最前面，最后送上一份选题 takeaways。适合内容创作者、品牌运营、MCN、增长团队，以及任何需要「快速摸清某个赛道当下什么内容在爆」的场景。

主要能力

  • 按关键词搜索小红书笔记，汇总多页结果。
  • 按互动量（likeCount + commentCount）降序排序，输出排好序的 JSON。
  • 以 Markdown 排行榜表格呈现结果（字段对应脚本返回的 title / likeCount / commentCount / authorName / publishTime）。
  • 基于榜单头部笔记提炼 2-4 条可复用的选题 / 标题 / 呈现形式规律。

工作流程

  1. 确定关键词：从需求中提炼一个赛道 / 话题关键词（如「减脂早餐」「早 C 晚 A」「露营装备」）。关键词越具体，榜单越精准；模糊时可主动收敛为更聚焦的词。
  2. 跑脚本搜索 + 排序：调用 scripts/fetch_hot_notes.py 并传入关键词。需要更大样本时加 --pages 2 或 --pages 3（默认 1 页，最多 3 页）。脚本翻页搜集笔记，按「点赞 + 评论」降序排好并输出 JSON。
  3. 呈现排行榜：把脚本输出渲染成排好序的 Markdown 表格，按热度从第 1 名往下排。
  4. 给选题 takeaways：基于榜单头部笔记，提炼选题方向、标题套路、呈现形式等规律。

排行榜列包括：排名、标题、点赞、评论、作者、发布时间；部分字段可能缺失，缺失的留「—」。

使用方式

配置密钥

本技能使用都爆鸭 API Key 调用接口。获取方式：打开 doubaoya.com，登录账号，进入密钥中心，点击生成密钥，复制出来（密钥形如 dyh_…）。

配置到环境变量 DOUBAOYA_API_KEY： macOS / Linux： echo 'export DOUBAOYA_API_KEY=<你的密钥>' >> ~/.zshrc source ~/.zshrc

Windows（PowerShell）： [Environment]::SetEnvironmentVariable("DOUBAOYA_API_KEY", "<你的密钥>", "User")

验证：echo $DOUBAOYA_API_KEY（macOS/Linux）或 echo %DOUBAOYA_API_KEY%（Windows），能打印出 dyh_… 开头的串即生效。改完环境变量需重开终端。

密钥安全：密钥是私密凭证，不应打印到对话、日志或截图里，也不要提交进公开仓库。脚本只从环境变量读取。

运行脚本

脚本零依赖（纯 Python 3 标准库），无需安装任何包。

默认搜 1 页，按互动量排序

python3 scripts/fetch_hot_notes.py "减脂早餐"

多翻几页拿更大样本（最多 3 页）

python3 scripts/fetch_hot_notes.py "通勤穿搭" --pages 3

脚本行为：从 DOUBAOYA_API_KEY 读密钥（未配置会报错并提示去获取）；逐页 POST https://doubaoya.com/api/apis/xiaohongshu/search-note/call，请求体 {"keyword": "...", "page": N}；汇总各页 data.items，按 likeCount + commentCount 降序排序；把排好序的笔记列表以 JSON 打印到标准输出。

接口与返回信封

接口：POST https://doubaoya.com/api/apis/xiaohongshu/search-note/call 鉴权头：Authorization: Bearer $DOUBAOYA_API_KEY 请求体（仅两个字段）： { "keyword": "减脂早餐", "page": 1 }

  • keyword（string，必填）：话题 / 赛道关键词
  • page（int，可选）：页码

返回信封示例： { "success": true, "requestId": "…", "data": { "items": [ { "title": "…", "authorName": "…", "likeCount": 1234, "commentCount": 56, "publishTime": "…" } ] }, "error": null } 先判 success：为 true 才读 data.items；笔记字段做防御式读取（可能缺 title / authorName / likeCount / commentCount / publishTime）。

错误处理

脚本已内置处理，遇到下列情况会把 [error] code: message 打到 stderr 并以退出码 1 结束：

  • 401 MISSING_API_KEY / UNAUTHORIZED：未配置密钥或密钥无效。到 doubaoya.com 密钥中心重新生成，重配 DOUBAOYA_API_KEY。
  • 400 VALIDATION_ERROR：请求参数不合法（如 keyword 为空）。换关键词重试。
  • 402 INSUFFICIENT_CREDITS：余额 / 积分不足。到 doubaoya.com 充值后再试。
  • 502 PROVIDER_FAILED：上游临时故障，已自动退款，可安全重试，稍后重跑即可。
  • 网络异常（连不上、超时）会报 NETWORK_ERROR，检查网络后重试。

响应中的 notice 字段：调用本 skill 对应接口后，如果返回的 JSON 顶层出现 notice 字段，需把这句话原样转达给用户——这是关于本 skill 有更新的提示，不影响本次调用结果，不需要重试或改变行为。

适用场景

  • 内容创作者找选题灵感、对标爆款。
  • 品牌运营 / MCN / 增长团队做赛道内容调研。
  • 需要「快速摸清某个赛道当下什么内容在爆」的场景。

限制与注意事项

  • 数据真实性：榜单只认脚本返回，不编造排名或互动数；表格里的标题、点赞、评论、作者只能来自脚本返回，脚本没返回的字段留空或写「—」。
  • 榜单口径：基于「关键词搜索 + 互动量排序」，反映该关键词下被搜到的高互动笔记，非平台官方实时热榜；关键词越精准越贴近需求。
  • 翻页克制：默认 1 页通常够用，最多 3 页。
  • 合规：跳转原文、二次使用须遵守小红书平台规则与版权要求。
  • 目录结构：xiaohongshu-hot-notes/ 含 SKILL.md（定位、工作流、密钥、接口与错误处理）与 scripts/fetch_hot_notes.py（搜索笔记 + 按互动量排序，输出排好序的 JSON）。

本工具的具体收费标准、价格与余额消耗规则暂未提供。