核心用法
本 Skill 是 SocialDataX 社媒数据助手针对快手（Kuaishou / Kwai）平台的专项数据工具，支持通过 CLI 命令或 MCP 工具调用实现多维度数据获取。核心功能覆盖六大场景：热榜监测（hot-search）实时追踪平台趋势；内容研究（search、detail）支持关键词搜索作品及单条详情解析；达人挖掘（user-search、user-info、user-posts）实现创作者发现、画像分析及作品列表获取；评论分析（comments、replies）支持一级评论及楼中楼回复的完整抓取。
使用方式灵活：支持 photo_id、URL、分享文本等多种输入格式；分页参数（--pages、--all）可控数据量；--pretty 参数输出格式化结果便于阅读。CLI 优先模式无需 MCP 配置，通过 npx -y socialdatax-skills@latest 直接调用，适合快速查询与脚本集成。
显著优点
1. 官方数据源：SocialDataX 作为社媒数据服务方，提供结构化、标准化的平台数据，较爬虫方案更稳定合规
2. 全链路覆盖：从热点发现→内容研究→达人分析→用户反馈，形成完整的研究闭环
3. 多形态输入：兼容 ID、URL、分享文本，降低用户使用门槛
4. 安全只读：明确声明不执行登录、点赞、评论、发帖等写操作，仅获取公开数据
5. 灵活部署：CLI 直调与 MCP Server 双模式，适应不同 Agent 架构
潜在缺点与局限性
1. 商业依赖：需付费获取 SOCIALDATAX_API_KEY，存在余额耗尽导致服务中断的风险，且充值流程需人工介入
2. 数据延迟：第三方数据服务较官方实时数据存在一定滞后性
3. 平台局限：仅限快手单平台，不支持抖音、B站等其他短视频平台横向对比
4. 反爬风险：虽为官方 API，但若快手平台调整接口策略，可能存在数据中断或字段变更风险
5. 隐私边界：达人信息抓取需遵守平台规则与数据合规要求，过度挖掘存在合规隐患
适合的目标群体
- 内容运营/新媒体团队：监测热点、分析爆款内容、追踪竞品账号
- 市场研究与咨询机构：短视频行业分析、KOL 筛选与评估、舆情监测
- MCN 机构与创作者：对标分析、内容策略优化、粉丝互动研究
- 电商直播从业者：达人带货能力评估、直播内容复盘
使用风险
1. API 余额风险：调用消耗 credits，高频使用需监控余额，错误处理机制要求识别 insufficient_balance 并引导充值
2. 网络与参数风险：非稳定网络或错误 ID/URL 格式会导致调用失败，需重试机制
3. 密钥安全风险：SOCIALDATAX_API_KEY 作为环境变量管理，需避免硬编码泄露
4. Node 环境依赖：要求运行环境具备 node 和 npm，部分精简环境可能需额外配置
5. 数据合规风险：抓取用户评论、达人信息需符合《个人信息保护法》及平台规则，商业使用建议获取数据主体授权