It reads notes, products, reviews, comments, creators, topic pages and transcripts, and stops there: no login, no posting, no liking, no commenting. That makes it a calmer thing to hand an agent than a tool that could act in your name. Two mechanics decide whether it behaves in practice: pagination works only when next_page_token goes back untouched, and returned note URLs must be forwarded exactly as received, since the xsec_token is part of what makes them resolve. The PGY calls are the ones with a price on them — 20 points on success, nothing on failure — so watch the balance while exploring.
A hosted MCP service for Xiaohongshu (小红书 / RedNote) content research, reached at https://mcp.socialdatax.com/xhs/mcp. The surface is reading only: notes, products, reviews, comments, creator profiles, topic pages, the search hot list and video transcripts, with no login, posting, liking or commenting anywhere in it. This repository carries the connection docs and metadata; the implementation is hosted.
- xhs_search_notes searches by keyword with sort, note type and publish-time filters, continuing through pages by passing next_page_token back unchanged
- Note details from either end: xhs_get_note_detail_by_note_id when you already have the ID, xhs_get_note_detail_by_note_url when all you have is a link, a short link or pasted share text
- Comments the same way — xhs_get_note_comments_by_note_id and xhs_get_note_comments_by_note_url, sorted default, time_descending or like_count_descending — with xhs_get_note_sub_comments_by_comment_id for the replies underneath
- Products: xhs_search_products by name, brand or category, then xhs_get_product_detail and xhs_get_product_reviews by sku_id, and xhs_get_product_review_replies under a review
- Creator research: xhs_get_user_info_by_user_id or by profile URL, with xhs_get_user_posted_notes_by_user_id and by profile URL for what they have published
- Topic pages through xhs_get_topic_notes_by_topic_url or xhs_get_topic_notes_by_page_id, sorted hot or time_descending
- xhs_get_search_hot_list returns the hot list with each item's heat value, and xhs_search_suggestions returns suggestions for a partial phrase along with their search target
- The PGY / 蒲公英 pair — xhs_pgy_get_note_detail_by_note_id and xhs_pgy_get_note_detail_by_note_url — returns commercial data rather than ordinary public detail: exposure, reads, engagement counts and image or video pricing. A successful call costs 20 points and a failure costs nothing
- Video notes can be transcribed: submit with xhs_submit_video_speech_text_by_note_url or by note ID, then poll xhs_get_video_speech_text_job with the job_id it returned — each poll waits up to 240 seconds
- socialdatax_get_points_balance reports what is left on the key
The endpoint is https://mcp.socialdatax.com/xhs/mcp over streamable HTTP with Authorization: Bearer <SOCIALDATAX_API_KEY>, and keys come from socialdatax.com. Clients that speak only stdio reach it through mcp-remote carrying the same header. Usage is metered in points, with the PGY note detail at 20 points per successful call. A returned note_url has to be passed on exactly as given, xsec_token included — a link rebuilt from note_id will not resolve. The files in this repository are MIT; that does not extend to the hosted service.
One command plus a key — claude mcp add --transport http socialdatax-xhs https://mcp.socialdatax.com/xhs/mcp --header 'Authorization: Bearer ${SOCIALDATAX_API_KEY}', then supply credentials