社媒数据助手 小红书 MCP | Xiaohongshu XHS RedNote MCP

This directory contains an OpenClaw native plugin shim for the hosted 小红书 MCP service by SocialDataX.

The plugin registers namespaced OpenClaw tools and forwards each call to the hosted streamable-http MCP endpoint:

• Endpoint: https://mcp.socialdatax.com/xhs/mcp
• API key environment variable: SOCIALDATAX_API_KEY
• Product: SocialDataX / 社媒数据助手
• Website: https://socialdatax.com
• Package name: xhs-insights-openclaw-plugin
• Version: 0.1.23
• Search terms: Xiaohongshu, XHS, RedNote, 小红书, 小红书搜索建议, 小红书搜索热榜, 小红书商品搜索, 小红书商品评价, search suggestions, search hot list, product search, product reviews, social media research, marketing research, comments, creator profiles

Capabilities

This OpenClaw plugin exposes read-only Xiaohongshu / XHS / RedNote workflows:

• Search notes by keyword with optional sort, note type, publish-time filters, and page_token continuation.
• Search 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 product details from a product link, short link, or share text with xhs-insights__xhs_get_product_detail_by_url, without searching first.
• Fetch product reviews by a complete sku_id supplied by the user or copied from product search results; accepts sort_type: general (comprehensive sort, the default) or time_descending, has_image, and page_token continuation.
• Fetch replies under a first-level product review using a user-provided review_id or one copied from xhs_get_product_reviews; accepts opaque page_token continuation and does not accept root_review_id.
• Fetch the Xiaohongshu / XHS / RedNote search hot list with title and heat value.
• Fetch search suggestions for a keyword or partial phrase.
• Resolve shared note links, short links, or share text into structured details.
• Fetch note details directly when a note ID is already known.
• Fetch note details, first-level comments, and comment replies.
• Read creator profile information.
• Fetch creator note lists for content style and account research.
• Fetch tag page note lists from a topic URL, short link, share text, or page ID.

For XHS outputs with a returned note_url field: When note_url is non-null, preserve the full URL exactly, including xsec_token, such as in final answers or display; do not rebuild links from note_id. If note_url is null, do not synthesize a public link from note_id.

The service does not provide account login, posting, editing, liking, commenting, or other account actions.

Plugin Structure

This package uses the native OpenClaw plugin path:

• openclaw.plugin.json declares the native plugin manifest and tool contracts.
• package.json declares the OpenClaw extension entry and MCP SDK dependency.
• index.js registers thin forwarding tools that call the hosted MCP service.
• Runtime metadata declares the required node binary, SOCIALDATAX_API_KEY, and the hosted MCP service domain.

It intentionally does not include .codex-plugin/ or .mcp.json, because OpenClaw gives openclaw.plugin.json native-plugin precedence when both marker types are present.

API Key

Set the shared API key before using this plugin:

export SOCIALDATAX_API_KEY="<SOCIALDATAX_API_KEY>"

The key is sent as:

Authorization: Bearer ${SOCIALDATAX_API_KEY}

The plugin sends the key only to the fixed endpoint https://mcp.socialdatax.com/xhs/mcp. It does not support overriding the endpoint URL.

Do not commit real API keys to code, docs, issues, or screenshots.

Tool Names

The native plugin registers namespaced tool names that match the earlier MCP server prefix convention. For example, the remote MCP tool xhs_search_notes is exposed as:

xhs-insights__xhs_search_notes

Publishing Check

Use ClawHub dry-run before publishing:

source ~/.nvm/nvm.sh
nvm use 24.13.0
clawhub package publish <public-checkout>/xhs-insights-openclaw \
  --family code-plugin \
  --name xhs-insights-openclaw-plugin \
  --display-name "社媒数据助手 小红书 MCP | Xiaohongshu XHS RedNote MCP" \
  --version 0.1.23 \
  --source-repo <public-owner/public-repo> \
  --source-commit <public-commit-sha> \
  --source-path xhs-insights-openclaw \
  --dry-run \
  --json

Publish from a public GitHub source or pass explicit public --source-repo, --source-commit, and --source-path values. Do not publish from a private source checkout.