Advertise
MCP.so
Sign In
S

SocialDataX 小红书 Xiaohongshu XHS RedNote MCP Server

@DevinChen2014

RepositoryHomepageDocumentation

Basic information

Category

AI & Agents

Transports

stdio

Author

DevinChen2014

Submitted by

DevinChen2014

About SocialDataX 小红书 Xiaohongshu XHS RedNote MCP Server

A read-only Xiaohongshu MCP server for AI workflows, with note search, note detail retrieval, and first-level comment analysis for competitor research, audience insight, and topic discovery.

#xiaohongshu#social-media#social-insights#competitor-research#comment-analysis#topic-discovery#marketing-research

SocialDataX 小红书 Xiaohongshu XHS RedNote MCP Server config

Add this server to your MCP-compatible client using the configuration below.

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

SocialDataX 小红书 Xiaohongshu XHS RedNote MCP Server tools

35

根据笔记链接、短链接或分享文案获取单篇小红书笔记详情。 返回的 note_url 在任何使用场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得用 note_id 重新拼接链接；note_url 为 null 时不要用 note_id 合成公开链接。

根据 note_id 获取单篇小红书笔记详情。 返回的 note_url 非 null 时，在任何使用场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得用 note_id 重新拼接链接；note_url 为 null 时不要用 note_id 合成公开链接。

搜索小红书 / Xiaohongshu / XHS / RedNote 笔记，包含普通、图文和视频笔记；note_type 默认 "all"。查找图文笔记可设 note_type="image"，查找视频笔记可设 note_type="video"。发布时间筛选参数名为 publish_time_range（不是 publish_time）；本工具不接受 max_items。查找单张图片用 xhs_search_images；已有笔记链接或 note_id 且需要单篇笔记详情时使用对应的详情工具；需要评论、回复或口播转文字时使用相应的 URL/ID 工具；支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容。 返回的 note_url 在任何使用场景都必须原样保留完整 URL，包括 xsec_token 等 query 参数；例如最终回答、展示、引用、存储、输出或传递；不得用 note_id 重新拼接链接。

按搜索词搜索小红书图片；已有笔记链接或 note_id，且需要读取该篇笔记详情时，使用对应详情工具。每项为一张图片及关联笔记，同一笔记可返回多张图片；page_token 可用于尝试下一页，不保证下一页有结果；结果按平台相关性排序，不承诺每条内容包含原词，不承诺完整召回；需要图文笔记而非单张图片时使用 xhs_search_notes(note_type="image")；需要视频笔记时使用 xhs_search_notes(note_type="video")。

按搜索词搜索小红书用户、账号或博主，支持分页；已有用户 ID 或主页链接时，使用用户资料工具。

搜索小红书商品。用户需要按搜索词查找商品时使用；已有完整 sku_id（包括用户直接提供）时使用商品详情或商品评价工具，已有商品链接或分享文案时使用 xhs_get_product_detail_by_url；支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容。

根据小红书商品 sku_id 获取商品详情；已有该 ID 时直接使用，否则可从 xhs_search_products 获取。只有商品链接、短链接或分享文案时使用 xhs_get_product_detail_by_url；本工具不支持商品链接、spu_id 或搜索词。

根据小红书商品链接、短链接或分享文案获取商品详情，无需先搜索。已有完整 sku_id 时使用 xhs_get_product_detail_by_sku_id；返回的 sku_id 可继续用于商品评价工具。

根据 note_id 获取小红书蒲公英单篇笔记商业增强详情，包括正文、图片或视频摘要、作者、曝光量、阅读量、点赞、收藏、评论、分享和创作者图文/视频合作报价（单位：人民币元；不是当前笔记的成交金额；零值不表示免费合作）。 仅适用于已入驻蒲公英博主的笔记；用户明确要求蒲公英商业数据时使用，普通笔记详情使用普通详情工具。 用户只提曝光量、阅读量或报价且上下文未明确蒲公英口径时，先澄清商业口径和成功 20 积分的费用；上下文已明确时不重复确认。 这是蒲公英商业口径数据，不等同普通公开笔记详情；成功调用扣减 20 积分，失败不扣费。 查询明确无商业数据时按博主未入驻蒲公英处理，返回 pgy_commercial_data_unavailable，不换 ID/链接入口重试；超时、鉴权和余额不足等错误不表示未入驻。

根据笔记链接、短链接或分享文案获取小红书蒲公英单篇笔记商业增强详情，包括曝光量、阅读量、点赞、收藏、评论、分享和创作者图文/视频合作报价（单位：人民币元；不是当前笔记的成交金额；零值不表示免费合作）。 仅适用于已入驻蒲公英博主的笔记；用户明确要求蒲公英商业数据时使用，普通笔记详情使用普通详情工具。 用户只提曝光量、阅读量或报价且上下文未明确蒲公英口径时，先澄清商业口径和成功 20 积分的费用；上下文已明确时不重复确认。 这是蒲公英商业口径数据，不等同普通公开笔记详情；成功调用扣减 20 积分，失败不扣费。 查询明确无商业数据时按博主未入驻蒲公英处理，返回 pgy_commercial_data_unavailable，不换 ID/链接入口重试；超时、鉴权和余额不足等错误不表示未入驻。

根据完整 user_id 获取小红书蒲公英创作者档案、粉丝和商业笔记规模、合作行业、笔记阅读与互动中位数、内容分类、特征标签和创作者图文/视频合作报价。 查询蒲公英创作者资料和报价时使用；普通账号资料使用用户信息工具。 笔记表现使用创作者笔记表现工具；粉丝画像使用创作者粉丝画像工具；指标随日期变化使用创作者指标趋势工具。图文和视频报价单位为人民币元；零值不表示免费合作。 成功返回档案字段和 points；成功调用扣减 20 积分，失败不扣费。

根据完整 user_id 获取小红书蒲公英创作者笔记表现，包括笔记数量、曝光/阅读/互动中位数、互动率、视频完播率、图文 3 秒阅读率、内容标签和笔记明细。 查询日常或合作笔记表现及最近明细时使用；商业汇总与成本参考使用商业概览工具，资料和报价使用创作者档案工具。 视频完播相关字段仅在 video_note_count 大于 0 时用于表现判断；图文 3 秒阅读率仅在统计范围内有图文笔记时用于表现判断；其他情况下 0 值不表示对应表现为 0%。 固定近30日、图文＋视频、全流量，不支持自选日期或笔记类型；明细最多 15 篇，不是全量列表。仅 notes[] 内的 *_benchmark_rate 是相较于平台中位数的相对差异，允许负数和超过 1，不能当作排名比例；汇总层同名字段仍是平台返回的 0 到 1 对比值，计算方式未公开，不能混用。 成功返回表现字段和 points；成功调用扣减 20 积分，失败不扣费。

根据完整 user_id 获取小红书蒲公英创作者粉丝画像，包括年龄、性别、地域、城市、兴趣和设备品牌分布及数据日期。 查询粉丝构成时使用；粉丝规模、增长、活跃、阅读和互动情况使用创作者粉丝汇总工具；创作者资料和报价使用创作者档案工具。 使用平台默认统计范围，不支持指定日期；分布不保证完整，不能据此推算粉丝人数或补齐其他类别。 成功返回画像字段和 points；成功调用扣减 20 积分，失败不扣费。

根据完整 user_id 获取小红书蒲公英创作者粉丝总数、平台增长指标、活跃、阅读和互动粉丝人数及占比。 查询粉丝规模和活跃情况时使用；年龄、性别、地域和兴趣等构成使用创作者粉丝画像工具。 不支持指定日期或统计周期；增长周期及各统计窗口截止日期未提供，不能按查询日期推算，不承诺指定期间增长数据。 成功直接返回汇总字段和 points；成功调用扣减 20 积分，失败不扣费。

根据完整 user_id 获取小红书蒲公英创作者商业概览：笔记规模和中位数、服务表现、平台标签、增长、预估成本及对比值。 查询指定日常/合作口径的商业汇总与成本参考时使用，不返回逐篇明细。逐篇表现使用创作者笔记表现工具，也可选择日常或合作口径。资料与报价使用创作者档案工具，粉丝构成使用粉丝画像工具。 查看日常内容表现选 daily（默认，不是按天汇总）；查看商单、品牌合作笔记或外溢进店的汇总表现选 cooperation。输出回显口径，不能混用；不是对全部字段统一筛选，note_count 不能解释为所选口径的笔记数。两种口径的成本估计依据不同，均不代表实际成交成本或ROI。 不支持指定日期，统计截止日期未提供；进店不等于订单或成交，不据此推断调用方自己的投放成绩。 成功直接返回业务字段和 points；成功调用扣减 20 积分，失败不扣费。

根据完整 user_id 获取小红书蒲公英创作者曝光、阅读、互动中位数及预估成本的日期趋势和概览。 观察指标随时间变化时使用；中位数按 note_scope 选择日常或合作笔记，固定图文＋视频、近30日、全流量，不支持自选日期。合作口径包含进店指标，日常口径的进店字段为 null；输出回显口径，不能混用。 返回指标不是每日新增量或累计总量，不可跨日期求和；可能缺少日期，不补零。 成本估算口径见字段说明，不代表实际成交成本；按图文/视频拆分的成本及商业汇总使用商业概览工具，逐篇表现使用笔记表现工具。 成功直接返回业务字段和 points；成功调用扣减 20 积分，失败不扣费。

根据小红书商品 sku_id 获取商品评价；已有该 ID 时直接使用，否则可从 xhs_search_products 获取；支持 sort_type、has_image 和 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容；不支持商品链接、spu_id 或搜索词。

根据一级商品评价 review_id 获取其下回复；已有该 ID 时直接使用，否则可从 xhs_get_product_reviews 获取；支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容；不接受 root_review_id。

根据商品评价回复 review_id 获取其下的嵌套回复；已有该 ID 时直接使用，否则可从 xhs_get_product_review_replies 获取；支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回，不得截断、缩写、掩码或用省略号替换中间内容；不接受 root_review_id。

获取小红书搜索热榜。

根据搜索词获取小红书候选搜索建议，用于补全搜索词；需要实际搜索笔记或商品时，分别使用 xhs_search_notes 或 xhs_search_products。

根据小红书视频笔记链接、短链接或分享文案提交口播转文字任务；提交后最多等待 240 秒，未完成时返回 job_id 和下一步查询动作。

根据小红书 note_id 提交视频笔记口播转文字任务；提交后最多等待 240 秒，未完成时返回 job_id 和下一步查询动作。

根据用户提供的有效 job_id，或提交工具返回的 job_id 查询任务状态；用于继续未完成任务，每次最多等待 240 秒，不触发重处理，也不要重复提交任务。

根据 note_id 获取单篇小红书笔记的一级评论，支持 sort_type 评论排序和 page_token 翻页。

根据笔记链接、短链接或分享文案获取单篇小红书笔记的一级评论，支持 sort_type 评论排序和 page_token 翻页。

根据 note_id 和一级评论 comment_id 获取二级评论；用户已提供完整合法的 ID 组合时直接使用；已有 note_id 或笔记链接但缺少必需 ID 时，调用对应一级评论工具补全；缺少笔记定位信息时向用户索取；支持 page_token 翻页。

根据完整加密用户 ID 获取稳定 user_id。

根据 user_id 获取单个小红书用户信息。

根据主页链接、短链接或分享文案获取单个小红书用户信息。

根据 user_id 获取用户已发布笔记列表，支持 page_token 翻页。

根据主页链接、短链接或分享文案获取用户已发布笔记列表，支持 page_token 翻页。

根据话题页链接、短链接或分享文案获取标签页笔记列表，支持 sort_type 排序和 page_token 翻页。

根据 page_id 获取标签页笔记列表，支持 sort_type 排序和 page_token 翻页。

查询当前 API Key 账户的 SocialDataX 积分余额、剩余积分或点数 / remaining points balance。需要充值时请访问 https://socialdatax.com/dashboard/billing。

Overview

SocialDataX 托管的小红书 MCP 服务，提供 35 个工具，支持笔记（含视频、图文）与用户搜索、笔记和用户详情、评论、蒲公英数据、商品、口播转文字及积分查询。

Comments

More AI & Agents MCP servers

localscreenshot - website screenshot mcp for ai agents

localscreenshot is a Website screenshot MCP server and API available at https://localscreenshot.com/api. Localscreenshot screenshot api turns any public web page into an image or a PDF. Take the capture from one of 227 c

SlopIt

SimbaStack

Instant blogs for AI agents: a publishing CMS with no dashboard. One signup call returns a blog, an API key and a live URL; then publish markdown posts and get public URLs back.

CrawlForge MCP Server

mysleekdesigns

28-tool MCP server for web scraping, crawling, deep research & autonomous extraction — clean Markdown & structured JSON for Claude, Cursor & any MCP client. 1,000 free one-time credits, local-Ollama LLM support.

2

scvd.store

seancrecord

scvd.store is an evidence observatory for agentic commerce. Independent signed observation of what other people's endpoints, artifacts and payments actually did among other things. USDC on Base, Arbitrum One, World Chain

2

Transform MCP

Unstructured

The Unstructured Transform MCP Server connects your ADK agent to Unstructured, a document processing platform that turns raw files into structured, AI-ready data. This integration gives your agent the ability to parse PD

Advertise