核心用法
SocialDataX 是一款专注于小红书（Xiaohongshu / XHS / RedNote）平台的数据分析工具，提供笔记搜索、关键词检索、内容调研、竞品分析和趋势研究等能力。用户可通过 CLI 命令 npx -y socialdatax-skills@latest xhs search 直接调用，或配置 MCP 服务使用 xhs_search_notes 工具。
主要功能特性
- 关键词搜索：支持精准关键词检索，自动处理空格并聚焦用户真实意图
- 多维筛选：可按排序方式（综合/时间/点赞/评论/收藏）、笔记类型（图文/视频）、发布时间范围（日/周/半年）过滤结果
- 分页采集：支持
--pages批量获取多页数据，--max-items限制结果数量 - 数据完整性：完整保留 24 字符笔记 ID 和含
xsec_token的原始 URL，确保数据可追溯
显著优点
- 零配置快速启动：无需 MCP 服务器配置，单条 npx 命令即可运行
- 纯只读安全设计：不读取浏览器数据、不存储 API Key、不涉及登录/发帖/互动等账号操作
- 官方数据源：来自 SocialDataX 社媒数据助手，专注于社交媒体数据服务
潜在缺点与局限性
- API Key 依赖：需单独申请
SOCIALDATAX_API_KEY，免费额度与付费策略由官方制定 - 平台覆盖单一：目前仅支持小红书，未覆盖抖音、微博等其他社媒平台
- 实时性边界：数据获取存在固有延迟，不适合需要秒级热点的场景
- 合规使用限制：需遵守小红书平台规则及数据使用条款
适合人群
- 内容创作者/博主：选题策划、热点追踪、竞品内容分析
- 品牌营销人员：市场趋势观察、竞品监测、KOL 筛选
- 产品经理/研究员：用户偏好洞察、行业赛道研究
- MCN 机构：多账号内容策略制定、数据驱动的运营决策
常规风险
- 数据隐私：搜索结果包含公开笔记信息，需注意脱敏处理
- URL 完整性：必须完整保留
xsec_token参数，截断或修改将导致链接失效 - API 稳定性：第三方数据服务存在可用性波动，建议关键业务配置降级方案
- 平台政策变化：小红书算法调整可能影响数据抓取策略的有效性