用途:该技能用于查询 EchoTik 的 TikTok 公开视频排行榜数据,属于公开数据、只读操作,不涉及卖家后台、店铺授权或账号写入。
主要能力:调用 POST /api/v1/tools/research/echotik/listVideoRank 接口。必填参数为 date(YYYY-MM-DD)、rankType(1-3)、region、videoRankField(1-2);可选参数为 productCategoryId、createdByAi、pageNum、pageSize(10-100,且为 10 的倍数)。构造请求前需阅读 references/api.md,只发送文档中列出的字段,未知字段应在联网前拒绝。
使用方式:先确认请求的公开实体、市场、操作、筛选条件与预期成本,再校验参数。执行命令:python scripts/echotik_list_video_rank.py '<JSON parameters>' --no-cache,且只运行一次;付费失败后未经用户同意不得探测其他产品、市场、页面或操作。需设置环境变量 NEXSCOPE_API_KEY;凭据缺失或过期时可访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 充值。
结果与计费:保留完整响应文件,区分 Nexscope 传输层信封与内部业务响应,出错时报告 traceId。仅总结返回的事实,缺失值保留为未知。该操作消耗 Nexscope 积分,需保留响应头中的 X-Cost-Token 与 X-Cost-Credit 作为服务端计费元数据;首次实际响应前具体扣费未知。
错误处理:HTTP 401 表示 Nexscope 认证失败,应检查 NEXSCOPE_API_KEY 与 NEXSCOPE_PROXY_BASE,不要让用户把凭据粘贴到聊天或操作 JSON 中;HTTP 402 表示账户积分不足,应停止流程并引导用户访问上述帮助页面。市场授权失败需更新对应平台账号或令牌,不得自动替换店铺、地区或创作者。网络故障需说明是读取还是变更操作,变更操作未核对上游状态前不得重试。
响应校验:研究响应需外层 code 为 0 才能使用数据,非零为平台失败,应展示外层 msg 但不将其措辞当作重试指令;HTTP 200 与嵌套业务状态不能替代平台校验。
限制:每次调用只处理一个明确请求,出错后不得静默更改实体、市场、日期、操作或页码;输出需脱敏凭据、签名 URL、Cookie 与内部账号标识;未在 references/testing.md 中有对应证据时,不得声称已完成实时、ZIP 安装或生产验证。