核心用法
SocialDataX 抖音搜索技能（socialdatax-douyin-search）是一款面向抖音平台的只读型数据检索工具，通过 SocialDataX API 提供视频、图文内容的结构化搜索能力。支持两种调用模式：
1. CLI 直连模式（推荐）：通过 npx -y socialdatax-skills@latest douyin search 直接调用，无需额外配置 MCP Server；
2. MCP 工具模式：若环境已集成 MCP，可调用 douyin_search_videos 函数完成相同操作。
核心参数配置：
--keyword（必填）：搜索关键词，支持话题、品牌、人物等实体检索；--sort-type：排序策略，可选综合排序（general）、发布时间倒序（time_descending）、点赞量倒序（like_count_descending）；--publish-time-range：发布时间过滤，支持当日、本周、半年等粒度；--duration-range：视频时长过滤，区分 1 分钟内、1-5 分钟、5 分钟以上；--content-type：内容形态过滤，可选全部、仅视频、仅图文；--page-token：分页令牌，用于结果翻页遍历。
输出字段：返回内容包含视频/图文 ID、标题、描述、作者信息、互动数据（点赞、评论、分享）、发布时间、内容类型标识及可追踪的链接，支持 --pretty 美化输出。
显著优点
- 数据源合规：仅访问抖音公开可索引内容，不涉及用户隐私数据或登录态操作；
- 多维度过滤：时间、时长、内容形态、排序策略组合灵活，适配竞品监控、热点追踪、内容策划等场景；
- 零配置门槛：CLI 模式单条命令即用即走，无需持久化 API 密钥到本地配置（依赖环境变量
SOCIALDATAX_API_KEY）； - 结构化输出：返回标准化 JSON，便于后续数据清洗、入库或可视化分析。
潜在局限与风险
- API 依赖性强：服务可用性与数据新鲜度完全依赖 SocialDataX 平台，存在单点故障风险；
- 覆盖范围受限：仅能检索平台已索引的公开内容，私密账号、限流内容、已删除视频不可见；
- 速率与配额限制：第三方商业 API 通常存在调用频次上限，大规模数据采集需评估成本；
- 地域与合规边界：抖音内容受平台算法推荐与地域策略影响，搜索结果可能存在采样偏差，跨境使用需关注数据合规要求。
适合人群
- 内容创作者与 MCN 机构：进行选题策划、竞品对标、爆款拆解；
- 市场与品牌研究者：监测品牌声量、追踪 campaign 效果、识别 KOL 合作机会；
- 数据分析师：构建抖音内容数据库，支撑趋势预测与舆情分析。
常规风险提示
- 只读边界：本技能明确禁止任何写操作（点赞、评论、发布、账号修改），但使用者需确保 API Key 的存储与传输安全；
- 版权与隐私：抓取内容仅限分析用途，二次传播需遵守抖音社区规范及原作者版权；
- 数据时效：短视频生态迭代极快，历史搜索结果可能与当前平台实际状态存在偏差，关键决策建议交叉验证。