核心用法
douyin-search-keyword 是一款面向短视频营销与内容创作者的数据分析工具，基于 Node.js 运行时提供三大核心能力：
1. 关键词搜索 (search-cli.js)：支持 2-50 字关键词搜索，可按综合/点赞数/最新排序，筛选 1天/7天/半年时间窗口，单次获取 1-200 条视频数据
2. 抖人作品抓取 (post-cli.js)：通过创作者主页 URL 或 sec_uid 批量获取指定账号的公开作品列表
3. 实时热榜监控 (hot-cli.js)：一键获取抖音平台当前热搜榜单
输出支持 JSON/Markdown 双格式，日志自动归档至 logs 目录，便于二次分析与报告生成。
显著优点
- 零账号风险：无需登录抖音账号，规避平台风控与封号风险
- 轻量部署：单文件 Node.js 脚本，无需复杂服务架构
- 灵活筛选：多维度参数组合（排序/时间/数量），适配选题策划、竞品分析、热点追踪等场景
- 结构化输出：自动生成时间戳命名的 JSON 日志，无缝对接数据分析工具
- MIT 开源：可自由二次开发与内部集成
潜在局限
- 数据边界：仅抓取公开可见内容，无法获取私密/隐藏/限制级视频
- 依赖外部 API：需配置
GUAIKEI_API_TOKEN，存在供应商服务可用性依赖 - 反爬风险：依赖第三方数据接口，若抖音官方策略调整可能导致数据中断
- 合规约束：数据仅限个人/团队内部使用，大规模分发存在法律风险
- 无实时增量：单次拉取模式，非持续监控流
适合人群
- 短视频运营/编导：挖掘爆款选题、分析高赞内容特征
- 品牌营销人员：竞品账号监控、内容策略对标
- 数据分析师：获取结构化抖音数据用于趋势研究
- MCN 机构：批量管理达人内容资产与热榜响应
常规风险
- TOKEN 安全：API 密钥需妥善保管，泄露可能导致配额滥用
- 数据隐私：抓取创作者公开数据仍需遵守《个人信息保护法》及平台规则
- 接口稳定性：第三方 API 可能出现延迟、限流或数据字段变更
- 合规使用：禁止用于爬虫攻击、数据倒卖、虚假流量等违规场景