小红书 MCP | Xiaohongshu MCP | XHS MCP | RedNote MCP

This public repository provides public connection docs and MCP metadata for a hosted 小红书 MCP / Xiaohongshu MCP / XHS MCP / RedNote MCP service.

If you are looking for a 小红书 MCP, Xiaohongshu MCP, XHS MCP, or RedNote MCP for social media research workflows, this repository includes:

• public MCP metadata and client configuration examples
• the hosted `streamable-http` endpoint for clients that support remote MCP
• an `mcp-remote` fallback example for command/stdio-only MCP clients

The business implementation is privately hosted. This repository exposes only the public connection surface for social media content intelligence workflows.

Search Aliases

Common search phrases for this MCP service:

• `小红书 MCP`
• `小红书 数据 MCP`
• `小红书 搜索 MCP`
• `小红书 XHS MCP`
• `Xiaohongshu MCP`
• `Xiaohongshu data MCP`
• `XHS MCP`
• `XHS data MCP`
• `RedNote MCP`
• `RedNote data MCP`
• `Xiaohongshu note search MCP`

Service

• Hosted MCP endpoint: `https://mcp.socialdatax.com/xhs/mcp`
• Hosted transport: `streamable-http`
• Authentication: `Authorization: Bearer `
• Product: `SocialDataX` / `社媒数据助手`
• Website and API Key access:
• Registry name: `com.52choujiang/xhs-insights`
• Future registry name: `com.socialdatax/xhs-insights`
• Current public capability version: `0.1.11`. The hosted production `tools/list`, server card, and public GitHub repository are synchronized at `0.1.11` with all 24 tracked tools. The npm stdio bridge is published as `xiaohongshu-xhs-rednote-mcp@0.1.11` and connects to the same hosted surface. The official Registry latest remains `0.1.10` pending publication of `0.1.11`. Version `0.1.11` renames the public XHS product search/detail shop fields from `seller_*` to `shop_*`.

Platform MCP

Use the hosted `streamable-http` endpoint directly from clients that support authenticated remote MCP. For clients that only support command/stdio MCP servers, use `mcp-remote` as a local compatibility proxy.

npm stdio bridge

Requires Node.js 20.18.1 or later.

Command/stdio-only MCP clients can install and start the bridge directly from npm:

{
  "mcpServers": {
    "socialdatax-xhs": {
      "command": "npx",
      "args": ["-y", "xiaohongshu-xhs-rednote-mcp"],
      "env": {
        "SOCIALDATAX_API_KEY": ""
      }
    }
  }
}

The package only forwards local stdio MCP messages to the hosted SocialDataX XHS endpoint. It does not contain the private service implementation or store the API Key.

Workflow Scope

This MCP service is designed for social media content intelligence workflows. It does not provide account login, posting, editing, liking, commenting, or other account actions.

Supported workflows include:

• Query the current API Key account's SocialDataX points balance / 积分余额、剩余积分或点数.
• Search related Xiaohongshu notes by keyword, with optional sort, note type, and publish-time filters.
• Search Xiaohongshu products by keyword with page_token continuation.
• Fetch product details by a complete sku_id supplied by the user or copied from product search results.
• Fetch one PGY / 蒲公英 enhanced note detail from either a complete note_id or a note link, short link, or share text; successful calls cost 20 points and failures are not charged.
• Fetch product reviews by a complete sku_id supplied by the user or copied from product search results.
• Read the Xiaohongshu search hot list with title and heat value.
• Read Xiaohongshu search suggestions for a keyword or partial phrase.
• Resolve a shared note link, short link, or share text into structured note details.
• Read note details when the caller already has a note ID.
• Fetch paginated first-level comments for comment analysis.
• Fetch paginated replies under a first-level comment.
• Read creator profile data from a profile link, short link, share text, or user ID.
• Fetch paginated creator note lists from a user ID, profile link, short link, or share text for content style and account research.
• Fetch paginated tag page note lists from a topic URL, short link, share text, or page ID.
• Submit a video note speech-to-text transcript task; the submit call may wait up to 240 seconds, and unfinished jobs should continue polling the same `job_id` until terminal.

Tools

Quick Start

For clients that support authenticated `streamable-http`, use the hosted endpoint directly:

{
  "mcpServers": {
    "socialdatax-xhs": {
      "type": "streamable_http",
      "url": "https://mcp.socialdatax.com/xhs/mcp",
      "headers": {
        "Authorization": "Bearer "
      }
    }
  }
}

A ready-to-copy example is available in `examples/streamable_http_config.json`.

For command/stdio-only MCP clients, use `mcp-remote`:

{
  "mcpServers": {
    "socialdatax-xhs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.socialdatax.com/xhs/mcp",
        "--header",
        "Authorization: Bearer ${SOCIALDATAX_API_KEY}"
      ],
      "env": {
        "SOCIALDATAX_API_KEY": ""
      }
    }
  }
}

Claude Code can use remote HTTP directly:

claude mcp add --transport http socialdatax-xhs https://mcp.socialdatax.com/xhs/mcp --header 'Authorization: Bearer ${SOCIALDATAX_API_KEY}'

Persist `SOCIALDATAX_API_KEY` in the runtime environment or client Secret before restarting Claude Code.

Claude Desktop should use its remote MCP / Connectors UI when available. If a local configuration file in your version only supports command/stdio servers, use the `mcp-remote` fallback.

Client Examples

Configuration examples are available in examples:

• Command/stdio fallback config
• Claude Desktop fallback config
• Cursor remote HTTP config
• Codex remote HTTP config
• Direct streamable HTTP config

API Key

Request or manage API access from the product website:

Use the key as a Bearer token in the `Authorization` request header. Do not commit real API Key values to code, docs, issues, or screenshots.

Directory Metadata

Public metadata files in this repository:

• server-card.json: directory-oriented metadata for the hosted service. Official MCP Registry publishing uses the private source repo's `registry/xhs/server.json` for the current `com.52choujiang/xhs-insights` entry.
• mcp.json: generic command/stdio fallback config using `mcp-remote`.
• glama.json: Glama repository ownership metadata.
• SUBMISSION_CHECKLIST.md: checklist for MCP directory submissions.

License

The files in this public repository are released under the MIT License. The license covers the public documentation and configuration examples in this repository only. It does not cover the managed service implementation, hosted infrastructure, or any private backend code outside this repository.