linkfox-echotik-list-video

搜索和分析 TikTok 视频,按站点、达人、关联商品、类目、播放量、时长、发布时间及带货、投流、AI 类型筛选,展示互动、视频销量与 GMV 估算和视频资料,覆盖 16 个 TikTok Shop 站点。适用于热门视频发现、带货内容研究、广告素材对标和达人视频表现分析,无需明确提及 EchoTik。已知单个商品的关联视频、商品排行、达人画像、直播数据、视频下载地址解析及其他平台视频不属于本技能范

SKILL.md

GitHub

EchoTik TikTok 视频搜索

适用范围

适用

按站点发现 TikTok 视频,研究内容表现、互动情况和带货效果。用户提出站点或热门、带货、投流等筛选意图,且不是仅查询一个已知商品的关联视频时,使用本技能。

场景速查

用户表达 查询场景
TikTok 热门视频有哪些 按播放量查看热门视频。
看 TikTok 带货视频排行 筛选带货视频,查看播放表现及销量估算。
某个达人的 TikTok 视频 按达人检索,比较点赞和播放表现。
TikTok 投流视频或广告视频 筛选投流视频,对标内容。
最近的 TikTok AI 视频 筛选 AI 视频,按发布时间查看。
近期高播放的视频 结合播放量和发布时间范围筛选。
哪些视频 GMV 高 检索后查看 GMV,仅比较本次返回的视频。

边界

已知单个商品的关联视频优先使用 linkfox-echotik-product-video;视频下载地址解析使用 linkfox-echotik-get-video-download-url。商品搜索或排行转交 EchoTik 商品技能;达人画像、直播和非 TikTok 平台视频不属于本技能范围。

前置条件

先确定目标站点和研究范围:用户未指定站点时,询问或默认美国站,并明确告知采用的站点。准备达人、商品或类目筛选时,从已有结果取得对应编号;字段约定见 references/api.md。

查询流程

  1. 判断用户需要按站点发现视频,还是查看已知单个商品的关联视频,按适用范围选择技能。
  2. 确定站点,按用户意图组合达人、关联商品、类目、播放量、时长、发布时间和视频类型条件;根据研究目标选择播放量、点赞或发布时间排序。请求前查阅 references/api.md。
  3. 检索一次并保存完整结果,先看摘要,再从保存的 JSON 按需提取视频数据;失败或空结果按成本约束处理。
  4. 展示视频表现、原视频链接、估算提示及分页情况。结果较多时可建议收紧筛选或继续分页,后续检索遵守成本约束。

执行方式

  • 直接调用接口:接口端点、完整参数、响应和错误码见 references/api.md。
  • 脚本调用(推荐):python scripts/echotik_list_video.py '<JSON 参数>' [--inline]。
  • 成本约束:每次接口调用消耗 5 算力。同一会话、同一参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果时,不得自动更换关键词、翻页或修改邮编连续试探;需要继续检索时,先向用户说明额外消耗。

输出策略

  • 始终保存完整响应,目标路径为 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-echotik-list-video-<timestamp>.json。<cwd> 为脚本运行时的工作目录,<session> 优先取环境变量 SESSION_ID,用于聚合同一任务的数据。禁止写入 /tmp,当前目录不可写时应报错。
  • 响应体不超过 8 KB:保存后,将完整 JSON 打印到标准输出。
  • 响应体超过 8 KB:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如 total、costToken)、最大列表字段的长度和前 3 条样本。
  • 添加 --inline 可强制全量打印到标准输出,同时仍保存文件。

先通过摘要判断数据是否足够。需要具体字段时,优先使用 jq 或 ConvertFrom-Json 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。

执行规则

算力消耗预估

5 算力 / 次

声明:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。

用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。

解决认证和算力问题

出现以下情况时,按 references/onboarding.md 的指引处理:

  • 未配置接口密钥:LINKFOX_AGENT_API_KEY 和 LINKFOXAGENT_API_KEY 均为空。
  • 响应状态码为 401 或 402。
  • 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。

约束与建议

  • 理解数据来源:EchoTik 是 TikTok Shop 数据分析平台,结果用于内容发现、策略对标和视频带货归因研究。
  • 清晰展示数据:用表格列出视频描述(过长时截断)、播放量、点赞、评论、分享、收藏、视频销量、GMV、发布日期和达人编号;可按需补充时长、分辨率、文件大小、头像、关联商品及类目。
  • 提供可访问素材:有 officialUrl 时提供 TikTok 原视频链接;有 coverUrl 时说明可查看封面。将时长转换为易读形式,例如 90 秒显示为 1:30。
  • 标明估算性质:视频销量和 GMV 是估算值,展示时提醒用户,不直接称为实际成交或转化率。
  • 说明比较范围:查看销量或 GMV 时只能对本次已返回结果作比较,不能声称取得全站销量或 GMV 排名。
  • 保留多周期信息:需要比较趋势时,从保存的 JSON 提取近 1 天、7 天、30 天的播放量和点赞明细。
  • 说明分页情况:始终告知 total 记录数及当前页;缺失的数据如实说明,不自行推断。
  • 解释空结果和错误:依据 references/api.md 判断结果与原因,保留已有数据,后续请求遵守成本约束。

使用示例

美国站热门视频:按播放量降序

{"region":"US","videoSortField":3,"sortType":1,"pageSize":20,"pageNum":1}

带货视频:按播放量查看并比较销量估算

{"region":"US","salesFlag":1,"videoSortField":3,"sortType":1,"pageSize":20}

指定达人的视频:按点赞降序

{"region":"US","userId":"7234567890123456789","videoSortField":1,"sortType":1}

英国站指定时间范围的高播放视频

{"region":"GB","minTotalViewsCnt":100000,"minCreateTime":1717200000,"maxCreateTime":1719792000,"videoSortField":1,"sortType":1}

AI 视频:按发布时间降序

{"region":"US","createdByAi":"true","videoSortField":2,"sortType":1,"pageSize":50}

使用反馈

当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 references/api.md#Feedback 的指引反馈,不要打断用户当前流程。


更多优质、专业的跨境电商技能,请访问 LinkFox Skill。