SuperAPI AI 工具集

douyin-hot-search

数据与分析

查看项目

更新于 10-15 21:41

技能介绍

用途:该技能用于抓取抖音五个公开榜单(热点榜、种草榜、娱乐榜、社会榜、挑战榜)的排名话题信息,返回话题及其可用热度字段。它不返回话题背后的视频或图文帖子;如需查找某话题下的帖子,可将话题词传给 douyin-search。上游 Douyin Hot Search Scraper 记录了榜名与话题字段,Frevana 对相同参数可能复用近期快照。

主要能力与用法:附带 Bash 脚本负责创建任务、轮询状态和获取 JSON 结果,依赖 bash、curl、jq,以及生成客户端任务 ID 时需要的 uuidgen 或 openssl。可用 run 一次完成整个任务,或用 create、status、wait、result 分阶段执行。仅当调用方需要时才指定榜单,API 默认使用 hotspot。

示例命令: bash {baseDir}/scripts/douyin_task.sh run --board hotspot bash {baseDir}/scripts/douyin_task.sh run --board hotspot --board entertainment --max-results-per-board 20 --output ./out/hot.json bash {baseDir}/scripts/douyin_task.sh create --client-task-id caller-stable-id --board social bash {baseDir}/scripts/douyin_task.sh status --task-id TASK_UUID bash {baseDir}/scripts/douyin_task.sh wait --task-id TASK_UUID bash {baseDir}/scripts/douyin_task.sh result --task-id TASK_UUID

create --wait 等价于 run。更多参数用 --help 查看。

认证与输出:使用 FREVANA_TOKEN 或一次性 --token 覆盖;不要打印令牌。默认 API 基址为 https://ai-factory.frevana.com,可用 FREVANA_API_BASE_URL 或 --api-base-url 覆盖。create 与 status 打印 API 响应;result、run、wait 打印原始 JSON 结果字节,run 与 wait 默认保存到 ./out/,可用 --output 指定路径。创建任务视为计费,需记录打印的 client_task_id;若创建请求超时或结果不明,用相同 ID 和相同选项重试,不要自动生成新任务。轮询至 status=READY 且 billing_status=BILLED 为止;遇到 FAILED、TIMED_OUT、ABORTED、RESULT_EXPIRED 或 TRIGGER_UNKNOWN 应停止。结果 JSON 原样返回,不要改动厂商字段或假设条目数量。

限制与平台:Windows 上需在 Git Bash 或 WSL 运行 .sh 入口,确保安装 jq(可用 winget install jqlang.jq),若复制脚本到 Git 之外需保留 LF 换行。Git Bash 支持带引号的 Windows 输出路径,如 --output 'C:\Users\me\hot.json';WSL 在可用 wslpath 时也支持。脚本仅向 Frevana 发送 Authorization: Bearer 头。其余配置细节暂未提供。