---
title: "RedNote (Xiaohongshu) MCP Server, No Cookie · SocialToAI"
canonical: https://socialtoai.app/mcp/xiaohongshu/
updated: 2026-11-20
---

# Xiaohongshu (RedNote) MCP Server

SocialToAI is a hosted MCP server that lets your AI read Xiaohongshu (RedNote): search notes and read note details, comments, account profiles, an account's notes and the trending list. You add one address to Claude, ChatGPT or Cursor; there is no Xiaohongshu account, login or cookie to provide and nothing to install. Each call costs 12 credits (from $0.024); failed calls are free. Last tested 2026-11-19.

- Page: https://socialtoai.app/mcp/xiaohongshu/
- Last updated: 2026-11-20
- Last tested: 2026-11-19

## Connect SocialToAI

Address: `https://socialtoai.app/mcp`

Add an MCP server in your AI and enter this address. If a sign-in page opens, sign in with your email and press Allow. If your tool asks for a key instead, copy one from the console and put it in a header: `Authorization: Bearer <YOUR_API_KEY>`. [Get a key](https://socialtoai.app/console/keys/)

In a terminal: run a command, then sign in: 

Claude Code: 

```
claude mcp add --transport http socialtoai https://socialtoai.app/mcp
```

Then in Claude Code type /mcp, pick socialtoai and sign in.

Codex: 

```
codex mcp add socialtoai --url https://socialtoai.app/mcp
```

Then sign in in the browser that opens.

Writing code? Call the API with a key: see [the API docs](https://socialtoai.app/docs.md).

## Step-by-step for your client

The same address everywhere. Each client has a page: where to enter it, how it signs in, and what to ask first.

- [Claude Code](https://socialtoai.app/connect/claude-code.md): Run a command, then sign in
- [Claude app](https://socialtoai.app/connect/claude.md): Paste the address, then sign in
- [ChatGPT](https://socialtoai.app/connect/chatgpt.md): Paste the address, then sign in
- [Cursor](https://socialtoai.app/connect/cursor.md): Add the address, then sign in
- [Codex](https://socialtoai.app/connect/codex.md): Run a command, then sign in
- [Trae](https://socialtoai.app/connect/trae.md): A few lines of settings and a key
- [Cherry Studio](https://socialtoai.app/connect/cherry-studio.md): The address and a key in a form
- [Dify](https://socialtoai.app/connect/dify.md): The address and a key in a form
- [n8n](https://socialtoai.app/connect/n8n.md): The address and a key in a form

The MCP page: https://socialtoai.app/mcp.md

## What your AI can call on Xiaohongshu

| Tool | What it returns | Price key | Credits | Parameters and fields |
| --- | --- | --- | --- | --- |
| `search` | Find notes by keyword: text, author, likes, comment count and publish time. | `xiaohongshu.search` | 12 | https://socialtoai.app/xiaohongshu-search-api.md |
| `trending` | What is trending now: title, rank and heat. | `xiaohongshu.trending` | 12 | https://socialtoai.app/xiaohongshu-trending-api.md |
| `detail` | One note by ID or link: text, author, likes, comment count and publish time. | `xiaohongshu.detail` | 12 | https://socialtoai.app/xiaohongshu-detail-api.md |
| `comments` | The comments under one note: text, likes, reply count and time. | `xiaohongshu.comments` | 12 | https://socialtoai.app/xiaohongshu-comments-api.md |
| `user_profile` | One account: name, bio, followers, following and post count. | `xiaohongshu.user_profile` | 12 | https://socialtoai.app/xiaohongshu-user-profile-api.md |
| `user_posts` | The recent notes of one account. | `xiaohongshu.user_posts` | 12 | https://socialtoai.app/xiaohongshu-user-posts-api.md |

### Only on Xiaohongshu (through the call tool)

| Interface | What it does | Price key | Credits | Parameters and fields |
| --- | --- | --- | --- | --- |
| `kol_search` | Find Xiaohongshu creators on PGY by search terms, by the filters of PGY's creator square, or both. | `xiaohongshu.kol_search` | 24 | https://socialtoai.app/xiaohongshu-kol-search-api.md |
| `kol_profile` | Get a Xiaohongshu creator's profile on PGY by creator ID. | `xiaohongshu.kol_profile` | 24 | https://socialtoai.app/xiaohongshu-kol-profile-api.md |
| `kol_audience` | Get who follows a Xiaohongshu creator, by PGY creator ID. | `xiaohongshu.kol_audience` | 24 | https://socialtoai.app/xiaohongshu-kol-audience-api.md |
| `kol_performance` | Get how a Xiaohongshu creator's everyday or sponsored notes did over the last 30 or 90 days, by PGY creator ID. | `xiaohongshu.kol_performance` | 24 | https://socialtoai.app/xiaohongshu-kol-performance-api.md |
| `keyword_history` | Get a keyword's day-by-day search index on Xiaohongshu over about the last three months, from the platform's creator marketplace, with each day's notes about the keyword and how often they were shown, read and engaged with. | `xiaohongshu.keyword_history` | 24 | https://socialtoai.app/xiaohongshu-keyword-history-api.md |
| `product_search` | Search the products of Xiaohongshu's shop by terms. | `xiaohongshu.product_search` | 12 | https://socialtoai.app/xiaohongshu-product-search-api.md |
| `product_detail` | Get a product of Xiaohongshu's shop by its ID. | `xiaohongshu.product_detail` | 12 | https://socialtoai.app/xiaohongshu-product-detail-api.md |
| `product_reviews` | Get the first page of buyers' reviews of a product of Xiaohongshu's shop by the product's ID. | `xiaohongshu.product_reviews` | 12 | https://socialtoai.app/xiaohongshu-product-reviews-api.md |
| `kol_notes` | Get a page of a Xiaohongshu creator's notes by PGY creator ID (PGY's note cases), with the figures PGY gives for each. | `xiaohongshu.kol_notes` | 24 | https://socialtoai.app/xiaohongshu-kol-notes-api.md |
| `topic_notes` | Get the trending notes under a Xiaohongshu topic by its page ID. | `xiaohongshu.topic_notes` | 12 | https://socialtoai.app/xiaohongshu-topic-notes-api.md |
| `keyword_related` | Get what people search on Xiaohongshu before and after a keyword, from the platform's creator marketplace, each with its place by relevance, its search index, the notes about it and their reads. | `xiaohongshu.keyword_related` | 24 | https://socialtoai.app/xiaohongshu-keyword-related-api.md |
| `topic` | Get one Xiaohongshu topic by its page ID. | `xiaohongshu.topic` | 12 | https://socialtoai.app/xiaohongshu-topic-api.md |
| `search_suggestions` | Get the suggestions Xiaohongshu's search box lists as a keyword is typed into it (autocomplete), in the order it lists them, about 10 at a time. | `xiaohongshu.search_suggestions` | 12 | https://socialtoai.app/xiaohongshu-search-suggestions-api.md |
| `video_detail` | Get one Xiaohongshu video note by ID or link. | `xiaohongshu.video_detail` | 12 | https://socialtoai.app/xiaohongshu-video-detail-api.md |
| `kol_follower_history` | Get a Xiaohongshu creator's follower count for each of the last 30 or 60 days, by PGY creator ID, with the net gain over the period and that gain as a share. | `xiaohongshu.kol_follower_history` | 24 | https://socialtoai.app/xiaohongshu-kol-follower-history-api.md |
| `kol_similar` | Give a PGY creator ID and get the Xiaohongshu creators PGY recommends as similar. | `xiaohongshu.kol_similar` | 24 | https://socialtoai.app/xiaohongshu-kol-similar-api.md |
| `kol_trending_notes` | Get the trending notes of PGY's content square. | `xiaohongshu.kol_trending_notes` | 24 | https://socialtoai.app/xiaohongshu-kol-trending-notes-api.md |
| `kol_costs` | Get what a Xiaohongshu creator is expected to cost, by PGY creator ID. | `xiaohongshu.kol_costs` | 24 | https://socialtoai.app/xiaohongshu-kol-costs-api.md |
| `kol_cost_history` | Get a Xiaohongshu creator's core figures for each of the last 30 or 90 days, by PGY creator ID. | `xiaohongshu.kol_cost_history` | 24 | https://socialtoai.app/xiaohongshu-kol-cost-history-api.md |
| `kol_follower_quality` | Get how much a Xiaohongshu creator's followers are worth, by PGY creator ID. | `xiaohongshu.kol_follower_quality` | 24 | https://socialtoai.app/xiaohongshu-kol-follower-quality-api.md |
| `kol_note_metrics` | Get the figures PGY shows a brand for one Xiaohongshu note, by note ID. | `xiaohongshu.kol_note_metrics` | 24 | https://socialtoai.app/xiaohongshu-kol-note-metrics-api.md |

## A recorded conversation

### Xiaohongshu

> What are people on Xiaohongshu saying about camping coffee?

| Platform | Tool | Sent | Requests | Returned | Credits |
| --- | --- | --- | --- | --- | --- |
| Xiaohongshu | [`brand_buzz`](https://socialtoai.app/tools/brand-buzz.md) | `brand: "露营咖啡" · about: "户外露营时自己做咖啡" · platforms: ["xiaohongshu"] · window: "90d" · scale: "small"` | 1 | 13 notes | 36 |
| **Total** |  |  | 1 | 13 items | **36** |

Recorded 2026-10-18

8 of the 13 posts found are about it: 100% positive, 0% neutral, 0% negative. What they mention most:

1. **Features** (38%, 3 notes): [“泰摩手冲套装，户外也能稳定萃取”](https://www.xiaohongshu.com/discovery/item/6ace5030000000000202b50a?xsec_token=YBG8sJk5ubaOiy4IR4aWFju_M8woOWi5f596-EyQu89_I%3D&xsec_source=app_share)
2. **Ease of use** (25%, 2 notes): [“意外比想象中方便。 撕开直接倒进水或牛奶里，冷水大约3秒就能化开”](https://www.xiaohongshu.com/discovery/item/6a7166a8000000002500db01?xsec_token=YBPlj8LOiespGe8OC5mJrELhKzAcNDnW_YlU9aDOcRrL0%3D&xsec_source=app_share)
3. **Quality** (13%, 1 note): [“亲手萃取的温柔质感 是成年人超治愈的低成本快乐”](https://www.xiaohongshu.com/discovery/item/6a5f63d40000000001033a6e?xsec_token=YB4BbvhOU2v5iwKzbmgNXN3JuvanMCovT7SnEUZ4w3TH0%3D&xsec_source=app_share)

Used 36 credits · $0.12. Every claim links to its source.

### Viral posts

> Which camping notes on Xiaohongshu are taking off this month?

| Platform | Tool | Sent | Requests | Returned | Credits |
| --- | --- | --- | --- | --- | --- |
| Xiaohongshu | [`research viral_finder`](https://socialtoai.app/tools/viral-finder.md) | `query: "露营" · window: "30d" · scale: "small"` | 1 | 14 notes | 54 |
| **Total** |  |  | 1 | 14 items | **54** |

Recorded 2026-10-18

14 posts found; 1 did at least 3 times the usual. The formats that took off most, each with its share of the 14 posts the analysis could name:

1. **Comedy** (7%, 1 note): [“孩子期盼已久的露营，终于安排上了”](https://www.xiaohongshu.com/discovery/item/6accc58f000000001803899c?xsec_token=YBrpZDYeMwvWxiZ3xP2aQnayx1a9OTzYNWdEgZtGCiVlY%3D&xsec_source=app_share)
2. **Story** (36%, 5 notes): 0 of them did at least 3 times the usual
3. **Showcase** (21%, 3 notes): 0 of them did at least 3 times the usual

Used 54 credits · $0.18. Every claim links to its source.

## Questions to ask

- Which is bigger on Xiaohongshu this week: home coffee or matcha? → search, search: 24 credits ($0.08)
- Read the comments on this Xiaohongshu note and tell me what people complain about. → detail, comments × 3: 48 credits ($0.16)
- Find five Xiaohongshu accounts that post about camping coffee and show me what they posted lately. → search, user_posts × 5: 72 credits ($0.24)

## What it cannot do

- **Fields Xiaohongshu does not give**: They come back as null and are listed in the answer's unavailable, so your AI reads them as “not given”, not as zero. `author.verified`, `author.followers`, `metrics.views`, `metrics.reposts`, `hashtags`, `is_pinned`, `rank`, `url`, `author.username`
- **It reads. It does not post.**: Your AI cannot post, comment, like, follow or send messages on Xiaohongshu through SocialToAI.
- **Only what is publicly visible**: Content and account information anyone can see on Xiaohongshu. Nothing behind a login: no private accounts, no direct messages, no feed of your own.

## FAQ

**Does Xiaohongshu have an official API? Is this server official?**

Not for public content: Xiaohongshu's open platform offers login only, and documents no API for reading public notes or comments. This MCP server is run by SocialToAI; it is not the platform's own and is not affiliated with it. Source: openaccount.xiaohongshu.com, checked 2026-10-17.

**Can Claude and ChatGPT use it?**

Yes. In Claude or ChatGPT, on the web or the desktop app, paste the address above as a custom connector, sign in with a code sent to your email and press Allow. Claude Code and Codex take one command and Cursor a short config, then the same sign-in; a tool that only takes headers uses a key.

**Do I need a Xiaohongshu account?**

No. No account of yours needed, your accounts stay out of it: no Xiaohongshu login, no cookie, nothing to install. It reads what is publicly visible on Xiaohongshu, and it cannot post.

**How much does it cost?**

From 12 credits a call, about $0.04 at the first pack. A failed call costs nothing, and each call states what it charged. 100 free credits on sign-up, no card.

## Related pages

- [Xiaohongshu (RedNote) API](https://socialtoai.app/platforms/xiaohongshu.md)
- [How do I get my AI to read what Xiaohongshu (RedNote) says about a topic?](https://socialtoai.app/docs/guides/read-xiaohongshu-notes-on-a-topic.md)
- [How do I find Xiaohongshu (RedNote) notes that are taking off with AI?](https://socialtoai.app/docs/guides/find-viral-notes-on-xiaohongshu.md)
- [TikTok MCP Server](https://socialtoai.app/mcp/tiktok.md)
- [Instagram MCP Server](https://socialtoai.app/mcp/instagram.md)
- [X (Twitter) MCP Server](https://socialtoai.app/mcp/x.md)
- [Reddit MCP Server](https://socialtoai.app/mcp/reddit.md)
- [YouTube MCP Server](https://socialtoai.app/mcp/youtube.md)
- [Facebook MCP Server](https://socialtoai.app/mcp/facebook.md)
- [LinkedIn MCP Server](https://socialtoai.app/mcp/linkedin.md)
- [Threads MCP Server](https://socialtoai.app/mcp/threads.md)
- [Telegram MCP Server](https://socialtoai.app/mcp/telegram.md)
- [Pinterest MCP Server](https://socialtoai.app/mcp/pinterest.md)
- [Douyin MCP Server](https://socialtoai.app/mcp/douyin.md)
- [Weibo MCP Server](https://socialtoai.app/mcp/weibo.md)
- [WeChat Articles MCP Server](https://socialtoai.app/mcp/wechat.md)
- [Bilibili MCP Server](https://socialtoai.app/mcp/bilibili.md)
- [Zhihu MCP Server](https://socialtoai.app/mcp/zhihu.md)
- [Kuaishou MCP Server](https://socialtoai.app/mcp/kuaishou.md)
- [WeChat Channels MCP Server](https://socialtoai.app/mcp/wechat-channels.md)
