用途:查询 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参数>' --no-cache。付费失败后未经用户同意,不得再试探其他产品、市场、页面或操作。需设置环境变量 NEXSCOPE_API_KEY;凭据缺失或过期时访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 充值。
结果呈现:先给出请求的实体、市场、操作及最具决策价值的返回字段;保留原始货币、单位、标识、日期与缺失值,不自行换算或补默认值;保留完整 JSON 文件,必要时用紧凑表格展示重复记录;报告响应头中的 X-Cost-Token、X-Cost-Credit 及 traceId。
限制与错误处理:HTTP 401 表示 Nexscope 认证失败,应检查 NEXSCOPE_API_KEY 与 NEXSCOPE_PROXY_BASE,不要让用户在对话或操作 JSON 中粘贴凭据;HTTP 402 表示账户额度不足,应停止流程并引导至上述帮助页;市场授权失败需续期对应平台账号或令牌,不得自动替换店铺、地区或创作者。网络故障不明确时需说明是读操作还是写操作,写操作未核对上游状态前不得重试。每次调用只处理一个明确请求,出错后不得静默更改实体、市场、日期、操作或页码。输出中需脱敏凭据、签名 URL、Cookie 与内部账号标识。该操作消耗 Nexscope 积分,首次实际响应前具体扣费未知,不得沿用源 Skill 的积分值。未在 references/testing.md 中找到对应证据时,不得声称已完成实时、ZIP 安装或生产验证。