核心用法
SocialDataX 小红书博主数据技能是面向小红书(XHS/RedNote)创作者生态的数据查询工具,提供两种主要调用方式:
1. 直接 CLI 模式(推荐)
npx -y socialdatax-skills@latest xhs user-info --user-id "<user_id>" --prettynpx -y socialdatax-skills@latest xhs user-info --profile-url "<链接或分享文本>" --pretty
2. MCP 工具模式
xhs_get_user_info_by_user_id:已知用户ID时优先使用xhs_get_user_info_by_profile_url:支持主页链接、短链或分享文本
输出字段涵盖:昵称、平台ID、简介、认证状态、粉丝数、关注数、获赞数、IP属地、性别等核心画像数据。
显著优点
- 数据源合规:SocialDataX 为专业社媒数据服务商,通过官方渠道合规采集公开数据
- 零本地配置:CLI 模式无需 MCP 服务器配置,即装即用
- 双输入兼容:同时支持精准ID查询和模糊链接/分享文本解析
- 纯只读安全:不读取浏览器数据、不登录、不执行互动操作,API Key 不落本地文件
- 输出结构化:JSON 格式便于下游分析集成
潜在局限
- 数据覆盖边界:仅能查询公开账号信息,私密账号或受隐私设置保护的数据无法获取
- 实时性限制:粉丝数等动态数据存在一定更新延迟,非实时秒级同步
- 平台单一性:当前仅支持小红书,未覆盖抖音、快手等其他平台
- API 配额依赖:需自主申请
SOCIALDATAX_API_KEY,高频调用受服务商配额限制
适合人群
- 品牌方/广告主:达人筛选、投放前背调、竞品账号监测
- MCN 机构:签约达人资产盘点、分级管理
- 市场研究人员:创作者生态趋势分析、样本数据采集
- 自媒体运营:对标账号研究、差异化定位参考
常规风险
| 风险类型 | 说明 |
|---------|------|
| 合规风险 | 低。仅读取公开数据,不涉及隐私突破或协议违规 |
| 数据误用 | 中。粉丝数等数据可能被用于虚假宣传,需标注数据时效 |
| API 安全 | 低。Key 通过环境变量注入,不落盘;但需防止泄露至日志 |
| 服务依赖 | 中。SocialDataX 服务中断或调价将影响可用性 |
获取 API Key
官方唯一入口:https://socialdatax.com/?from=clawhub