小红书数据助手 okdata

--- name: okdata-xiaohongshu description: 小红书数据助手：用 okdata 接口读小红书的公开数据，包括小红书笔记搜索、小红书笔记详情、小红书笔记评论、小红书博主信息、小红书博主笔记列表、小红书热点话题、小红书蒲公英达人搜索、小红书蒲公英达人详情等，不用登录、不用 Cookie，按次付费、失败不收费。适用于小红书数据分析、选题和爆款笔记调研、盯竞品账号和竞品笔记、看笔记评论区的口碑、提问和购买意向、找博主、筛达人，看粉丝和互动。 Xiaohongshu / XHS / RedNote public data for AI agents through the okdata API (remote MCP or HTTP), paid per call. license: MIT metadata: openclaw: primaryEnv: OKDATA_API_KEY requires: env: - OKDATA_API_KEY homepage: https://okdata.online/zh/apis/xiaohongshu/ --- <!-- Generated by scripts/platform-skills.mjs from the okdata catalog. Do not edit by hand. --> # 小红书数据助手（okdata） 用 okdata 的接口读小红书的公开数据：笔记、博主和大家在搜什么。 不用登录小红书，也不用 Cookie，按次付费，调用失败不收费。 ## 什么时候用 - 小红书数据分析、选题和爆款笔记调研 - 盯竞品账号和竞品笔记 - 看笔记评论区的口碑、提问和购买意向 - 找博主、筛达人，看粉丝和互动 - 用户发来小红书笔记链接，想看内容、数据或评论 ## 能拿到的数据 目录版本 2128c2e84655fc1f，价目表 1b273c48fea9634e。价格单位是美元，调用失败不收费。 | 接口 | 能拿到什么 | 需要传 | 每次返回 | 价格 | |---|---|---|---|---| | `xiaohongshu.notes.search` | 小红书笔记搜索：按关键词搜笔记，可按最新或最热，带图片和作者。 | `query` | 一页约 20 条 | 每次 $0.02 | | `xiaohongshu.notes.get` | 小红书笔记详情：一篇笔记的全文、全部图片（视频笔记只给封面，不含视频文件链接）、点赞、收藏和评论数。 | `id` 或 `url` | 一条 | 每次 $0.02 | | `xiaohongshu.notes.comments.list` | 小红书笔记评论：笔记下的评论，带点赞和回复数。 | `id` | 一页约 10 条 | 每次 $0.02 | | `xiaohongshu.users.get` | 小红书博主信息：博主的粉丝、获赞与收藏、笔记数和简介。 | `id` 或 `url` | 一条 | 每次 $0.02 | | `xiaohongshu.users.notes.list` | 小红书博主笔记列表：博主发布的笔记，从新到旧。 | `id` | 一页约 20 条 | 每次 $0.02 | | `xiaohongshu.trends.list` | 小红书热点话题：小红书当前推荐给创作者的热点话题，带热度。 | 不用传 | 一页约 20 条 | 每次 $0.02 | | `xiaohongshu.pgy.creators.search` | 小红书蒲公英达人搜索：在小红书官方达人广场「蒲公英」按笔记内容或昵称找达人，可按粉丝数和笔记类型筛选，按粉丝、互动、阅读或报价排序。返回粉丝数、日常笔记阅读和互动中位数、内容类目，以及图文和视频笔记报价（元）。 | `query` | 一页约 20 条 | 每次 $0.04 | | `xiaohongshu.pgy.creators.get` | 小红书蒲公英达人详情：达人在蒲公英上的资料：粉丝数、获赞与收藏、阅读和互动中位数、内容和特色标签，以及图文和视频笔记的报价（元）和是否开放接单。 | `id` | 一条 | 每次 $0.04 | | `xiaohongshu.shop.products.search` | 小红书商城商品搜索：按关键词搜小红书商城商品：标题、现价和原价（元）、图片和店铺。销量不以数字显示。 | `query` | 一页约 20 条 | 每次 $0.02 | | `xiaohongshu.shop.products.reviews.list` | 小红书商城商品评价：小红书商城商品买家评价的第一页：星级、内容、购买的款式、晒图和点赞数。App 不提供后续页。 | `id` | 一页约 12 条 | 每次 $0.02 | | `xiaohongshu.images.search` | 小红书图片搜索：按关键词搜图片，每条是一张图片和它所在的笔记：原图、笔记标题、正文、作者、点赞、评论和收藏。这里没有分享数，笔记详情里有。 | `query` | 一页约 20 条 | 每次 $0.02 | | `xiaohongshu.comments.replies.list` | 小红书评论回复：按一级评论 ID 和所在笔记 ID 取评论下的回复：内容、回复者、点赞和发布时间。评论不存在时和没有回复一样，返回空结果。 | `id`、`post_id` | 一页约 5 条 | 每次 $0.02 | | `xiaohongshu.topics.notes.list` | 小红书话题笔记：话题（标签）页下最热的笔记，一次约 10 篇：标题、正文、作者、点赞、评论、收藏、分享、图片和话题标签。 | `id` | 一页约 10 条 | 每次 $0.02 | | `xiaohongshu.topics.get` | 小红书话题详情：按话题页 ID 取一个话题（标签）：名称、简介、浏览量、页面上显示的讨论人数和话题链接。 | `id` | 一条 | 每次 $0.02 | | `xiaohongshu.users.search` | 小红书账号搜索：按关键词找账号：用户 ID、小红书号、昵称、头像、粉丝数（App 显示的约数）和官方认证。 | `query` | 一页约 20 条 | 每次 $0.02 | | `xiaohongshu.shop.products.get` | 小红书商城商品详情：按商品 ID 取小红书商城的一件商品：标题、现价和原价（元）、图片、已售件数、评分、评价数和店铺。看到的是 App 海外用户的商品页，促销可能和国内用户看到的不同。 | `id` | 一条 | 每次 $0.02 | | `xiaohongshu.keywords.related` | 小红书搜索联想词：在小红书搜索框输入关键词时给出的联想词，按它的顺序排，一次约 10 个。只有词和名次，没有指数。 | `keyword` | 一页约 10 条 | 每次 $0.02 | | `xiaohongshu.videos.get` | 小红书视频笔记详情（视频地址）：按 ID 或链接取一篇视频笔记：标题、正文、作者、点赞、评论、收藏和分享，加上视频文件地址、时长和封面、平台生成的字幕（有的话），以及是否为报备的品牌合作笔记。只用于视频笔记；图文笔记用笔记详情。 | `id` 或 `url` | 一条 | 每次 $0.02 | | `xiaohongshu.pgy.keywords.history` | 小红书蒲公英关键词搜索指数：关键词在小红书上最近约三个月（时间范围由平台定）的逐日搜索指数，带每天的相关笔记数、曝光、阅读和互动。搜索指数是平台的度量，不是搜索次数。 | `keyword` | 一条 | 每次 $0.04 | | `xiaohongshu.pgy.keywords.related` | 小红书蒲公英关联词：小红书用户搜一个词之前和之后还会搜的词，一次最多约 100 个，各带相关度名次、搜索指数、相关笔记数和阅读量。用来拓词选题。 | `keyword` | 一页约 98 条 | 每次 $0.04 | | `xiaohongshu.pgy.creators.audience.get` | 小红书蒲公英达人粉丝画像：按蒲公英达人 ID 取粉丝画像：性别、年龄段、省份、城市、兴趣和手机品牌各段的占比，以及数据所属日期。 | `id` | 一条 | 每次 $0.04 | | `xiaohongshu.pgy.creators.metrics` | 小红书蒲公英达人数据表现：按蒲公英达人 ID 取近 30 或 90 天日常或合作笔记的表现：笔记数和视频笔记数，曝光、阅读、互动和涨粉中位数，互动率、完播率，点赞过百和过千的笔记占比，超过多少同类达人，以及曝光和阅读的来源占比。完整视图另有逐篇笔记数据和约半年前笔记的长尾阅读。 | `id` | 一条 | 每次 $0.04 | | `xiaohongshu.pgy.creators.notes.list` | 小红书蒲公英达人笔记：按蒲公英达人 ID 取一页蒲公英「笔记案例」：阅读、点赞、收藏、外溢进店人数、是否合作及合作品牌。可只看合作笔记或跨域合作笔记、只看图文或视频，按最新、阅读最多或互动最多排，按内容特征或类目筛，阅读数可只算自然流量。 | `id` | 一页约 8 条 | 每次 $0.04 | | `xiaohongshu.pgy.creators.followers.history` | 小红书蒲公英达人粉丝趋势：按蒲公英达人 ID 取近 30 或 60 天每天的粉丝数，以及这段时间的净增和增长率。看达人是在稳定涨粉，还是突然掉粉或刷粉。 | `id` | 一条 | 每次 $0.04 | | `xiaohongshu.pgy.creators.related` | 小红书蒲公英相似达人：按蒲公英达人 ID 取蒲公英推荐的相似达人：ID、昵称、小红书号、所在地、内容类目、粉丝数、阅读和互动中位数，以及图文和视频笔记报价（元）。一页 4 位，通常共几位到几十位。 | `id` | 一页约 4 条 | 每次 $0.04 | | `xiaohongshu.pgy.notes.trending` | 小红书蒲公英内容广场热门笔记：蒲公英内容广场的热门笔记榜：小红书热门、产品种草、电商推广、蒲公英合作、客资收集、电商热门、种草直达、应用推广 8 个榜，看整榜或只看和某些词有关的，近 3、7、14 或 30 天，可只要图文或视频。每篇有标题、发布时间、阅读、点赞、收藏、评论、图片，以及达人的 ID、昵称和粉丝数。每个榜只有前 100 篇。 | 不用传 | 一页约 34 条 | 每次 $0.04 | | `xiaohongshu.pgy.creators.costs.metrics` | 小红书蒲公英达人合作成本概览：按蒲公英达人 ID 取预估合作成本：图文和视频笔记的预估 CPM、单次互动、单次阅读和单个进店成本，各带优于多少同类达人；单篇笔记曝光、阅读、互动和进店的中位数；近 30 天粉丝增长和发文数；邀约回复率、「好联系」和「活跃」标记；蒲公英标注的亮点、内容类目占比和合作过的行业。可看日常或合作笔记口径。 | `id` | 一条 | 每次 $0.04 | | `xiaohongshu.pgy.creators.followers.metrics` | 小红书蒲公英达人粉丝概览：按蒲公英达人 ID 取粉丝质量：粉丝数和近 30 天净增，以及活跃、互动、阅读和购买粉丝各有多少、占全部粉丝的比例和超过多少同类达人。 | `id` | 一条 | 每次 $0.04 | | `xiaohongshu.pgy.creators.costs.history` | 小红书蒲公英达人核心数据趋势：按蒲公英达人 ID 取近 30 或 90 天每天的核心数据：CPM、单次互动、单次阅读和单个进店成本，单篇笔记曝光、阅读、互动和进店人数的中位数，以及整段的汇总。可看日常或合作笔记口径。 | `id` | 一条 | 每次 $0.04 | | `xiaohongshu.pgy.notes.get` | 小红书蒲公英笔记数据：按笔记 ID 取蒲公英给品牌看的这篇笔记数据：曝光、阅读、点赞、收藏、评论、分享和带来的关注，报备的合作品牌，品牌组件的点击率档位，以及标题、正文、图片、发布时间和达人。蒲公英只有自己达人的笔记数据，没有数据的笔记返回不存在。 | `id` | 一条 | 每次 $0.04 | ## 怎么调用 **用 MCP（已接上 `okdata` MCP 服务时优先用）**：先用 `describe` 看一个接口的参数、返回字段和价格（免费），再用 `call` 调用， `capability` 填接口 id，参数跟在旁边，例如 `{"capability": "xiaohongshu.notes.search", "query": "防晒霜 推荐", "max_price": "0.05", "idempotency_key": "<uuid>"}`。 `find` 能用中文或英文描述找接口，`read_more` 取长结果的剩余部分，这两个也免费。 还没接上的话，远程 MCP 地址是 `https://api.okdata.online/mcp`，认证头是 `Authorization: Bearer <key>`，详见 `okdata-setup` 技能。 **用 HTTP（没有 MCP 时）**：路径是接口 id 把点换成斜杠、放在 `/v1` 下面，参数放在查询串里，key 从环境变量读，不要贴进对话： ```bash curl -sG "https://api.okdata.online/v1/xiaohongshu/notes/search" \ -H "Authorization: Bearer $OKDATA_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ --data-urlencode 'query=防晒霜 推荐' ``` 每个返回都带 `code`。`"ok"` 时数据在 `data.items`（列表，翻页看 `page.next_cursor`）或 `data.item` 里， `meta.billing.amount` 是这次花了多少钱。其他 `code` 都是出错，会说明 `charged` 和 `retry`：`not_found` 不要重试， `rate_limited` 等 `retry_after_seconds` 再试，`timeout` 用同一个 `Idempotency-Key` 重发，不会重复扣费。 ## 用法建议 1. 先用搜索类接口找到内容或账号，再查详情、评论或作品列表。用户直接发来小红书笔记链接时，表格里「需要传」写着 `url` 的接口可以直接传链接，不用自己拆 id。 2. 列表接口一次返回一页。要更多就带上 `page.next_cursor` 再调一次，在 MCP 里也可以用 `read_more`。 3. 调用前先算一下要调几次、大概多少钱，告诉用户再动手。给 `call` 设 `max_price`：这次可能花得比它多时，调用会被拒绝，不扣钱。 4. 只读公开数据：不发帖、不点赞、不评论、不私信。 5. 还没有 key：到 https://okdata.online/zh/signup/?src=skill-okdata-xiaohongshu 注册，在控制台创建 key，设成环境变量 `OKDATA_API_KEY`。不要让用户把 key 贴进对话。 ## 相关技能 - `okdata-setup`：接入 MCP、保存 key、查价格和余额、排查报错 - `okdata-comments`：跨平台读评论，做口碑分析 - `okdata-competitors`：竞品账号监控和对比 - `okdata-creators`：按领域找达人、筛博主 - `okdata-trends`：各平台热搜热榜 - `okdata-content-research`：爆款内容调研 接口说明和价格：https://okdata.online/zh/apis/xiaohongshu/

存档时间线

版本索引永久保留；内容副本只保留最新 1 份，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本