SuperAPI AI 工具集

ecommerce-tiktok-batch-product-detail

营销与增长

查看项目

更新于 10-16 06:50

技能介绍

用途:面向 TikTok Shop 卖家与运营,批量获取已知商品的详细表现指标,便于并排比较候选商品。

主要能力:单次最多查询 1000 个商品,可用 productIds(商品 ID 数组)或 productUrls(TikTok Shop 商品链接数组)指定,二者可混用,后端会从链接中提取 productId 并合并。返回销售、GMV、直播场次、视频数、达人数、浏览量等指标,均覆盖 1d/7d/15d/30d/60d/90d 及累计口径。价格字段 minPrice、maxPrice、spuAvgPrice 为美元。状态标记:salesTrendFlag(0 稳定、1 上升、2 下降)、isSShop(全托管)、offMark(已下架)、freeShipping(包邮)。

使用方式:调用 API 端点 POST /echotik/batchProductDetail;或运行 python scripts/echotik_batch_product_detail.py '<JSON 参数>' [--inline]。需设置 NEXSCOPE_API_KEY,额度管理见 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS。默认将完整响应写入 <cwd>/nexscope/<YYYY-MM-DD>/<session>/data/nexscope-echotik-batch-product-detail-<timestamp>.json;响应体不超过 8 KB 时打印完整 JSON,超过则仅输出摘要,加 --inline 可强制完整输出。建议先看摘要,再用 jq 或 ConvertFrom-Json 按需提取字段。

适用场景:按 ID 或链接批量查详情、比较 GMV、判断趋势、识别下架或全托管商品、查看直播销售等。

限制:该工具消耗额度,同一会话相同参数默认只调用一次,脚本本地缓存 24 小时;失败或空结果时不要自动换关键词、翻页或改筛选重试,需先告知用户。销售、GMV 与归因数据为分析估算值,非平台精确数据。仅支持按已知 ID/链接查询,不支持关键词或类目搜索;关键词选品、新品榜单、商品关联推广视频、视频下载链接解析、达人主页分析及非 TikTok 平台数据均不适用。若某商品无记录,会列出对应 ID/链接以便核对。