核心用法
SocialDataX 小红书博主笔记技能（socialdatax-xhs-creator-notes）是一款面向小红书（Xiaohongshu / XHS / RedNote）平台的创作者内容数据查询工具，由社媒数据服务商 SocialDataX 官方提供。该技能支持通过用户 ID 或主页链接/分享文本获取博主已发布的笔记列表，用于内容调研、创作者对标分析、近期话题追踪及账号风格研究。
技能提供两种调用方式：
1. 直接 CLI 模式：无需 MCP 服务器配置，通过 npx -y socialdatax-skills@latest xhs user-posts 命令直接调用，支持 --user-id 或 --profile-url 参数，输出结果可读性强
2. MCP 工具模式：若环境已配置 MCP，可通过 xhs_get_user_posted_notes_by_user_id 或 xhs_get_user_posted_notes_by_profile_url 工具调用
返回数据包含笔记标题、内容摘要、发布时间、互动数据（点赞/收藏/评论）、媒体链接及笔记 ID，支持分页（page_token 机制），可用于进一步链式查询笔记详情或评论分析。
显著优点
- 官方数据源：由 SocialDataX 官方维护，数据可靠性高，非第三方爬取
- 零配置启动：CLI 模式无需复杂 MCP 配置，一条命令即可运行
- 灵活输入：同时支持数字用户 ID 和分享链接/短链/分享文本，适配多种用户场景
- 只读安全：纯数据读取，不涉及登录、发帖、点赞、评论等敏感操作
- 输出友好：
--pretty参数提供格式化输出，便于快速阅读
潜在局限
- 需 API Key：依赖
SOCIALDATAX_API_KEY，免费额度或付费门槛可能限制使用 - Node 环境依赖：要求本地已安装 Node.js 和 npm
- 分页令牌绑定：
page_token与当前用户强绑定，不可跨用户复用，需妥善管理 - 非实时数据：社媒数据通常存在一定延迟，非毫秒级实时同步
- 仅限公开内容：仅能获取公开笔记，私密或限流内容无法访问
适合人群
- 小红书运营人员与 MCN 机构，用于竞品监控与创作者筛选
- 品牌营销团队，进行 KOL/KOC 内容风格调研与合作评估
- 数据分析从业者，开展社媒内容趋势研究与账号追踪
- 内容创作者，进行同类账号对标分析与选题参考
常规风险
- API 密钥管理：
SOCIALDATAX_API_KEY需妥善保管，避免硬编码或泄露至版本控制 - 数据合规使用：社媒数据受平台规则约束，商业用途需确保符合《小红书用户服务协议》及相关法规
- 速率限制：频繁调用可能触发 API 限流，建议合理控制请求频率并实施退避策略
- 依赖服务可用性：SocialDataX 服务端稳定性直接影响数据获取，需考虑服务中断的降级方案