RedNote (Xiaohongshu)

RedNote（小红书）MCP 服务

在 Claude、ChatGPT、Cursor 和你自己的代码中获取小红书（小红书）数据：搜索笔记、阅读评论串、查找创作者。托管式、只读。无需登录 RedNote，无需 Cookie，也无需安装任何内容。

English · 简体中文

_{基于 2026 年 10 月 31 日的一次真实搜索运行构建。}

快速开始 · Agent 设置 · 工具 · 提示词 · 客户端设置 · API · 定价 · 常见问题

RedNote MCP 是一个托管式小红书 MCP 服务，可将你的 AI 助手连接到 RedNote，也就是小红书（小红书）、XHS 和 Little Red Book。用英语或中文提问：助手可按关键词或话题标签搜索笔记，读取包含图片和视频的完整帖子，获取带回复的评论串，并查找创作者及其粉丝数和近期帖子。结果将以结构化行的形式返回，方便排序、筛选、翻译和总结。开发者也可以将同一批工具作为 RedNote / 小红书 API 调用。

为什么选择 RedNote MCP

• 无需 RedNote 账号。 无需扫码登录、Cookie 或中国手机号。不会使用你的 RedNote 账号，因此账号不会有风险。
• 无需安装任何内容。 添加一个 URL，然后使用 Apify 登录。claude.ai 和 ChatGPT 也能使用，不限于桌面应用。
• 一个服务包含四种工具。 笔记搜索、完整笔记、带回复的评论，以及包含帖子内容的创作者主页。
• 丰富、结构化的数据。 每条笔记的点赞数、收藏数、评论数和分享数、作者详情、所有图片、视频流、笔记和评论中显示的地区、创作者粉丝数和机构标签。
• 由我们为你维护。 Apify Store 上有超过 10,000 人使用。RedNote 发生变化时，工具会随之更新；你的配置保持不变。
• 专为助手打造。 内置技能会教助手使用哪些输入，以及如何串联工具；处理较长请求时，助手会持续运行并定期检查进度。
• 按结果付费。 每次运行另收少量启动费用，费用计入你自己的 Apify 账号。无需订阅；可使用 Apify 免费计划试用。

工作原理

flowchart LR
    A["Your AI assistant<br/>Claude · ChatGPT · Cursor · VS Code"] -->|"remote MCP URL<br/>Apify sign-in"| B["RedNote MCP server<br/>hosted on Apify"]
    B --> C["Note search"]
    B --> D["Note details"]
    B --> E["Comments"]
    B --> F["Creator profiles"]
    C --> G["Structured rows"]
    D --> G
    E --> G
    F --> G
    G -->|"sort · filter · translate · summarise"| A

每次工具调用都会在你的 Apify 账号上启动一次运行。助手会等待运行完成、读取数据行，然后用通俗易懂的语言作答。可以串联工具来获取更深入的答案：搜索主题、打开热门笔记、阅读评论，然后查找笔记背后的创作者。

快速开始

1. 如果你还没有 Apify 账号，请创建免费账号。
2. 将服务添加到你的助手。 点击上方的按钮，或按照下方针对你的客户端的步骤操作。
3. 助手提示时，使用 Apify 登录，然后提出问题，例如 “查找过去一周关于露营装备（露营装备）的获赞数最高的 10 条 RedNote 笔记，并总结大家推荐了什么。”

关于 Apify 登录页面。 Apify 提示，你的助手“是动态注册的，未经 Apify 验证”，并要求完全的 API 访问权限。所有以这种方式登录的助手都会看到此提示；此权限可让助手在你的账号上启动运行。你可以随时在 Apify Console 集成页面移除此访问权限。

适用于任何支持远程 MCP 服务的客户端的服务 URL：

https://mcp.apify.com/?tools=fetch-actor-details,get-actor-run,get-dataset-items,zen-studio/rednote-search-scraper,zen-studio/rednote-note-detail-scraper,zen-studio/rednote-comments-scraper,zen-studio/rednote-user-profile-scraper

使用 AI Agent 进行设置

将此仓库的 URL 粘贴到 Claude Code、Codex、Cursor 或其他 Agent 中，并让它设置 RedNote。以下步骤便于 Agent 按照说明操作。

面向安装此服务的 AI Agent：

1. 这是一个托管的远程 MCP 服务（流式 HTTP）。无需下载或构建。用户需要一个免费的 Apify 账户，并在浏览器中通过 Apify 登录（OAuth）；除非登录失败，否则不要索要 API 令牌。
2. 服务名称为 rednote，服务 URL：

   https://mcp.apify.com/?tools=fetch-actor-details,get-actor-run,get-dataset-items,zen-studio/rednote-search-scraper,zen-studio/rednote-note-detail-scraper,zen-studio/rednote-comments-scraper,zen-studio/rednote-user-profile-scraper
   

3. 使用客户端自身的命令添加：
   • Claude Code：claude plugin marketplace add zen-studio-labs/rednote-xiaohongshu-mcp，然后运行 claude plugin install rednote@rednote-xiaohongshu-mcp（添加服务和 RedNote 技能）。
   • Codex：codex mcp add rednote --url "<server URL>"，然后运行 codex mcp login rednote。
   • VS Code：code --add-mcp '{"name":"rednote","type":"http","url":"<server URL>"}'。
   • Cursor 和其他客户端：将 {"mcpServers": {"rednote": {"url": "<server URL>"}}} 添加到客户端的 MCP 配置文件中（Cursor：~/.cursor/mcp.json）。
4. 请用户完成登录。在 Claude Code 中，用户运行 /mcp，选择 rednote 并选择 Authenticate；其他客户端会自行打开 Apify 登录页面。可能需要重启客户端才能看到这些工具。
5. 通过一条简单的笔记详情请求检查是否正常工作，例如 noteUrls: ["69db721a00000000220290a8"]。每条笔记都会计入用户的 Apify 账户费用。不要使用搜索进行测试：Apify 免费套餐总共只允许进行三次搜索。
6. 在发送实际请求前，请阅读 RedNote 技能：其中介绍了长时间运行的任务如何工作、这些工具如何串联，以及哪些输入能返回良好结果。

工具

所有工具均为只读。它们不会发布内容、点赞、评论、关注或发送消息。

示例提示词

品牌和产品调研

• 大家在小红书上怎么评价 lululemon？阅读点赞数最高的 3 条笔记下的前 50 条评论，并将它们归纳为好评和抱怨。
• 比较 RedNote 用户如何评价 Dyson 和 Laifen 吹风机：价格、噪音、效果。

趋势和内容创意

• 查找过去一天里最新的 RedNote 露营笔记，并列出反复出现的话题。
• 本周哪些穿搭笔记的收藏数最高？总结效果好的内容形式。

影响者（KOL）

• 查找发布成都美食相关内容的 RedNote 创作者，并比较他们的粉丝数和平均点赞数。
• 查找这位创作者，并按点赞数为其最近 20 条帖子排名：https://www.xiaohongshu.com/user/profile/65c381340000000011014d37

社交聆听

• 阅读这条笔记下的评论，按点赞数从高到低排序，并按情感倾向归类：https://www.xiaohongshu.com/discovery/item/69db721a00000000220290a8
• 这条笔记的评论者来自哪些地区？按地区显示人数。

单条笔记

• 获取这条笔记的完整文本和标签：http://xhslink.com/o/6oKW7wkJf09
• 将这条笔记及其热门评论翻译成英文。

中文示例

• 搜索小红书上关于“上海咖啡店”的最新笔记，总结大家最推荐的店。
• 找出最近一周点赞最多的护肤笔记，列出被提到最多的产品。

提示：搜索中文话题时，请使用中文（露营、穿搭、护肤）；人们就是这样写笔记的。品牌名（如 lululemon）和话题标签（如 #露营）可以直接使用。

客户端设置

/plugin marketplace add zen-studio-labs/rednote-xiaohongshu-mcp
/plugin install rednote@rednote-xiaohongshu-mcp

claude mcp add --transport http rednote "https://mcp.apify.com/?tools=fetch-actor-details,get-actor-run,get-dataset-items,zen-studio/rednote-search-scraper,zen-studio/rednote-note-detail-scraper,zen-studio/rednote-comments-scraper,zen-studio/rednote-user-profile-scraper"

codex mcp add rednote --url "https://mcp.apify.com/?tools=fetch-actor-details,get-actor-run,get-dataset-items,zen-studio/rednote-search-scraper,zen-studio/rednote-note-detail-scraper,zen-studio/rednote-comments-scraper,zen-studio/rednote-user-profile-scraper"
codex mcp login rednote

{
  "mcpServers": {
    "rednote": {
      "url": "https://mcp.apify.com/?tools=fetch-actor-details,get-actor-run,get-dataset-items,zen-studio/rednote-search-scraper,zen-studio/rednote-note-detail-scraper,zen-studio/rednote-comments-scraper,zen-studio/rednote-user-profile-scraper"
    }
  }
}

每个工具也是一个带有 REST API 的 Apify Actor，因此你可以从自己的代码、流水线或自动化中调用，无需助手。请从 Apify Console integrations page 复制 API 令牌。输入字段与助手使用的相同；每个 Store 页面都有一个 API 标签页，提供现成代码和完整的输入参考。

pip install apify-client

import os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("zen-studio/rednote-search-scraper").call(
    run_input={"keywords": ["露营装备"], "maxResults": 20, "sortType": "popularity_descending"}
)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["engagement"]["liked_count"], item["title"], item["url"])

npm install apify-client

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('zen-studio/rednote-search-scraper').call({
    keywords: ['露营装备'],
    maxResults: 20,
    sortType: 'popularity_descending',
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

curl -X POST "https://api.apify.com/v2/acts/zen-studio~rednote-search-scraper/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"keywords": ["露营装备"], "maxResults": 20}'

其他工具：将 Actor ID 替换为 zen-studio/rednote-note-detail-scraper、zen-studio/rednote-comments-scraper 或 zen-studio/rednote-user-profile-scraper。

使用场景

• 品牌和产品调研。 直接从笔记和评论中了解大家推荐、比较和吐槽的内容。
• 趋势监测。 按关键词或话题标签查找本周最新或最受喜欢的笔记。
• 达人发现（KOL）。 寻找特定领域的创作者，然后比较粉丝数、互动情况和机构关联。
• 社交聆听。 获取包含回复和评论者地区信息的评论串，可直接用于情感分析。
• 内容调研。 了解所在品类中收藏量最高的笔记背后的标题、形式和话题标签。
• 跨境购物和旅行调研。 了解中国消费者和旅行者对某种产品、商店或城市的评价。

示例输出

一条经过删节的搜索结果。你的助手会读取这类结果，并用通俗语言作答。

{
  "id": "6a0000000000000000000001",
  "type": "normal",
  "title": "新手露营装备清单｜一次买对不踩坑",
  "desc": "第一次露营就买了这些，帐篷、天幕、折叠椅都整理好了 #露营 #露营装备",
  "url": "https://www.xiaohongshu.com/discovery/item/6a0000000000000000000001?xsec_token=...",
  "timestamp": 1793186400,
  "engagement": {
    "liked_count": 8231,
    "comments_count": 412,
    "collected_count": 5907,
    "shared_count": 655
  },
  "author": {
    "userid": "5f0000000000000000000001",
    "nickname": "周末去露营",
    "verified": false
  },
  "images": [{ "url": "https://...", "width": 1080, "height": 1440 }],
  "video": null
}

请求的处理时长

每次工具调用会在约 45 秒内返回。较大的请求会在此后继续由 Apify 处理；你的助手会持续检查，直到结果就绪，然后分页读取结果。你可能会看到几条“仍在运行”的更新，这是正常现象。RedNote skill 会教助手如何处理此流程，以及各工具的输入示例。Claude Code 会通过插件获得这些内容。

定价

按结果付费，每次运行另收少量启动费，费用计入你的 Apify 账户。此代码库不提供订阅服务。当前价格（含批量折扣）见各工具的定价页面：

• 笔记搜索
• 笔记详情
• 评论
• 创作者资料

你的助手可以通过 maxResults 等结果上限控制费用。先请求少量结果，再逐步增加。

Apify 免费套餐： 每种工具可进行少量预览运行，并设有较低的结果上限。搜索：总共 3 次运行，从第一个关键词获取约 20 条笔记。评论：15 次运行，获取约 20 条顶层评论，不含回复。创作者资料：15 次运行，获取 1 个资料及约 20 条笔记。保存视频和图片需要付费套餐。任何付费 Apify 套餐均会取消这些上限。

限制

• 无法按名称或主题搜索创作者。 先通过笔记搜索找到创作者，再查找作者信息。
• 没有首页动态或热门列表。 请改用笔记搜索，并按最新或最热门排序。
• 只读。 无法发布、点赞、评论或发送消息。
• 媒体链接会过期。 图片和视频链接的有效期为数小时至数天；笔记 URL 是长期有效的引用。

请负责任地使用数据，并遵守 RedNote 的条款以及适用于你的数据保护法律，例如《个人信息保护法》（PIPL）和《通用数据保护条例》（GDPR）。

故障排除

• /mcp 显示服务尚未通过身份验证，或无法获取其工具。 选择该服务并点击 Authenticate。其他客户端会显示 Connect 或 Sign in 按钮。
• 搜索结果很少。 越具体的关键词越容易搜完。试试相关关键词、中文词语，或移除时间筛选条件。
• 无法按名称找到创作者。 显示名称并不唯一。请使用个人资料中的 RedNote ID（小红书号）、个人资料链接，或其笔记链接。
• 搜索约 20 条笔记后停止，或没有剩余搜索次数。 这是 Apify 免费套餐的限制。任何付费套餐都没有此限制。
• 助手提示某次运行仍在进行。 对于较大的请求，这是正常的。让它继续检查同一次运行；针对同一问题发起新请求会再次计费。
• 图片或视频链接失效。 媒体链接会在数小时至数天后过期。重新获取笔记，或使用 Note details 保存文件。
• 客户端无法完成登录。 请改用 Apify 令牌请求头，参阅其他客户端。

常见问题

什么是 RedNote？ RedNote 是小红书（小红书，常简称为 XHS）的国际名称。这款中国生活方式和购物探索应用的月活跃用户超过 3 亿。笔记包含照片、视频和评论类文字，主题涉及美妆、时尚、美食、旅行、健身和购物。

这与开源 RedNote MCP 服务有什么不同？ 开源服务会在你的设备上运行浏览器，并使用你已登录的 RedNote 账号，其中许多还可以发布内容和评论。RedNote MCP 由托管服务提供，只读：无需 RedNote 账号，无需运行任何程序，还可用于 claude.ai 和 ChatGPT 等网页版助手。研究和获取数据请使用 RedNote MCP；如果要从自己的账号发布内容，请使用可自托管的工具。

我需要 RedNote 账号或中国手机号吗？ 不需要。你只需要一个 Apify 账号，创建只需一分钟。

它能发布内容、点赞或评论吗？ 不能。所有工具都经过设计，仅支持只读操作。

数据是实时的吗？ 是的。结果反映的是你发起请求时 RedNote 上的内容。

我可以在中国境外使用吗？ 可以，任何国家都能使用。大多数笔记为中文；请让助手为你翻译。

哪些 AI 助手可以使用？ 任何支持远程 MCP 服务的客户端都可以，包括 Claude（claude.ai、Claude Desktop、Claude Code）、ChatGPT、Codex、Cursor、集成 GitHub Copilot 的 VS Code 等。

有 RedNote API 或小红书 API 吗？ 有。每个工具都可以通过 REST API 调用，也可以使用 Apify 的 Python 和 JavaScript 客户端调用，参阅将其用作 RedNote／小红书 API。

我可以下载 RedNote 视频、图片或字幕吗？ 可以。Note details 可以将最高 4K 的视频、原始图片、Live Photos 和字幕（.srt）文件保存到你的 Apify 存储空间。下载视频和图片需要付费 Apify 套餐，并按文件计费；字幕不额外收费。

它免费吗？ 你可以使用 Apify 免费套餐试用，每种工具可进行几次预览运行。之后按结果付费；参阅定价。

这是 RedNote 的官方产品吗？ 不是。RedNote MCP 是 Zen Studio 推出的独立产品，与 RedNote 或小红书没有关联。

隐私

请求会发送到 Apify 托管的 MCP 服务，并在你的 Apify 账号上运行。Apify 的隐私政策适用。本仓库仅包含配置和说明，不会收集任何信息。

Zen Studio 的更多内容

RedNote MCP 基于 Zen Studio's Apify Actors 构建。你也可以直接在 Apify 上、通过其 API 或按计划运行每个工具。如需查看 Xianyu（闲鱼）二手商品信息，请参阅 Goofish MCP。

许可证

MIT。RedNote、Xiaohongshu 和小红书是其各自所有者的商标。