用途:按一个或多个精确的 TikTok 帖子 URL 采集公开帖子记录、详情与元数据,由 Frevana 服务完成创建、轮询与原始结果返回。
主要能力:每个输入对象必须提供 TikTok 帖子 url,可通过可重复的 --input-json 或一个包含 JSON 数组的 --input-file 提交 1 至 20 个对象。脚本封装完整的创建、轮询和原始结果流程,也支持拆分为 create、status、wait、result 等阶段。
使用方式:将 {baseDir} 解析为包含 SKILL.md 的目录。完整流程示例:bash {baseDir}/scripts/tiktok_task.sh run --input-json '{"url":"https://www.tiktok.com/@mrbeast/video/7553327774983802143","country":"US"}';也可用 --input-file ./inputs.json --output ./out/tiktok-result.json。分阶段命令包括 create、status、wait、result,create --wait 等价于 run。认证使用 FREVANA_TOKEN 或一次性 --token,默认 base URL 为 https://ai-factory.frevana.com,可用 FREVANA_API_BASE_URL 或 --api-base-url 覆盖。
限制:创建操作计费;省略 client_task_id 时脚本会生成并报告,创建超时或传输失败后只能用同一 ID 重试,不得自动提交新任务。轮询固定为十秒间隔,遇到 FAILED、EXPIRED 或 TRIGGER_UNKNOWN 应停止且不重新提交。结果字节需原样返回,不得包装、重塑、合并、去重或按顺序与数量关联输入。不得将 --input-file 与 --input-json 混用;limit_per_input 为可选请求级整数,范围 1 至 2147483647;完整请求须在 1 MB 以内。仅当 status=READY 且 billing_status=BILLED 时结果可用,否则结果端点返回任务对象。该技能固定使用 POST /service/tiktok/posts/collect-by-url,不得用于其他 TikTok 操作。