# Xiaohongshu (小红书) data for AI agents

> ToolSocket gives Claude, ChatGPT, Cursor, Codex and any MCP or REST client live access to Xiaohongshu (小红书) — notes and creator data from Xiaohongshu (RED), China's lifestyle community — through 43 ready-made tools. No Xiaohongshu account, scraper or API key of your own is needed: connect https://toolsocket.top/mcp once and pay per call (most calls $0.015).

ToolSocket 让 Claude、ChatGPT、Cursor、Codex 等任何支持 MCP 或 REST 的 AI 智能体，直接读取小红书的实时数据：笔记与博主数据，共 43 个工具。不用注册小红书账号、不用写爬虫，接入一个地址即可，按次计费（大多 $0.015/次）。

## Connect

- MCP (Claude.ai, ChatGPT, Claude Code, Cursor, VS Code, Codex): `https://toolsocket.top/mcp` — OAuth sign-in or `Authorization: Bearer ts_live_…`
- Claude Code: `claude mcp add --transport http toolsocket https://toolsocket.top/mcp`
- Any agent that reads skills: `set up https://toolsocket.top/SKILL.md`
- Setup for every client: https://toolsocket.top/docs.md

## Example

Ask your agent: "Summarize what Xiaohongshu creators say about this product." / 「看看小红书博主怎么评价这款产品。」

```bash
curl -s -X POST https://toolsocket.top/v1/run -H "Authorization: Bearer $TOOLSOCKET_API_KEY" \
  -H "content-type: application/json" -d '{"tool":"xiaohongshu#app_v2/get_creator_hot_inspiration_feed","input":{},"wait":30}'
```

## Tools (43)

| Tool | ID | Price | What it does |
|---|---|---|---|
| Xiaohongshu · Fetch note detail (web v3) · 小红书 · 获取笔记详情（web v3） | `xiaohongshu#web_v3/fetch_note_detail` | $0.015 / call | Get note detail (image/video) |
| Xiaohongshu · Fetch search suggestions (web v3) · 小红书 · 获取搜索联想词（web v3） | `xiaohongshu#web_v3/fetch_search_suggest` | $0.015 / call | Get search suggestions, returns popular recommendations when keyword is empty |
| Xiaohongshu · Fetch homepage feed (web v3) · 小红书 · 获取首页推荐（web v3） | `xiaohongshu#web_v3/fetch_homefeed` | $0.015 / call | Get homepage recommended notes |
| Xiaohongshu · Fetch homepage categories (web v3) · 小红书 · 获取首页分类列表（web v3） | `xiaohongshu#web_v3/fetch_homefeed_categories` | $0.015 / call | Get homepage category channels |
| Xiaohongshu · Get image note detail (app v2) · 小红书 · 获取图文笔记详情（app v2） | `xiaohongshu#app_v2/get_image_note_detail` | $0.015 / call | Get full detail data of an image note |
| Xiaohongshu · Get video note detail (app v2) · 小红书 · 获取视频笔记详情（app v2） | `xiaohongshu#app_v2/get_video_note_detail` | $0.015 / call | Get full detail data of a video note |
| Xiaohongshu · Get note comments (app v2) · 小红书 · 获取笔记评论列表（app v2） | `xiaohongshu#app_v2/get_note_comments` | $0.015 / call | Get comment list for a specified note, supports pagination and multiple sort strategies |
| Xiaohongshu · Get note sub comments (app v2) · 小红书 · 获取笔记二级评论列表（app v2） | `xiaohongshu#app_v2/get_note_sub_comments` | $0.015 / call | Get sub-comment (reply) list under a specific comment of a note, using cursor pagination |
| Xiaohongshu · Get user info (app v2) · 小红书 · 获取用户信息（app v2） | `xiaohongshu#app_v2/get_user_info` | $0.015 / call | Get detailed info of a specified user |
| Xiaohongshu · Get user posted notes (app v2) · 小红书 · 获取用户笔记列表（app v2） | `xiaohongshu#app_v2/get_user_posted_notes` | $0.015 / call | Get list of notes posted by a specified user, using cursor pagination |
| Xiaohongshu · Get user faved notes (app v2) · 小红书 · 获取用户收藏笔记列表（app v2） | `xiaohongshu#app_v2/get_user_faved_notes` | $0.015 / call | Get list of notes faved by a specified user, using cursor pagination |
| Xiaohongshu · Search notes (app v2) · 小红书 · 搜索笔记（app v2） | `xiaohongshu#app_v2/search_notes` | $0.015 / call | Search Xiaohongshu notes by keyword, supports multiple sort types, note type filters, and time filters |
| Xiaohongshu · Search users (app v2) · 小红书 · 搜索用户（app v2） | `xiaohongshu#app_v2/search_users` | $0.015 / call | Search Xiaohongshu users by keyword, returns 20 results per page, supports pagination |
| Xiaohongshu · Search images (app v2) · 小红书 · 搜索图片（app v2） | `xiaohongshu#app_v2/search_images` | $0.015 / call | Search Xiaohongshu images by keyword, returns 20 results per page, supports pagination |
| Xiaohongshu · Search products (app v2) · 小红书 · 搜索商品（app v2） | `xiaohongshu#app_v2/search_products` | $0.015 / call | Search Xiaohongshu products by keyword, returns 20 results per page, supports pagination |
| Xiaohongshu · Search groups (app v2) · 小红书 · 搜索群聊（app v2） | `xiaohongshu#app_v2/search_groups` | $0.015 / call | Search Xiaohongshu groups by keyword, supports pagination |
| Xiaohongshu · Get product detail (app v2) · 小红书 · 获取商品详情（app v2） | `xiaohongshu#app_v2/get_product_detail` | $0.015 / call | Get product detail by SKU ID, including price, specifications, stock, description, etc. |
| Xiaohongshu · Get product review overview (app v2) · 小红书 · 获取商品评论总览（app v2） | `xiaohongshu#app_v2/get_product_review_overview` | $0.015 / call | Get product review statistics, including rating distribution, positive rate, review tags, etc. |
| Xiaohongshu · Get product reviews (app v2) · 小红书 · 获取商品评论列表（app v2） | `xiaohongshu#app_v2/get_product_reviews` | $0.015 / call | Get product user reviews list, supports pagination, sorting, and filtering reviews with images |
| Xiaohongshu · Get product recommendations (app v2) · 小红书 · 获取商品推荐列表（app v2） | `xiaohongshu#app_v2/get_product_recommendations` | $0.015 / call | Get recommended products list by SKU ID, using cursor pagination |
| Xiaohongshu · Get topic info (app v2) · 小红书 · 获取话题详情（app v2） | `xiaohongshu#app_v2/get_topic_info` | $0.015 / call | Get topic detail info, including topic name, view count, discussion count, share info, etc. |
| Xiaohongshu · Get topic feed (app v2) · 小红书 · 获取话题笔记列表（app v2） | `xiaohongshu#app_v2/get_topic_feed` | $0.015 / call | Get notes list under a specified topic, supports sorting by trending or latest, using cursor pagination |
| Xiaohongshu · Get creator inspiration feed (app v2) · 小红书 · 获取创作者推荐灵感列表（app v2） | `xiaohongshu#app_v2/get_creator_inspiration_feed` | $0.015 / call | Get creator center recommended inspiration feed, using cursor pagination |
| Xiaohongshu · Get creator hot inspiration feed (app v2) · 小红书 · 获取创作者热点灵感列表（app v2） | `xiaohongshu#app_v2/get_creator_hot_inspiration_feed` | $0.015 / call | Get creator center hot inspiration feed, using cursor pagination |
| Xiaohongshu · Get PGY note detail (pgy) · 小红书 · 获取蒲公英笔记详情（pgy） | `xiaohongshu#pgy/get_note_detail` | $0.03 / call | Get detail data of a single PGY (Pugongying) note |
| Xiaohongshu · Get PGY note featured comments (pgy) · 小红书 · 获取蒲公英笔记精选评论（pgy） | `xiaohongshu#pgy/get_note_comments` | $0.015 / call | Get the featured comments of a single note, including the blogger's own replies |
| Xiaohongshu · Get PGY note components (pgy) · 小红书 · 获取蒲公英笔记组件（pgy） | `xiaohongshu#pgy/get_note_components` | Free | Get the components attached to a single note (content search / comment-area / bottom) |
| Xiaohongshu · Get PGY blogger detail (pgy) · 小红书 · 获取蒲公英博主详情（pgy） | `xiaohongshu#pgy/get_blogger_detail` | $0.03 / call | Get full profile of a single blogger (PGY blogger homepage header) |
| Xiaohongshu · Get PGY blogger note cases (pgy) · 小红书 · 获取蒲公英博主笔记案例（pgy） | `xiaohongshu#pgy/get_blogger_notes` | $0.03 / call | Paginated note list of a blogger ("Note Data → Note Cases" on the PGY blogger page) |
| Xiaohongshu · Get PGY blogger note cases v2 (cross-platform) (pgy) · 小红书 · 获取蒲公英博主笔记案例 v2（覆盖跨域）（pgy） | `xiaohongshu#pgy/get_blogger_notes_v2` | $0.03 / call | Paginated note cases of a blogger (v2). A **separate endpoint** from /get_blogger_notes: |
| Xiaohongshu · Get PGY blogger performance metrics (pgy) · 小红书 · 获取蒲公英博主数据表现（pgy） | `xiaohongshu#pgy/get_blogger_notes_rate` | $0.03 / call | Overall content performance of a blogger, for judging quality and consistency |
| Xiaohongshu · Get PGY blogger core data trend (pgy) · 小红书 · 获取蒲公英博主核心数据（pgy） | `xiaohongshu#pgy/get_blogger_core_data` | $0.03 / call | Daily trend and period summary of a blogger, for plotting performance charts |
| Xiaohongshu · Get PGY blogger data summary (pgy) · 小红书 · 获取蒲公英博主数据概览（pgy） | `xiaohongshu#pgy/get_blogger_data_summary` | $0.03 / call | Account-level data summary of a blogger |
| Xiaohongshu · Get PGY blogger fans summary (pgy) · 小红书 · 获取蒲公英博主粉丝概览（pgy） | `xiaohongshu#pgy/get_blogger_fans_summary` | $0.03 / call | Core fans metrics of a blogger ("Fans Analysis → Core Metrics") |
| Xiaohongshu · Get PGY blogger fans profile (pgy) · 小红书 · 获取蒲公英博主粉丝画像（pgy） | `xiaohongshu#pgy/get_blogger_fans_profile` | $0.03 / call | Audience distribution of a blogger's fans, to check fit with the target audience |
| Xiaohongshu · Get PGY blogger fans growth history (pgy) · 小红书 · 获取蒲公英博主粉丝增长历史（pgy） | `xiaohongshu#pgy/get_blogger_fans_history` | $0.03 / call | Fans growth curve over time ("Fans Analysis → Fans Trend") |
| Xiaohongshu · Get PGY similar bloggers (pgy) · 小红书 · 获取蒲公英相似博主推荐（pgy） | `xiaohongshu#pgy/get_blogger_similar` | $0.03 / call | Given one blogger, return similar bloggers ("Similar Bloggers" on the blogger page) |
| Xiaohongshu · PGY note blogger square (pgy) · 小红书 · 蒲公英笔记博主广场（找博主/选号）（pgy） | `xiaohongshu#pgy/get_blogger_list` | $0.03 / call | Full replica of PGY "Find Bloggers → Note Blogger Square"; ~60 filters grouped into 7 objects |
| Xiaohongshu · Get PGY blogger filter options (pgy) · 小红书 · 获取蒲公英找博主筛选项字典（pgy） | `xiaohongshu#pgy/get_blogger_filter_options` | $0.03 / call | Fetch selectable values for the **tree-style filters** used by /get_blogger_list |
| Xiaohongshu · PGY live blogger square (pgy) · 小红书 · 蒲公英直播博主广场（直播带货选号）（pgy） | `xiaohongshu#pgy/get_live_blogger_list` | $0.03 / call | Replica of PGY "Find Bloggers → Live Blogger Square"; filter live-commerce bloggers by |
| Xiaohongshu · PGY keyword overview (pgy) · 小红书 · 蒲公英关键词概览（搜索指数+博主画像）（pgy） | `xiaohongshu#pgy/get_keyword_stat` | $0.03 / call | Site-wide popularity overview of a keyword, plus the profile of bloggers posting about it |
| Xiaohongshu · PGY keyword daily trend (pgy) · 小红书 · 蒲公英关键词逐日搜索指数（pgy） | `xiaohongshu#pgy/get_keyword_daily` | $0.03 / call | Daily search trend of a keyword — tells whether it is rising, fading, or seasonal |
| Xiaohongshu · PGY related keywords (pgy) · 小红书 · 蒲公英关键词关联词（选题扩词）（pgy） | `xiaohongshu#pgy/get_keyword_related` | $0.03 / call | What users search **before** and **after** this keyword ("Related Inspiration" card) |
