核心用法
SocialDataX XHS Detail 是一款专注于小红书（Xiaohongshu / RedNote）笔记详情分析的社媒数据工具。用户可通过笔记 ID、笔记 URL、短链接或分享文本获取结构化笔记数据，包括标题、正文内容、作者信息、发布时间、互动数据（点赞、收藏、评论、转发）、配图等完整信息。
该工具提供双模式调用方式：
- 直接 CLI 模式：通过
npx -y socialdatax-skills@latest xhs detail命令快速执行，无需 MCP 服务器配置，支持--note-id和--url两种入参 - MCP 工具模式：若环境已配置 MCP，可调用
xhs_get_note_detail_by_note_id或xhs_get_note_detail_by_note_url工具
显著优点
1. 数据维度完整：覆盖笔记元数据、内容文本、多媒体资源、作者画像及全量互动指标
2. 入参灵活：兼容多种输入格式（纯 ID、完整 URL、短链、平台分享文本），降低用户使用门槛
3. 即开即用：CLI 模式无需复杂配置，单条命令即可运行
4. 纯只读安全：不涉及账号登录、内容发布、互动操作等敏感行为，数据获取边界清晰
潜在缺点与局限性
- 依赖第三方 API 服务（SocialDataX），需配置
SOCIALDATAX_API_KEY，存在服务可用性与配额限制 - 数据时效性受平台反爬策略及 API 更新频率影响，非实时数据可能存在延迟
- 目前仅支持单笔记详情查询，不具备批量处理能力或账号级数据分析功能
- 未覆盖评论区内容抓取，互动分析仅限于聚合数字
适合人群
- 品牌市场人员进行竞品内容调研与达人筛选
- 自媒体运营者追踪笔记表现与内容趋势
- 数据分析师构建小红书内容数据库
- 投资机构进行消费品牌社媒资产尽调
常规风险
- API 密钥管理：
SOCIALDATAX_API_KEY需安全存储，避免硬编码或意外泄露 - 数据合规：抓取小红书数据需遵守平台用户协议及个人信息保护相关法规
- 服务依赖：工具功能完全依赖 SocialDataX 服务稳定性，建议关注官方服务状态