核心用法
SocialDataX 小红书笔记详情技能（socialdatax-xhs-detail）专用于解析单条小红书（Xiaohongshu / RedNote）笔记的结构化数据。用户可通过笔记 ID、URL、短链或分享文本调用，获取完整的笔记元数据、内容详情及互动指标。
调用方式：
1. 推荐方式：直接使用 Node.js CLI 命令 npx -y socialdatax-skills@latest xhs detail，支持 --note-id 或 --url 参数
2. MCP 工具：若环境已配置 MCP，可使用 xhs_get_note_detail_by_note_id 或 xhs_get_note_detail_by_note_url
输出字段：标题、正文内容、作者信息、发布时间、点赞/收藏/评论数、图片列表、笔记原始链接等。
显著优点
- 数据完整度高：返回结构化 JSON，包含笔记全文与多媒体信息，便于二次分析
- 调用灵活：同时支持 note ID 直连和 URL/分享文本智能解析，适配多种输入场景
- 零配置依赖：通过
npx直接运行，无需本地安装或复杂环境配置 - 安全边界明确：纯只读操作，不涉及账号登录、内容发布或互动行为
潜在局限
- 需外部 API Key：依赖
SOCIALDATAX_API_KEY，新用户需前往官网申请 - 单条查询限制：设计为单笔记详情查询，不支持批量或账号级数据聚合
- 第三方服务依赖：数据质量与稳定性受 SocialDataX 服务可用性影响
- 合规性待确认：小红书平台数据抓取存在政策风险，需用户自行评估使用场景的合法性
适合人群
- 品牌营销人员：竞品笔记内容拆解与爆款因子分析
- 内容创作者：研究头部账号的内容结构与发布策略
- 数据分析师：构建小红书内容数据库的 ETL 环节
- 投资研究人员：消费品牌社交资产追踪与舆情监测
常规风险
- API 密钥管理：需安全存储
SOCIALDATAX_API_KEY，避免硬编码或意外泄露 - 平台政策风险：小红书反爬机制可能调整，存在数据中断或账号关联风险
- 数据时效性：互动指标为快照数据，高流量笔记可能存在数小时延迟
- 成本可控性：第三方 API 通常按调用量计费，高频使用需关注费用预算