SocialDataX 小红书 Xiaohongshu XHS RedNote MCP

할 수 있는 일

이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.

• 연결 방식: 클라우드에서 실행
• 전송 방식: Streamable HTTP
• 카테고리: 검색 및 AI 기억
• 입력해야 할 값: Authorization

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

필요한 것

• 클라우드에서 실행설치할 것 없음. 인터넷으로 연결돼요

어떤 앱을 쓰세요?

claude mcp add --transport http xhs-insights https://mcp.socialdatax.com/xhs/mcp --header 'Authorization: your-value'

{
  "mcpServers": {
    "xhs-insights": {
      "url": "https://mcp.socialdatax.com/xhs/mcp",
      "headers": {
        "Authorization": "your-value"
      }
    }
  }
}

{
  "servers": {
    "xhs-insights": {
      "type": "http",
      "url": "https://mcp.socialdatax.com/xhs/mcp",
      "headers": {
        "Authorization": "your-value"
      }
    }
  }
}

선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.

직접 입력할 값

• Authorization 비밀 필수 HTTP header
  Bearer API Key from SocialDataX / 社媒数据助手

이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.

할 수 있는 일

도구 이름과 설명은 서버가 2026년 11월 8일에 알려 준 그대로예요. 우리가 아니라 제작자가 쓴 글이고, 일반 텍스트로만 보여 드려요.

• xhs_get_note_detail_by_note_url

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

• xhs_get_note_detail_by_note_id

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

• xhs_search_notes

  搜索小红书 / 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 工具

• xhs_search_images

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

• xhs_search_users

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

• xhs_search_products

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

• xhs_get_product_detail_by_sku_id

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

• xhs_get_product_detail_by_url

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

• xhs_pgy_get_note_detail_by_note_id

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

• xhs_pgy_get_note_detail_by_note_url

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

• xhs_pgy_get_creator_profile

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

• xhs_pgy_get_creator_notes_performance

  根据完整 user_id 获取小红书蒲公英创作者笔记表现，包括笔记数量、曝光/阅读/互动中位数、互动率、视频完播率、图文 3 秒阅读率、内容标签和笔记明细。 查询日常或合作笔记表现及最近明细时使用；商业汇总与成本参考使用商业概览工具，资料和报价使用创作者档案工具。 视频完播相关字段仅在 video_note_count 大于 0 时用于表现判断；图文 3 秒阅读率仅在统计范围内有图文笔记时用于表现判断；其他情况下 0 值不表示对应表现为 0%。 固定近30日、图文＋视频、全流量，不支持自选日期或笔记类型；明细最多 15 篇，不是全量列表。仅 notes[

• xhs_pgy_get_creator_fans_profile

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

• xhs_pgy_get_creator_fans_summary

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

• xhs_pgy_get_creator_commercial_overview

  根据完整 user_id 获取小红书蒲公英创作者商业概览：笔记规模和中位数、服务表现、平台标签、增长、预估成本及对比值。 查询指定日常/合作口径的商业汇总与成本参考时使用，不返回逐篇明细。逐篇表现使用创作者笔记表现工具，也可选择日常或合作口径。资料与报价使用创作者档案工具，粉丝构成使用粉丝画像工具。 查看日常内容表现选 daily（默认，不是按天汇总）；查看商单、品牌合作笔记或外溢进店的汇总表现选 cooperation。输出回显口径，不能混用；不是对全部字段统一筛选，note_count 不能解释为所选口径的笔记数。两种口径的成本估计依据不同，均不代表

• xhs_pgy_get_creator_metrics_trend

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

• xhs_get_product_reviews

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

• xhs_get_product_review_replies

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

• xhs_get_product_review_reply_replies

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

• xhs_get_search_hot_list

  获取小红书搜索热榜。

• xhs_search_suggestions

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

• xhs_submit_video_speech_text_by_note_url

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

• xhs_submit_video_speech_text_by_note_id

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

• xhs_get_video_speech_text_job

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

• xhs_get_note_comments_by_note_id

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

• xhs_get_note_comments_by_note_url

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

• xhs_get_note_sub_comments_by_comment_id

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

• xhs_get_user_id_by_encrypted_user_id

  根据完整加密用户 ID 获取稳定 user_id。 仅需单独转换 ID 时使用；查询用户信息或作品可直接使用已有用户 ID 或主页链接，无需先调用本工具。

• xhs_get_share_info

  根据小红书笔记分享短链接或完整分享文案获取分享人、笔记摘要及作者。 需要笔记完整内容时，使用笔记详情工具；分享信息不包含分享时间。

• xhs_get_note_share_link_by_note_id

  根据小红书笔记 ID 获取完整分享内容和分享短链接。已有笔记链接时使用按链接获取分享链接工具。

• xhs_get_note_share_link_by_note_url

  根据小红书笔记链接、短链接或分享文案获取完整分享内容和分享短链接。已有 note_id 时使用按 ID 获取分享链接工具。

• xhs_get_user_info_by_user_id

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

• xhs_get_user_info_by_profile_url

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

• xhs_get_user_posted_notes_by_user_id

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

• xhs_get_user_posted_notes_by_profile_url

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

• xhs_get_topic_notes_by_topic_url

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

• xhs_get_topic_notes_by_page_id

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

• socialdatax_get_points_balance

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

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 8일 점검

• ! 주의

  제작자와 저장소 일치

  레지스트리에 소스 저장소가 없어서, 게시자(52choujiang.com)와 코드를 맞춰 볼 수 없어요

• … 아직 점검 안 함

  계속 관리되고 있음

  아직 GitHub에서 이 저장소를 읽어 오지 않았어요

• … 아직 점검 안 함

  라이선스 있음

  아직 GitHub에서 이 저장소를 읽어 오지 않았어요

• ✓ 통과

  엔드포인트 응답

  1208ms 만에 응답(HTTP 200)

• – 해당 없음

  OAuth로 로그인

  로그인 필요 없음

• ✓ 통과

  도구 설명에 숨겨진 지시 없음

  도구 설명 38개를 읽었고, AI에게 보내는 숨겨진 지시는 없었어요

검색 및 AI 기억 카테고리의 다른 서버와 비교i

• 이 카테고리의 다른 서버 5688개 중 0%보다 스타가 많아요
• 이 카테고리의 다른 서버 5688개 중 61%보다 최근에 레지스트리에 공개됐어요
• 기본 점검 결과가 이 카테고리의 다른 서버 5688개 중 39%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

대안

같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.

카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

제작자의 README

저장소에서 README를 찾지 못했어요