核心用法
SocialDataX XHS Detail 是一款专为小红书（Xiaohongshu / RedNote）生态设计的只读型数据解析工具，支持通过笔记 ID、分享链接或短链快速提取笔记的结构化详情与互动指标。
使用方式
首选方式：直接 CLI 调用（无需 MCP 配置）
npx -y socialdatax-skills@latest xhs detail --note-id "<note_id>" --pretty npx -y socialdatax-skills@latest xhs detail --url "<note_url>" --pretty
--note-id：已知笔记 ID 时直接使用--url：支持完整链接、短链、分享文本或笔记 ID--pretty：格式化输出
备选方式：MCP Tools
xhs_get_note_detail_by_note_id：基于笔记 ID 查询xhs_get_note_detail_by_note_url：基于 URL 或分享文本查询
输出字段
工具返回完整的事实数据，包括：标题、正文内容、作者信息、发布时间、点赞/收藏/评论数、图片列表及原始链接等。
---
显著优点
1. 官方数据源：来自 SocialDataX 社媒数据助手，数据覆盖与准确性具备商业级保障
2. 零配置开箱即用：通过 npx 直接运行，无需本地安装或复杂 MCP 配置
3. 多入口兼容：同时支持笔记 ID、标准 URL、短链、分享文本等多种输入格式
4. 纯只读安全：不涉及登录、发帖、点赞、评论等任何写操作，无账号风险
5. 结构化输出：返回标准化 JSON，便于接入自动化分析流程或 BI 工具
---
潜在缺点与局限性
| 维度 | 说明 |
|------|------|
| **API 依赖** | 需配置 `SOCIALDATAX_API_KEY`，存在服务可用性与配额限制 |
| **成本因素** | 高频调用可能产生费用，需关注用量计费策略 |
| **数据时效** | 平台缓存机制可能导致互动数存在分钟级延迟 |
| **内容边界** | 仅解析公开笔记，私密/已删除/限流内容无法获取 |
| **Node 环境** | 依赖本地 Node.js 运行环境，部分受限环境可能无法执行 |
---
适合人群
- 内容运营/增长团队：监测竞品笔记表现，提炼爆款内容特征
- 品牌方/市场研究：批量抓取达人合作笔记数据，评估投放效果
- 数据分析师/开发者：构建小红书内容监测 pipeline 或自动化报表
- 独立创作者：分析自身账号内容表现，优化发布策略
---
常规风险
- 合规风险：抓取数据仅限个人/企业内部分析，禁止二次售卖或违反平台 ToS 的大规模爬取
- 隐私边界：作者昵称、头像等公开信息可获取，但不得用于用户画像画像关联或精准营销
- API 密钥安全：
SOCIALDATAX_API_KEY需妥善保管，避免硬编码或泄露至版本控制 - 数据解释风险：互动数高低不等于内容质量，需结合上下文解读，避免误判
---
总结
SocialDataX XHS Detail 是小红书生态中高效、安全、结构化的数据获取工具，适合需要快速解析单篇笔记详情、进行内容调研与竞品分析的各类用户。建议搭配 SocialDataX 的其他技能（如搜索、作者分析）形成完整的数据工作流。