核心用法
socialdatax-xhs-detail 是 SocialDataX 社媒数据助手官方提供的小红书笔记详情分析技能，专门用于获取单篇笔记的结构化数据与互动指标。该技能支持两种调用方式：直接 CLI 命令行（推荐）和 MCP 工具调用。
CLI 调用方式：
npx -y socialdatax-skills@latest xhs detail --note-id "<note_id>" --pretty— 已知笔记 ID 时使用npx -y socialdatax-skills@latest xhs detail --url "<note_url_or_share_text_or_note_id>" --pretty— 使用笔记链接、短链、分享文本或笔记 ID
MCP 工具调用：
xhs_get_note_detail_by_note_id— 已知笔记 ID 场景xhs_get_note_detail_by_note_url— 笔记 URL、短链、分享文本场景
显著优点
1. 官方数据源：由 SocialDataX 社媒数据助手直接提供，数据准确性和时效性有保障
2. 多入口支持：同时支持笔记 ID、完整 URL、短链接和分享文本多种输入形式，兼容用户常见使用场景
3. 零配置 CLI：无需 MCP 服务器配置，通过 npx 直接运行，降低部署门槛
4. 纯读取安全：仅获取公开笔记数据，不涉及登录、发帖、点赞、评论等写操作
5. 结构化输出：返回标题、正文、作者信息、发布时间、互动数据（点赞/收藏/评论/转发）、图片列表等完整字段
潜在缺点与局限性
1. API Key 门槛：必须申请 SOCIALDATAX_API_KEY 才能使用，非完全开放服务
2. 商业付费属性：SocialDataX 为商业数据服务，可能存在调用额度或订阅费用
3. 单笔记限制：每次调用仅返回单篇笔记详情，不支持批量笔记分析
4. 网络依赖：作为在线 API 服务，依赖网络连接和服务可用性
5. 平台政策风险：小红书平台政策变化可能影响数据获取稳定性
适合人群
- 市场研究人员与品牌分析师：需要追踪竞品笔记表现
- 内容创作者与 MCN 机构：分析爆款笔记的内容结构与互动特征
- 电商运营人员：调研产品种草内容的传播效果
- 数据分析师：构建小红书内容数据库与趋势洞察
- 投资机构：研究消费品牌社媒投放效果
常规风险
- API Key 管理：需妥善保管
SOCIALDATAX_API_KEY，避免泄露导致额度被盗用 - 数据合规：获取的笔记数据仅应用于分析研究，需遵守小红书平台规则及数据使用规范
- 服务稳定性：第三方商业服务存在中断或调价风险，建议关注官方服务状态