| name | linkfox-echotik-batch-product-detail |
| description | 批量查询TikTok商品详情数据，包括多周期销量与GMV（1天/7天/15天/30天/60天/90天/累计）、直播销量与直播GMV、带货视频与达人数据、播放量、价格、评分、评论数、佣金比例及上下架/全托管状态，支持通过商品ID或TikTok Shop商品URL批量获取。当用户提到TikTok商品详情、批量查询TikTok商品、TikTok商品销量分析、TikTok商品GMV、TikTok直播销量、TikTok带货数据、TikTok商品价格评分、批量获取TikTok商品信息、EchoTik商品详情、TikTok product detail, batch product lookup, TikTok sales analysis, TikTok GMV, TikTok live sales, TikTok influencer data时触发此技能。即使用户未明确提及"EchoTik"，只要其需求涉及根据商品ID或商品URL批量获取TikTok商品的详细销售与营销数据，也应触发此技能。 |
EchoTik-商品详情
基本信息
- 业务工具名：
/echotik/batchProductDetail
- 所属分组：EchoTik · TikTok 商品与视频
- 功能说明：EchoTik-商品详情
何时使用
当用户意图与“EchoTik-商品详情”匹配，或需要以下能力时使用本工具：EchoTik-商品详情
调用前应先确认所有必填参数。涉及站点、国家、日期、语言、ASIN、SKU、图片或 URL 时，应使用用户提供的信息，不要擅自虚构真实业务标识。
输入参数
| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
|---|
productIds | array<string> | 否 | 最多 1000 项 | 商品ID列表, 多个使用英文逗号分隔 |
productUrls | array<string> | 否 | 最多 1000 项 | 商品URL列表, 形如 https://shop.tiktok.com/us/pdp//?... ; 将从每个URL中提取末尾的productId并合并到productIds, 与productIds不排斥 |
MCP 调用示例
向以下地址发起 HTTP POST：
https://mcp-tool-gateway.linkfox.com/mcp/any-tool
请求体：
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "/echotik/batchProductDetail",
"arguments": {}
}
}
示例值仅用于展示请求结构。实际调用时必须替换为用户的真实查询条件。
输出字段
| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
|---|
type | string | 否 | | 渲染的样式 |
total | integer | 否 | | 记录数 |
columns | array<object> | 否 | | 渲染的列 |
products | array<object> | 否 | | 商品详情列表 |
costToken | integer | 否 | | 消耗token |
嵌套输出结构：products
| 字段 | 类型 | 必填 | 约束/默认值 | 说明 |
|---|
region | string | 否 | | 区域代码 |
isSShop | integer | 否 | | 是否全托管店铺 |
offMark | integer | 否 | | 商品下架标识 |
discount | string | 否 | | 折扣信息 |
imageUrl | string | 否 | | 商品图片 |
maxPrice | number | 否 | | 最高SKU价格(USD) |
minPrice | number | 否 | | 最低SKU价格(USD) |
sellerId | string | 否 | | 卖家ID |
productId | string | 否 | | 商品ID |
salesFlag | integer | 否 | | 主要配送方式 |
categoryId | string | 否 | | 一级分类ID |
descDetail | string | 否 | | 商品详情描述 |
productName | string | 否 | | 商品名称 |
reviewCount | integer | 否 | | 评论数量 |
|
响应处理建议
- 先检查 JSON-RPC 外层是否包含
error。
- 成功时读取
result，并继续解析其中的 content、data、products、items 或其他业务字段。
- 如果响应为
text/event-stream，按 SSE 事件读取 data: 内容，再解析 JSON。
- 保留分页字段、总数、失败明细及
costToken。
- 向用户输出分析结论，不要直接倾倒大段原始 JSON。
原始 Schema
原始的Input Schema 和 Output Schema 参考 references/schema.md
解决认证和积分问题
异常情况：未配置 LINKFOX_AGENT_API_KEY 和 LINKFOXAGENT_API_KEY；响应 401 或 402；消息含"积分余额不足/quota exceeded/insufficient balance/套餐到期/需充值"等。
措施：优先用 skill 内 onboarding.md 引导；找不到则加载 /linkfox-onboarding skill。 根据它的指引操作。
注意：你是workbuddy，并且渠道是workbuddy，使用linkfox-onboarding登录注册时必须传递channel为 workbuddy。这非常重要！
