# 抖音关键词搜索 (Douyin Search & Analytics) 更新日志

## 1.1.4 - 2026-06-09

- 新增多份 JSON 模式文件，用于命令行结构化输入输出校验。
- 在 references/ 目录下添加文档：更新日志（changelog.md）、配置说明（options.md）。
- 优化 SKILL.md：补充模式文件引用，并完善令牌获取相关说明。
- 为技能元数据补充模式定义，提升兼容性与自检能力。

## 1.1.3 - 2026-05-11

**新增：支持获取抖音作者（抖人）已发布作品，实现竞品账号内容批量抓取。**

- 新增 post-cli 指令，可根据抖音主页 URL 或 sec_uid 一键获取创作者所有公开作品，便于竞品监控和账号内容分析。
- 参数说明、使用范例及常见问题等文档内容同步更新，更清晰指引新功能使用方式。
- 指令参数支持短缩写，limit上限提升至200，提升批量数据抓取能力。
- 关键词搜索、热榜等原有功能保持兼容并优化参数配置，提升整体易用性。
- 调整并精简 Skill 文档，增加使用案例，强调 TOKEN 申请与日志留存说明。
- 示例与文档同步完善，能力标签更明确。

## 1.1.2 - 2026-05-04

- 新增支持抖音热搜榜单查询（hot-cli.js），可独立调用。
- 关键词搜索与热榜查询分别独立为入口（search-cli.js/hot-cli.js）。
- 项目结构优化，API与工具模块化拆分，便于维护与扩展。
- 移除旧 scripts/lib 目录，迁移为 src/api、src/utils、src/validate 目录。
- 更新文档与示例，增强上手指引与使用场景说明。

## 1.1.1 - 2026-03-31

- 更新 JSON 响应中的输出字段，明确标记更多字段，提高下游解析的一致性。
- 无功能或界面变更;文档现在准确反映了输出模式中始终存在的字段。

## 1.1.0 - 2026-03-31

**重大升级：结构化输出、多参数排序与筛选能力增强**

- 增加多维度排序（综合/最多点赞/最新发布）和发布时间筛选（1天/7天/半年），结果更精准。
- 支持自定义返回数量（1~60条），输出格式新增 Markdown，与 JSON 并行。
- 完全结构化 JSON 输出，字段覆盖互动数据、标签等，适配 OpenClaw 生态。
- 内置参数合法性校验、敏感词过滤及安全保护，保证调用稳定合规。
- 增强任务轮询&超时重试机制，提升检索成功率和稳定性。
- 技能文档全面更新，提供详细参数表、示例与应用场景说明。

## 1.0.2 - 2026-03-24

- 技能重命名为“douyin-search-keyword”。
- 在SKILL.md中添加了openclaw元数据、使用帮助、许可证、标签和示例，以实现更好的集成与文档化。
- 移除了两个本地文件（.env 和 scripts/last-search.json），以优化代码结构并提升安全性。
- 文档现已更加简洁且以用户为中心，重点在于提供清晰的使用说明和数据字段解释。
- 突出技能特性、合规要点及技术流程。

## 1.0.1 - 2026-3-20

- 更新技能描述，强调支持多维度抖音公开内容检索（视频、图文、用户等）
- 扩展文档，新增适用/不适用场景说明
- 新增环境和token配置的详细步骤与平台限制说明
- 明确数据字段及样例，补充表格形式字段解释
- 强调合规、风控及临时链接有效期注意事项

## 1.0.0 - 2026-03-18

- douyin-search-general 技能首次发布。
- 提供抖音通用搜索接口，支持视频、图文、用户及社交数据搜索。
- 返回详细信息，包括内容描述、作者、发布时间、点赞数、评论数、分享数、封面图片及视频链接。
- 需要Node.js和有效的GUAIKEI_API_TOKEN环境变量才能运行。
- 输出包含可直接复制的URL，并附有示例响应格式说明。