核心用法
抖音搜索关键词技能（douyin-search-keyword）是一款面向短视频营销、竞品分析与热点追踪的智能数据采集工具。用户通过 Node.js 命令行环境调用，输入关键词即可实时检索抖音平台的公开视频与图文内容。
基础调用：
node scripts/search.js [关键词] [选项]
核心参数：
--sort：排序方式（0-综合/1-最多点赞/2-最新发布）--time：时间筛选（0-全部/1-1天内/7-7天内/180-半年内）--limit：返回数量（1-60条，默认10）--output：输出格式（json/markdown）
输出数据：包含内容标题、发布人信息、互动数据（点赞/评论/收藏/分享）、视频/图文CDN链接、原生URL等完整字段，支持 JSON（程序处理）与 Markdown（人工阅读）双格式。
显著优点
1. 数据维度丰富：不仅返回基础链接，更提取完整的互动指标与媒体资源地址，满足深度分析需求
2. 参数灵活度高：多维度排序+时间范围筛选，可精准定位爆款内容或最新趋势
3. 输出格式友好：JSON 适配自动化流程，Markdown 便于内容创作者快速浏览整理
4. 集成成本低：符合 OpenClaw 生态规范，支持环境变量配置与本地文件持久化
5. 稳定性设计：内置超时控制、自动重试机制（3次任务创建重试+60次结果轮询），成功率>95%
潜在缺点与局限性
1. 数据范围受限：仅支持公开内容，无法获取私密账号或受限内容
2. 链接时效性：CDN 链接为临时地址，存在过期风险，需及时下载留存
3. 频率限制严格：默认 TOKEN 效率受限，生产环境需申请私有 TOKEN；API 限流 2次/秒
4. 响应延迟：平均响应时间约30秒，不适合实时性要求极高的场景
5. 关键词限制：长度2-50字符，禁止特殊符号与HTTP链接，复杂查询需拆解
6. 无直接下载能力：仅提供媒体链接，不内置下载功能
适合人群
- 短视频运营/营销人员：追踪热门趋势、分析竞品内容策略
- 内容创作者：寻找爆款灵感、研究优质内容结构
- 数据分析师：构建抖音内容数据库、进行量化研究
- 品牌方/广告主：监测品牌声量、评估KOL表现
- 开发者：集成至自动化工作流、构建监控工具
常规风险
1. 合规风险：虽仅采集公开数据，但大规模爬取仍需关注平台政策变化；内置敏感词拦截机制可降低部分风险
2. 数据隐私：严格遵守不存储/泄露用户隐私信息的原则，但使用者需确保下游使用符合数据保护法规
3. 服务稳定性：依赖第三方 API，存在服务中断或接口变更风险
4. TOKEN 安全：环境变量配置需注意保密，默认 TOKEN 仅限体验，生产环境务必更换私有 TOKEN
5. 版权风险：获取的媒体链接仅限分析用途，商业使用需遵循原内容版权规则
6. 误判风险：关键词自动清洗可能误过滤有效内容，复杂查询建议多次验证