Skip to content

SocialDataX 小红书 Xiaohongshu XHS RedNote MCP

by 52choujiang.com · remote · no sign-in to list tools · v0.1.15 · published by com.52choujiang

XHS search/details, PGY, comments/replies, users/ID resolution/posts, transcript

Changes · 2

36 tools: 2 change things and 34 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

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

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

36 tools

Changes things 2Claude Code: ask
  • xhs_submit_video_speech_text_by_note_id根据小红书 note_id 提交视频笔记口播转文字任务;提交后最多等待 240 秒,未完成时返回 job_id 和下一步查询动作。No findings

    Why it is in this group

    • The name "xhs_submit_video_speech_text_by_note_id" says "submit": a word for a change.
    Description, as the server wrote it
    根据小红书 note_id 提交视频笔记口播转文字任务;提交后最多等待 240 秒,未完成时返回 job_id 和下一步查询动作。

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
  • xhs_submit_video_speech_text_by_note_url根据小红书视频笔记链接、短链接或分享文案提交口播转文字任务;提交后最多等待 240 秒,未完成时返回 job_id 和下一步查询动作。No findings

    Why it is in this group

    • The name "xhs_submit_video_speech_text_by_note_url" says "submit": a word for a change.
    Description, as the server wrote it
    根据小红书视频笔记链接、短链接或分享文案提交口播转文字任务;提交后最多等待 240 秒,未完成时返回 job_id 和下一步查询动作。

    Annotations the server declares

    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: true
Only reads 34Claude Code: allow
  • socialdatax_get_points_balance查询当前 API Key 账户的 SocialDataX 积分余额、剩余积分或点数 / remaining points balance。需要充值时请访问 https://socialdatax.com/dashboard/billing。No findings

    Why it is in this group

    • The name "socialdatax_get_points_balance" says "get": a word for reading.
    Description, as the server wrote it
    查询当前 API Key 账户的 SocialDataX 积分余额、剩余积分或点数 / remaining points balance。需要充值时请访问 https://socialdatax.com/dashboard/billing。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • xhs_get_note_comments_by_note_id根据 note_id 获取单篇小红书笔记的一级评论,支持 sort_type 评论排序和 page_token 翻页。No findings

    Why it is in this group

    • The name "xhs_get_note_comments_by_note_id" says "get": a word for reading.
    Description, as the server wrote it
    根据 note_id 获取单篇小红书笔记的一级评论,支持 sort_type 评论排序和 page_token 翻页。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • xhs_get_note_comments_by_note_url根据笔记链接、短链接或分享文案获取单篇小红书笔记的一级评论,支持 sort_type 评论排序和 page_token 翻页。No findings

    Why it is in this group

    • The name "xhs_get_note_comments_by_note_url" says "get": a word for reading.
    Description, as the server wrote it
    根据笔记链接、短链接或分享文案获取单篇小红书笔记的一级评论,支持 sort_type 评论排序和 page_token 翻页。

    Annotations the server declares

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

    Why it is in this group

    • The name "xhs_get_note_detail_by_note_id" says "get": a word for reading.
    Description, as the server wrote it
    根据 note_id 获取单篇小红书笔记详情。 返回的 note_url 非 null 时,在任何使用场景都必须原样保留完整 URL,包括 xsec_token 等 query 参数;例如最终回答、展示、引用、存储、输出或传递;不得用 note_id 重新拼接链接;note_url 为 null 时不要用 note_id 合成公开链接。

    Annotations the server declares

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

    Why it is in this group

    • The name "xhs_get_note_detail_by_note_url" says "get": a word for reading.
    Description, as the server wrote it
    根据笔记链接、短链接或分享文案获取单篇小红书笔记详情。 返回的 note_url 在任何使用场景都必须原样保留完整 URL,包括 xsec_token 等 query 参数;例如最终回答、展示、引用、存储、输出或传递;不得用 note_id 重新拼接链接;note_url 为 null 时不要用 note_id 合成公开链接。

    Annotations the server declares

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

    Why it is in this group

    • The name "xhs_get_note_sub_comments_by_comment_id" says "get": a word for reading.
    Description, as the server wrote it
    根据 note_id 和一级评论 comment_id 获取二级评论;用户已提供完整合法的 ID 组合时直接使用;已有 note_id 或笔记链接但缺少必需 ID 时,调用对应一级评论工具补全;缺少笔记定位信息时向用户索取;支持 page_token 翻页。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • xhs_get_product_detail_by_sku_id根据小红书商品 sku_id 获取商品详情;已有该 ID 时直接使用,否则可从 xhs_search_products 获取。只有商品链接、短链接或分享文案时使用 xhs_get_product_detail_by_url;本工具不支持商品链接、spu_id 或搜索词。No findings

    Why it is in this group

    • The name "xhs_get_product_detail_by_sku_id" says "get": a word for reading.
    Description, as the server wrote it
    根据小红书商品 sku_id 获取商品详情;已有该 ID 时直接使用,否则可从 xhs_search_products 获取。只有商品链接、短链接或分享文案时使用 xhs_get_product_detail_by_url;本工具不支持商品链接、spu_id 或搜索词。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • xhs_get_product_detail_by_url根据小红书商品链接、短链接或分享文案获取商品详情,无需先搜索。已有完整 sku_id 时使用 xhs_get_product_detail_by_sku_id;返回的 sku_id 可继续用于商品评价工具。No findings

    Why it is in this group

    • The name "xhs_get_product_detail_by_url" says "get": a word for reading.
    Description, as the server wrote it
    根据小红书商品链接、短链接或分享文案获取商品详情,无需先搜索。已有完整 sku_id 时使用 xhs_get_product_detail_by_sku_id;返回的 sku_id 可继续用于商品评价工具。

    Annotations the server declares

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

    Why it is in this group

    • The name "xhs_get_product_review_replies" says "get": a word for reading.
    Description, as the server wrote it
    根据一级商品评价 review_id 获取其下回复;已有该 ID 时直接使用,否则可从 xhs_get_product_reviews 获取;支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回,不得截断、缩写、掩码或用省略号替换中间内容;不接受 root_review_id。

    Annotations the server declares

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

    Why it is in this group

    • The name "xhs_get_product_review_reply_replies" says "get": a word for reading.
    Description, as the server wrote it
    根据商品评价回复 review_id 获取其下的嵌套回复;已有该 ID 时直接使用,否则可从 xhs_get_product_review_replies 获取;支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回,不得截断、缩写、掩码或用省略号替换中间内容;不接受 root_review_id。

    Annotations the server declares

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

    Why it is in this group

    • The name "xhs_get_product_reviews" says "get": a word for reading.
    Description, as the server wrote it
    根据小红书商品 sku_id 获取商品评价;已有该 ID 时直接使用,否则可从 xhs_search_products 获取;支持 sort_type、has_image 和 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回,不得截断、缩写、掩码或用省略号替换中间内容;不支持商品链接、spu_id 或搜索词。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • xhs_get_search_hot_list获取小红书搜索热榜。No findings

    Why it is in this group

    • The name "xhs_get_search_hot_list" says "get": a word for reading.
    Description, as the server wrote it
    获取小红书搜索热榜。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • xhs_get_share_info根据小红书笔记分享短链接或完整分享文案获取分享人、笔记摘要及作者。 需要笔记完整内容时,使用笔记详情工具;分享信息不包含分享时间。No findings

    Why it is in this group

    • The name "xhs_get_share_info" says "get": a word for reading.
    Description, as the server wrote it
    根据小红书笔记分享短链接或完整分享文案获取分享人、笔记摘要及作者。 需要笔记完整内容时,使用笔记详情工具;分享信息不包含分享时间。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • xhs_get_topic_notes_by_page_id根据 page_id 获取标签页笔记列表,支持 sort_type 排序和 page_token 翻页。No findings

    Why it is in this group

    • The name "xhs_get_topic_notes_by_page_id" says "get": a word for reading.
    Description, as the server wrote it
    根据 page_id 获取标签页笔记列表,支持 sort_type 排序和 page_token 翻页。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • xhs_get_topic_notes_by_topic_url根据话题页链接、短链接或分享文案获取标签页笔记列表,支持 sort_type 排序和 page_token 翻页。No findings

    Why it is in this group

    • The name "xhs_get_topic_notes_by_topic_url" says "get": a word for reading.
    Description, as the server wrote it
    根据话题页链接、短链接或分享文案获取标签页笔记列表,支持 sort_type 排序和 page_token 翻页。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • xhs_get_user_id_by_encrypted_user_id根据完整加密用户 ID 获取稳定 user_id。 仅需单独转换 ID 时使用;查询用户信息或作品可直接使用已有用户 ID 或主页链接,无需先调用本工具。No findings

    Why it is in this group

    • The name "xhs_get_user_id_by_encrypted_user_id" says "get": a word for reading.
    Description, as the server wrote it
    根据完整加密用户 ID 获取稳定 user_id。 仅需单独转换 ID 时使用;查询用户信息或作品可直接使用已有用户 ID 或主页链接,无需先调用本工具。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • xhs_get_user_info_by_profile_url根据主页链接、短链接或分享文案获取单个小红书用户信息。No findings

    Why it is in this group

    • The name "xhs_get_user_info_by_profile_url" says "get": a word for reading.
    Description, as the server wrote it
    根据主页链接、短链接或分享文案获取单个小红书用户信息。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • xhs_get_user_info_by_user_id根据 user_id 获取单个小红书用户信息。No findings

    Why it is in this group

    • The name "xhs_get_user_info_by_user_id" says "get": a word for reading.
    Description, as the server wrote it
    根据 user_id 获取单个小红书用户信息。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • xhs_get_user_posted_notes_by_profile_url根据主页链接、短链接或分享文案获取用户已发布笔记列表,支持 page_token 翻页。No findings

    Why it is in this group

    • The name "xhs_get_user_posted_notes_by_profile_url" says "get": a word for reading.
    Description, as the server wrote it
    根据主页链接、短链接或分享文案获取用户已发布笔记列表,支持 page_token 翻页。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • xhs_get_user_posted_notes_by_user_id根据 user_id 获取用户已发布笔记列表,支持 page_token 翻页。No findings

    Why it is in this group

    • The name "xhs_get_user_posted_notes_by_user_id" says "get": a word for reading.
    Description, as the server wrote it
    根据 user_id 获取用户已发布笔记列表,支持 page_token 翻页。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • xhs_get_video_speech_text_job根据用户提供的有效 job_id,或提交工具返回的 job_id 查询任务状态;用于继续未完成任务,每次最多等待 240 秒,不触发重处理,也不要重复提交任务。No findings

    Why it is in this group

    • The name "xhs_get_video_speech_text_job" says "get": a word for reading.
    Description, as the server wrote it
    根据用户提供的有效 job_id,或提交工具返回的 job_id 查询任务状态;用于继续未完成任务,每次最多等待 240 秒,不触发重处理,也不要重复提交任务。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • xhs_pgy_get_creator_commercial_overview根据完整 user_id 获取小红书蒲公英创作者商业概览:笔记规模和中位数、服务表现、平台标签、增长、预估成本及对比值。 查询指定日常/合作口径的商业汇总与成本参考时使用,不返回逐篇明细。逐篇表现使用创作者笔记表现工具,也可选择日常或合作口径。资料与报价使用创作者档案工具,粉丝构成使用粉丝画像工具。 查看日常内容表现选 daily(默认,不是按天汇总);查看…No findings

    Why it is in this group

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

    Annotations the server declares

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

    Why it is in this group

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

    Annotations the server declares

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

    Why it is in this group

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

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • xhs_pgy_get_creator_metrics_trend根据完整 user_id 获取小红书蒲公英创作者曝光、阅读、互动中位数及预估成本的日期趋势和概览。 观察指标随时间变化时使用;中位数按 note_scope 选择日常或合作笔记,固定图文+视频、近30日、全流量,不支持自选日期。合作口径包含进店指标,日常口径的进店字段为 null;输出回显口径,不能混用。 返回指标不是每日新增量或累计总量,不可跨日期求和;可…No findings

    Why it is in this group

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

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • xhs_pgy_get_creator_notes_performance根据完整 user_id 获取小红书蒲公英创作者笔记表现,包括笔记数量、曝光/阅读/互动中位数、互动率、视频完播率、图文 3 秒阅读率、内容标签和笔记明细。 查询日常或合作笔记表现及最近明细时使用;商业汇总与成本参考使用商业概览工具,资料和报价使用创作者档案工具。 视频完播相关字段仅在 video_note_count 大于 0 时用于表现判断;图文 3 秒…No findings

    Why it is in this group

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

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • xhs_pgy_get_creator_profile根据完整 user_id 获取小红书蒲公英创作者档案、粉丝和商业笔记规模、合作行业、笔记阅读与互动中位数、内容分类、特征标签和创作者图文/视频合作报价。 查询蒲公英创作者资料和报价时使用;普通账号资料使用用户信息工具。 笔记表现使用创作者笔记表现工具;粉丝画像使用创作者粉丝画像工具;指标随日期变化使用创作者指标趋势工具。图文和视频报价单位为人民币元;零值不表…No findings

    Why it is in this group

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

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • xhs_pgy_get_note_detail_by_note_id根据 note_id 获取小红书蒲公英单篇笔记商业增强详情,包括正文、图片或视频摘要、作者、曝光量、阅读量、点赞、收藏、评论、分享和创作者图文/视频合作报价(单位:人民币元;不是当前笔记的成交金额;零值不表示免费合作)。 仅适用于已入驻蒲公英博主的笔记;用户明确要求蒲公英商业数据时使用,普通笔记详情使用普通详情工具。 用户只提曝光量、阅读量或报价且上下文未明…No findings

    Why it is in this group

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

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • xhs_pgy_get_note_detail_by_note_url根据笔记链接、短链接或分享文案获取小红书蒲公英单篇笔记商业增强详情,包括曝光量、阅读量、点赞、收藏、评论、分享和创作者图文/视频合作报价(单位:人民币元;不是当前笔记的成交金额;零值不表示免费合作)。 仅适用于已入驻蒲公英博主的笔记;用户明确要求蒲公英商业数据时使用,普通笔记详情使用普通详情工具。 用户只提曝光量、阅读量或报价且上下文未明确蒲公英口径时,先澄…No findings

    Why it is in this group

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

    Annotations the server declares

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

    Why it is in this group

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

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • xhs_search_notes搜索小红书 / Xiaohongshu / XHS / RedNote 笔记,包含普通、图文和视频笔记;note_type 默认 "all"。查找图文笔记可设 note_type="image",查找视频笔记可设 note_type="video"。发布时间筛选参数名为 publish_time_range(不是 publish_time);本工具不接受 m…No findings

    Why it is in this group

    • The name "xhs_search_notes" says "search": a word for reading.
    Description, as the server wrote it
    搜索小红书 / 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 重新拼接链接。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • xhs_search_products搜索小红书商品。用户需要按搜索词查找商品时使用;已有完整 sku_id(包括用户直接提供)时使用商品详情或商品评价工具,已有商品链接或分享文案时使用 xhs_get_product_detail_by_url;支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回,不得截断、缩写、掩…No findings

    Why it is in this group

    • The name "xhs_search_products" says "search": a word for reading.
    Description, as the server wrote it
    搜索小红书商品。用户需要按搜索词查找商品时使用;已有完整 sku_id(包括用户直接提供)时使用商品详情或商品评价工具,已有商品链接或分享文案时使用 xhs_get_product_detail_by_url;支持 page_token 翻页。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回,不得截断、缩写、掩码或用省略号替换中间内容。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • xhs_search_suggestions根据搜索词获取小红书候选搜索建议,用于补全搜索词;需要实际搜索笔记或商品时,分别使用 xhs_search_notes 或 xhs_search_products。No findings

    Why it is in this group

    • The name "xhs_search_suggestions" says "search": a word for reading.
    Description, as the server wrote it
    根据搜索词获取小红书候选搜索建议,用于补全搜索词;需要实际搜索笔记或商品时,分别使用 xhs_search_notes 或 xhs_search_products。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true
  • xhs_search_users按搜索词搜索小红书用户、账号或博主,支持分页;已有用户 ID 或主页链接时,使用用户资料工具。No findings

    Why it is in this group

    • The name "xhs_search_users" says "search": a word for reading.
    Description, as the server wrote it
    按搜索词搜索小红书用户、账号或博主,支持分页;已有用户 ID 或主页链接时,使用用户资料工具。

    Annotations the server declares

    • readOnlyHint: true
    • openWorldHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 0.1.15. Values in angle brackets are yours to fill in.

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

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__xhs-insights__xhs_get_note_detail_by_note_url",
      "mcp__xhs-insights__xhs_get_note_detail_by_note_id",
      "mcp__xhs-insights__xhs_search_notes",
      "mcp__xhs-insights__xhs_search_images",
      "mcp__xhs-insights__xhs_search_users",
      "mcp__xhs-insights__xhs_search_products",
      "mcp__xhs-insights__xhs_get_product_detail_by_sku_id",
      "mcp__xhs-insights__xhs_get_product_detail_by_url",
      "mcp__xhs-insights__xhs_pgy_get_note_detail_by_note_id",
      "mcp__xhs-insights__xhs_pgy_get_note_detail_by_note_url",
      "mcp__xhs-insights__xhs_pgy_get_creator_profile",
      "mcp__xhs-insights__xhs_pgy_get_creator_notes_performance",
      "mcp__xhs-insights__xhs_pgy_get_creator_fans_profile",
      "mcp__xhs-insights__xhs_pgy_get_creator_fans_summary",
      "mcp__xhs-insights__xhs_pgy_get_creator_commercial_overview",
      "mcp__xhs-insights__xhs_pgy_get_creator_metrics_trend",
      "mcp__xhs-insights__xhs_get_product_reviews",
      "mcp__xhs-insights__xhs_get_product_review_replies",
      "mcp__xhs-insights__xhs_get_product_review_reply_replies",
      "mcp__xhs-insights__xhs_get_search_hot_list",
      "mcp__xhs-insights__xhs_search_suggestions",
      "mcp__xhs-insights__xhs_get_video_speech_text_job",
      "mcp__xhs-insights__xhs_get_note_comments_by_note_id",
      "mcp__xhs-insights__xhs_get_note_comments_by_note_url",
      "mcp__xhs-insights__xhs_get_note_sub_comments_by_comment_id",
      "mcp__xhs-insights__xhs_get_user_id_by_encrypted_user_id",
      "mcp__xhs-insights__xhs_get_share_info",
      "mcp__xhs-insights__xhs_get_user_info_by_user_id",
      "mcp__xhs-insights__xhs_get_user_info_by_profile_url",
      "mcp__xhs-insights__xhs_get_user_posted_notes_by_user_id",
      "mcp__xhs-insights__xhs_get_user_posted_notes_by_profile_url",
      "mcp__xhs-insights__xhs_get_topic_notes_by_topic_url",
      "mcp__xhs-insights__xhs_get_topic_notes_by_page_id",
      "mcp__xhs-insights__socialdatax_get_points_balance"
    ],
    "ask": [
      "mcp__xhs-insights__xhs_submit_video_speech_text_by_note_url",
      "mcp__xhs-insights__xhs_submit_video_speech_text_by_note_id"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as xhs-insights. Review it before you use it.