SuperAPI AI 工具集

tiktok-profiles-collect-by-url

数据与分析

查看项目

更新于 10-15 21:42

技能介绍

用途:按一个或多个精确的 TikTok 主页 URL 采集公开资料记录,脚本封装完整的创建、轮询与原始结果流程。

主要能力:每个输入对象必须提供 TikTok 主页 url,可通过可重复的 --input-json 或一个含 JSON 数组的 --input-file 传入 1 至 20 个对象;支持 run 全流程,也支持 create、status、wait、result 分阶段调用;create --wait 等价于 run。

使用方式:将 {baseDir} 解析为包含 SKILL.md 的目录。完整流程示例:bash {baseDir}/scripts/tiktok_task.sh run --input-json '{"url":"https://www.tiktok.com/@fofimdmell","country":"US"}';也可用 --input-file ./inputs.json 与 --output ./out/tiktok-result.json。分阶段:create --client-task-id caller-stable-id --input-json '...',随后 status --task-id TASK_UUID、wait --task-id TASK_UUID、result --task-id TASK_UUID。认证使用 FREVANA_TOKEN 或一次性 --token,默认基址 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/profiles/collect-by-url,不得路由其他 TikTok 操作。其他字段与任务状态见 references/api.md。