RedNote (Xiaohongshu)

RedNote (Xiaohongshu) MCP Server

Xiaohongshu (小红书) data inside Claude, ChatGPT, Cursor and your own code: search notes, read comment threads, look up creators. Hosted and read-only. No RedNote login, no cookies, nothing to install.

English · 简体中文

Built from a real search run on 31 October 2026.

Quick start · Agent setup · Tools · Prompts · Client setup · API · Pricing · FAQ

RedNote MCP is a hosted Xiaohongshu MCP server that connects your AI assistant to RedNote, the app also known as Xiaohongshu (小红书), XHS and Little Red Book. Ask in English or Chinese: your assistant searches notes by keyword or hashtag, reads full posts with their images and video, pulls comment threads with replies, and looks up creators with their follower counts and recent posts. Results come back as structured rows it can sort, filter, translate and summarise. Developers can call the same tools as a RedNote / Xiaohongshu API.

Why RedNote MCP

• No RedNote account. No QR-code login, no cookies, no Chinese phone number. Your own RedNote account is never used, so it is never at risk.
• Nothing to install. Add one URL and sign in with Apify. Works in claude.ai and ChatGPT too, not only in desktop apps.
• Four tools in one server. Note search, full notes, comments with replies, and creator profiles with their posts.
• Rich, structured data. Likes, collects, comments and shares per note, author details, every image, video streams, the region shown on notes and comments, creator follower counts and agency tags.
• Maintained for you. Used by more than 10,000 people on the Apify Store. When RedNote changes, the tools are updated; your setup stays the same.
• Made for assistants. A bundled skill teaches your assistant the inputs that work and how to chain the tools, and long requests keep running while it checks back.
• Pay per result. Plus a small start fee per run, billed to your own Apify account. No subscription; try it on Apify's free plan.

How it works

flowchart LR

A["Your AI assistant Claude · ChatGPT · Cursor · VS Code"] -->|"remote MCP URL Apify sign-in"| B["RedNote MCP server 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

Each tool call starts a run on your Apify account. Your assistant waits for it, reads the rows, and answers in plain language. Chain the tools for deeper answers: search a topic, open the top notes, read their comments, then look up the creators behind them.

Quick start

1. Create a free [Apify account](https://console.apify.com/sign-up) if you do not have one.
2. Add the server to your assistant. Click a button above, or follow the steps for your client below.
3. Sign in with Apify when your assistant asks, then ask a question such as *"Find the 10 most-liked RedNote notes about camping gear (露营装备) from the past week and summarise what people recommend."*

About the Apify sign-in page. Apify notes that your assistant "was registered dynamically and wasn't verified by Apify" and asks for full API access. Every assistant that signs in this way sees that notice; it lets your assistant start runs on your account. You can remove the access at any time on your Apify Console integrations page.

Server URL, for any client that accepts a remote MCP server:

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

Set up with your AI agent

Paste this repository's URL into Claude Code, Codex, Cursor or another agent and ask it to set up RedNote. The steps below are written so your agent can follow them.

For AI agents installing this server:

1. This is a hosted remote MCP server (streamable HTTP). There is nothing to download or build. It needs a free Apify account and an Apify sign-in (OAuth) in the user's browser; do not ask for an API token unless the sign-in fails.
2. Server name rednote, server 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

1. Add it with the client's own command:

• Claude Code: claude plugin marketplace add zen-studio-labs/rednote-xiaohongshu-mcp, then claude plugin install rednote@rednote-xiaohongshu-mcp (adds the server and the RedNote skill).
• Codex: codex mcp add rednote --url " ", then codex mcp login rednote.
• VS Code: code --add-mcp '{"name":"rednote","type":"http","url":" "}'.
• Cursor and other clients: add {"mcpServers": {"rednote": {"url": " "}}} to the client's MCP config file (Cursor: ~/.cursor/mcp.json).

1. Ask the user to complete the sign-in. In Claude Code they run /mcp, select rednote and choose Authenticate; other clients open the Apify sign-in page themselves. A client restart may be needed before the tools appear.
2. Check it works with one small Note details request, for example noteUrls: ["69db721a00000000220290a8"]. Each note is billed to the user's Apify account. Do not test with search: Apify's free plan allows only three search runs in total.
3. Before real requests, read the RedNote skill: it explains how long runs work, how the tools chain together and which inputs return good results.

Tools

All tools are read-only. They never post, like, comment, follow or send messages.

Key fields per tool

Each Store page lists every field.

Example prompts

Brand and product research

• *What are people saying about lululemon on Xiaohongshu? Read the top 50 comments on the three most-liked notes and group them into praise and complaints.*
• *Compare how RedNote users talk about Dyson and Laifen hair dryers: price, noise, results.*

Trends and content ideas

• *Find the newest RedNote notes about 露营 from the past day and list the topics that keep coming up.*
• *What kinds of 穿搭 posts got the most collects this week? Summarise the formats that work.*

Influencers (KOL)

• *Find RedNote creators who post about 成都美食 and compare their follower counts and average likes.*
• *Look up this creator and rank their last 20 posts by likes: https://www.xiaohongshu.com/user/profile/65c381340000000011014d37*

Social listening

• *Read the comments on this note, most liked first, and group them by sentiment: https://www.xiaohongshu.com/discovery/item/69db721a00000000220290a8*
• *Which regions do the commenters on this note come from? Show a count per region.*

Single notes

• *Get the f