Skip to Content
数字员工 CLI 文档抖音热榜数据

抖音热榜数据 CLI 指令

douyin-hot-rank-data 在开放能力文档中仍然是外部应用接入使用的产品能力包。数字员工 CLI 是 Agent CLI 的员工授权视图，不要求大脑或派发者理解开放 API 的 applicationId、API Key 或 input.action，而是通过 CLI 指令选择更明确的业务动作，由后端代为完成真实开放能力调用。

适用场景

| 场景 | CLI 指令 | 映射动作 | | --- | --- | | 外部采集器已经拿到热榜或日榜 JSON，需要交给平台保存。 | write_douyin_hot_rank_data | douyin-hot-rank-data.write | | 运营同学要查看今天最新一次热榜或日榜。 | read_latest_douyin_hot_rank_data | douyin-hot-rank-data.latest | | 运营同学要回看最近一个月内某一天的热榜或日榜。 | read_douyin_hot_rank_data_by_date | douyin-hot-rank-data.by-date |

管理员给数字员工授权 douyin-hot-rank-data 时，系统可以展开出上面三个动作对应的 CLI 指令。管理员也可以只授权其中一个动作；单独授权叶子动作只开放映射到该动作的 CLI 指令，不会反向扩大到同一个产品包下的其他动作。

派发表单

front 的数字员工工作台 v1 仍让派发者填写工作标题、目标、能力动作和输入 JSON。v2 轻量大脑会先选择 CLI 指令，再由后端映射为动作级能力。派发者不需要填写开放应用 ID，也不需要知道外部应用接入文档里的 HTTP 路径。

当前 workspace 和 console 会优先根据动作的 inputSchemaJson 生成参数表单：rank_type 会展示为榜单类型下拉，rank_date 会展示为日期输入；需要排障或输入复杂对象时，仍可以切换到高级 JSON 模式。旧版 date 别名由后端继续兼容，但不再作为数字员工推荐表单字段展示。

表单项建议写法
工作标题用一句话说明这次要做什么，例如“获取今日抖音热榜”。
目标写清楚榜单类型、日期和期望结果，例如“读取今天最新一份 hot 榜单数据，用于运营看板”。
CLI 指令 / 能力动作v2 由大脑选择 CLI 指令；v1 手动派发仍从下拉列表选择，不手输 capability key。
输入 JSON只填写当前动作需要的业务字段。

动作一：提交榜单数据

选择 CLI 指令 write_douyin_hot_rank_data，后端映射到 douyin-hot-rank-data.write，提交一份热榜或日榜 JSON 快照。平台会按 rank_type + rank_date + scraped_at 生成默认业务来源键，并把原始 JSON 写入资产；如果 rank_date 超出最近 30 天存储范围，调用仍会成功，但不会创建资产。

{
  "title": "提交 2026-05-13 抖音热榜",
  "objective": "保存 2026-05-13 15:40:30 抓取到的 hot 榜单快照",
  "capabilityKey": "douyin-hot-rank-data.write",
  "input": {
    "rank_type": "hot",
    "rank_date": "2026-05-13",
    "scraped_at": "2026-05-13 15:40:30",
    "data": {
      "items": [
        {
          "rank": 1,
          "title": "作品名",
          "heat": "2.4亿"
        }
      ]
    }
  }
}
字段必填说明
rank_type是榜单类型。当前支持 hot 热榜、daily 日榜。
rank_date是榜单归属日期，格式为 yyyy-MM-dd。
scraped_at是数据采集时间，格式为 yyyy-MM-dd HH:mm:ss。
data / 其他业务字段否原始榜单内容。平台会尽量原样保存，不要求固定业务结构。

执行成功后重点看 stored 和 artifact。stored = true 表示已经落库并生成资产；stored = false 表示平台接收了这份数据，但因为日期范围等规则没有写入资产。

动作二：获取实时榜单

选择 CLI 指令 read_latest_douyin_hot_rank_data，后端映射到 douyin-hot-rank-data.latest，获取北京时间今天对应 rank_type 的最新一次榜单数据。

{
  "title": "获取今日抖音热榜",
  "objective": "读取今天最新一份 hot 榜单数据",
  "capabilityKey": "douyin-hot-rank-data.latest",
  "input": {
    "rank_type": "hot"
  }
}
字段必填说明
rank_type是榜单类型。当前支持 hot 实时热榜、daily 每日榜，表单默认选 hot。

执行成功且有数据时，结果里会包含 artifact 和解析后的 json。如果当天没有保存过对应榜单，调用仍然是成功状态，但结果会返回 hasData = false，前端应把它显示成“没有查询到榜单数据”，而不是能力调用失败。

动作三：获取指定日期榜单

选择 CLI 指令 read_douyin_hot_rank_data_by_date，后端映射到 douyin-hot-rank-data.by-date，获取最近一个月内指定日期的最新榜单。

{
  "title": "获取 2026-05-13 抖音日榜",
  "objective": "读取 2026-05-13 最新一份 daily 榜单数据",
  "capabilityKey": "douyin-hot-rank-data.by-date",
  "input": {
    "rank_type": "daily",
    "rank_date": "2026-05-13"
  }
}
字段必填说明
rank_type是榜单类型。当前支持 hot 实时热榜、daily 每日榜，表单默认选 hot。
rank_date是要查询的榜单日期，格式为 yyyy-MM-dd，动态表单中会显示为日期输入，只支持最近一个月内的日期。

指定日期没有数据时也会返回成功响应，结果中 hasData = false、artifact = null、json = null。这类结果代表业务上没有命中数据，不代表执行链路失败。

常见失败

前端提示常见原因处理方式
能力调用失败数字员工没有获得该动作授权，或者后端实际开放能力执行失败。到 console 检查数字员工能力包授权和能力审计。
参数格式错误rank_type 不是 hot/daily，或 rank_date、scraped_at 格式不符合要求。按本页示例修正输入 JSON 后重新派发。
缺少必填字段提交数据缺少 rank_type、rank_date、scraped_at，或查询缺少 rank_type。补齐当前动作要求的字段。
日期超出范围指定日期早于最近一个月，或晚于北京时间今天。改成最近一个月内的日期。

失败工作会保留在数字员工工作记录中，工作详情会显示失败步骤和错误信息。管理员也可以在 console 的能力审计里按调用主体区分外部应用调用和数字员工调用。

记录与审计

数字员工派发后会产生工作记录和步骤记录，真实能力调用继续进入开放能力执行审计。落库资产仍然使用产品能力 key douyin-hot-rank-data，这样外部应用接入、资产聚合和后台治理可以保持同一条产品能力主线；动作级 key 用于真实业务动作边界，CLI 指令用于数字员工大脑选择和补参数。

Last updated on
概览快手达人信息