SuperAPI AI 工具集

ecommerce.tiktok-product-analytics-api

数据与分析

查看项目

更新于 10-16 01:36

技能介绍

用途:该技能用于获取指定 TikTok 商品的电商分析数据,包括价格、销量、收入、佣金、生命周期和店铺信息,适用于用户明确要求查询某个 TikTok 商品详情的场景。

主要能力:提供 kalodata_product_detail 操作,模式为 gateway-script,非变更型操作,可调用。机器可读的接口定义以 references/api.json 为准,字段级规则按操作区分。

使用方式:先确认市场、实体标识、日期范围、筛选条件和期望输出,仅询问会实质影响结果的缺失输入。读取 references/api.json,选择该操作 upstreamPath 中记录的包内脚本执行。研究类请求须使用 references/api.json 中记录的完整路径,以 /api/v1/tools/research/ 开头;NEXSCOPE_PROXY_BASE 只设为网关源,不得直接调用 /amazon/、/kalodata/、/aigc/** 等旧短路径。示例:python scripts/kalodata_product_detail.py --help,随后按文档参数运行。

响应处理:研究类 HTTP 响应须外层 code 等于 0 才可使用数据;非零为平台失败,直接显示 outer msg,不将其措辞理解为重试指令。HTTP 200 本身及嵌套业务 code/status 不能替代平台校验。

配置与限制:业务/工具操作需 NEXSCOPE_PROXY_BASE 与 NEXSCOPE_API_KEY;授权/账户操作需相应 NEXSCOPE_AGENT_* 或 NEXSCOPE_LOGIN_* 基础地址;第三方连接器需其文档化配置。凭据缺失或过期可访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 充值。不得编造市场数据或静默填充业务标识;变更型操作需用户明确批准并传 --confirm 与 --confirm-mutation;超时后不得盲目重试变更,应先查状态。完整 JSON 存入 nexscope/<date>/<session>/data/ 产物,向用户展示相关记录、假设、计算与限制,并递归脱敏授权、令牌、Cookie、密钥和密码。法律、合规、税务与盈利输出仅为决策支持,非专业建议。执行前应阅读 references/workflow.md、references/api.md、references/testing.md 与 references/credentials.md。