【用途】 本技能提供面向 TikTok Shop 经营决策的 Kalodata 市场数据能力。核心用法分两步:先按市场(region)和时间窗口(dateRange)发现高表现商品、店铺、达人、带货视频或直播,再沿榜单返回的字符串 ID 深入查看单个对象的销售、流量、互动、佣金、渠道收入和关联关系。它适合选品初筛、竞品拆解、达人合作线索发现、内容与直播表现对比和详情核验,返回可直接分析的原始业务数据与关键指标。
【前置条件】 本技能必须依赖 MCP「LinkFox」。如未安装,需先安装 LinkFox 连接器:在 WorkBuddy 左侧找到「专家·技能·连接器」→「连接器」,搜索关键词「LinkFox」并安装连接器「LinkFox」(注意是 linkfox,不是 linkfox-product-selection),按指引完成登录授权,再返回重试。认证由 WorkBuddy 通过 MCP 连接自动授权,调用参数中禁止加入 headers、Authorization、API key 或 token。
【主要能力】 技能关联工具键为 kalodata_tiktok,覆盖 5 个业务模块、10 个 API operation,每个模块含一个 rank 和一个 detail:
- 商品(linkfox-kalodata-tiktok-product):用 POST /kalodata/product/rank 查看热销商品,比较价格、销量、GMV、视频/直播/橱窗收入、增长率、佣金率和上架日期;用 POST /kalodata/product/detail 查看价格区间、评论、类目、配送、所属店铺及关联视频/直播/达人。
- 店铺(linkfox-kalodata-tiktok-shop):用 POST /kalodata/shop/rank 查看店铺排行及自营、达人分销、商城收入拆分;用 POST /kalodata/shop/detail 查看店铺规模、商品、达人、视频和直播数量。
- 达人(linkfox-kalodata-tiktok-creator):用 POST /kalodata/creator/rank 发现高表现达人,比较粉丝、内容观看、销量、视频/直播收入和增长率;用 POST /kalodata/creator/detail 查看地区、状态、简介、视频/直播 GPM、关联商品/店铺及已提供的联系方式。
- 带货视频(linkfox-kalodata-tiktok-video):用 POST /kalodata/video/rank 查看高表现视频,支持 revenue_range 限定 GMV 范围和 sortField;用 POST /kalodata/video/detail 查看播放、点赞、评论、分享、销量、视频 GPM、广告播放、ROAS、CPA、投放周期、时长和关联商品。
- 带货直播(linkfox-kalodata-tiktok-livestream):用 POST /kalodata/livestream/rank 查看按地区/时间窗口的直播榜;用 POST /kalodata/livestream/detail 查看指定直播的观看人数、GMV、GPM、时长和带货商品数。
【使用方式】 MCP Server 为 LinkFox,MCP URL 为 https://mcp-tool-gateway.linkfox.com/mcp/any-tool,只调用 MCP 工具 proxy_call。参数封装外层始终包含 toolName 与 arguments,arguments 直接放原业务请求对象,例如 POST /kalodata/product/rank 对应 toolName: "kalodata/product/rank"。rank 可按 region、dateRange、language、currency 查询,通常支持 pageNumber 1–5 与 pageSize 5–100 翻页。结果处理先检查 MCP 连接、工具 schema 和 isError,再读取 text/structured content(text 为 JSON 字符串时只解析一次),然后检查下游 errcode/errmsg,最后读取业务字段。禁止使用 curl、urllib、requests、httpx 等方式直连网关,MCP 或 proxy_call 缺失、连接失败或返回错误时停止,不得静默 HTTP fallback,也不得猜测其他 toolName。同一会话同参数默认只调用一次,不得因空结果、失败或字段缺失自动重试、换区域、换时间、改 ID、改筛选或连续翻页。
【适用场景与选择思路】 用户问「卖什么」时看商品;问「谁在卖」时看店铺或达人;问「怎么卖/内容表现」时看视频或直播。rank 只用于发现和比较,detail 只用于已有 ID 的单实体核验。请求多个对象时应先说明将产生多次接口消耗,由用户决定是否继续。
【限制】 榜单不是关键词搜索,不支持按商品名、店铺名、达人昵称、视频标题或直播标题检索;需要详情时必须先取得有效 ID。合法但无数据的查询可能返回 errcode=200 且没有 data,仍可能计费。响应通常不提供可信的 total 或总页数,以 data.length 判断当前页,返回条数小于 pageSize 或达到第 5 页时停止。数据可能存在 T+1 统计延迟,不等同实时后台数据。所有销量字段使用接口原样拼写 sales_volumn;直播 rank 用 views、字符串类型 revenue/unit_price,detail 用 viewers、数字类型 revenue 和 detail-only gpm;店铺 rank 与 detail 的渠道字段不同,不得跨 operation 混用。收入是 GMV/销售额,不是利润、广告花费或净收益;金额必须同时标明 currency、region 与 dateRange。每次业务调用都可能产生积分消耗;401/402/403 等错误需区分 MCP 层与下游业务层处理,不把错误响应当正常数据。本技能不负责 TikTok 广告投放或广告账户管理、内容创作/编辑/下载、店铺订单/库存/ERP、物流供应链、平台账号运营、关键词搜索、跨平台商品研究、法律/财务结论或与平台/卖家的直接沟通。