mcpField
L
linkfox-echotik-seller-detail

linkfox-echotik-seller-detail

github.com/linkfox-ai营销与增长113173 次安装2 周前更新
代码仓库

关于 linkfox-echotik-seller-detail

面向跨境卖家和营销人员的技能，可通过 sellerId 查询单个 TikTok Shop 店铺档案，汇总销售、店铺健康度、商品及创作者覆盖指标；不用于发现或筛选店铺。

主要功能

  1. 01多周期销售额与 GMV
  2. 02粉丝、评分及服务比率
  3. 03商品数量与价格区间
  4. 04达人、视频及直播数量

适用场景

  1. 01查看已知店铺的销售趋势
  2. 02评估单店顾客反馈
  3. 03了解店铺商品与推广覆盖

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-echotik-seller-detail

安装后在 Claude Code 中输入/linkfox-echotik-seller-detail确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
api.md
onboarding.md
scripts/
echotik_seller_detail.py
onboarding.py

详细介绍

EchoTik TikTok 卖家详情

此工具通过 sellerId 获取单个 TikTok Shop 店铺（卖家）的完整资料，帮助跨境卖家和营销人员深入了解单个店铺的表现，包括销量、多周期 GMV、粉丝数、评分、履约情况，以及达人、视频和直播的覆盖范围。

核心概念

EchoTik 是一个 TikTok Shop 分析平台。此工具会返回单个店铺的完整详情对象：总销量和增量销量（1d/7d/30d/90d）、GMV、粉丝数、评分、评价、好评率 / 回复率 / 配送率、商品数量、价格区间、类目，以及推广达人数、视频数和直播数。

sellerId 的获取方式：此工具需要店铺的 sellerId。请从 EchoTik TikTok Seller Search 技能（linkfox-echotik-list-seller）获取，该技能可按地区、类目、GMV、趋势和店铺类型列出并筛选 TikTok Shop 店铺。

上架日期：firstCrawlDt 使用紧凑的整数格式 YYYYMMDD（例如，20240504 表示 2024 年 5 月 4 日）。

数据字段

响应是一个扁平的店铺对象（顶层还包含 errcode、errmsg、costToken、columns、type）。

字段描述
sellerId店铺 ID
sellerName店铺名称
sellerLink店铺链接
coverUrl店铺封面图片 URL
region市场代码
categoryId / categoryL2Id / categoryL3Id一级 / 二级 / 三级类目 ID
totalSaleCnt总销量
totalSale1dCnt / 7dCnt / 30dCnt / 90dCnt销量（1d/7d/30d/90d，增量）
totalSaleGmvAmt总 GMV（收入）
totalSaleGmv1dAmt / 7dAmt / 30dAmt / 90dAmtGMV（1d/7d/30d/90d，增量）
followersCount粉丝数
rating店铺评分
reviewCount评价数
positiveFeedbackRate好评率
responseRate回复率
deliveryRate配送率
totalProductCnt历史商品数（包括已下架商品）
totalCrawlProductCnt当前店铺内的商品数
spuAvgPrice店铺内 SKU 平均价格
minPrice / maxPrice最低 / 最高价格
totalIflCnt推广达人数
totalVideoCnt推广视频数
totalLiveCnt直播数
salesFlagText主要销售渠道（视频带货 / 直播带货）
salesTrendFlagText销售趋势（上升 / 下降 / 平稳）
shopIdentityLabel店铺身份标签（例如 OFFICIAL SHOP）
shopTypeText品牌店标记（是 / 否）
fromFlagText本土 / 跨境标记（本土 / 跨境）
productCategoryList商品类目（JSON 字符串）
mostProductCategoryListTOP1 商品类目（JSON 字符串）
firstCrawlDt预计上架时间（YYYYMMDD）
userId达人 UID
sourceType来源类型（例如 Tiktok）
sourceTool来源工具
costToken消耗的令牌数
columns渲染列定义（显示元数据）
type渲染样式（例如 tableListWorkbenches）

参数指南

参数类型必填默认值描述
sellerIdstring是-TikTok Shop 店铺 ID。从 Seller Search 技能的结果中获取。最大长度为 1000

调用方式

  • API 端点：POST /echotik/sellerDetail（完整参数/响应/错误码见 references/api.md）
  • Python 脚本：python scripts/echotik_seller_detail.py '<JSON 参数>' [--inline]
  • 成本约束：本工具会消耗算力；同一会话的同一参数组合默认只调用一次，脚本带有 24h 本地缓存。失败 / 空结果不得自动更换关键词、翻页或修改邮编连续试探；需要继续检索时，请先向用户说明会产生额外消耗。

输出策略（脚本默认行为）：

  • 始终将完整响应写入 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-echotik-seller-detail-<timestamp>.json（<cwd> 是脚本执行时的工作目录，在 Claude Code 中即当前项目目录；<session> 取自环境变量 SESSION_ID，按用户任务自动聚合；禁止写入 /tmp，当前目录不可写时则报错）
  • 响应正文 ≤ 8 KB：写入文件后，将完整 JSON 打印到 stdout
  • 响应正文 > 8 KB：写入文件后，stdout 仅输出摘要（顶层字段、常见计数字段，如 total / costToken，以及最大列表字段的长度和前 3 条样本）
  • 添加 --inline 强制将全部内容打印到 stdout（同时写入文件）

数据读取建议：先查看摘要，判断其是否足够；需要具体字段时，优先使用 jq或ConvertFrom-Json 从保存的 json 文件中按需提取，避免将整份 JSON 加入上下文。

解决认证和算力问题

发生以下异常情况时，请参考 references/onboarding.md 中的指引解决问题：

异常情况
  • 未配置 API Key：未配置环境变量 LINKFOX_AGENT_API_KEY，也未配置 LINKFOXAGENT_API_KEY。
  • 响应 401 或 402 状态码
  • 响应提示算力或余额不足：消息含“算力余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值”，或类似含义的内容。

使用示例

1. 获取店铺完整资料

{
  "sellerId": "7495514739648989419"
}

2. 深入分析通过 Seller Search 找到的店铺

先用店铺搜索列出美国GMV前列店铺，再查看其中 medicube US Store（sellerId 7495514739648989419）的完整详情

展示规则

  1. 呈现清晰的店铺资料：显示店铺名称、地区、卖家链接、封面图片和身份标签（例如 OFFICIAL SHOP）
  2. 销售额和 GMV 粒度：显示总销量和总 GMV；展示销量和 GMV 按多个周期（1d/7d/30d/90d）的细分数据，让用户了解趋势
  3. 店铺健康指标：同时显示粉丝数、评分、评论数、好评率、响应率和配送率
  4. 店铺属性：展示 fromFlagText（本土/跨境）、salesFlagText（视频/直播带货）、salesTrendFlagText（趋势）和 shopTypeText（品牌店），便于对比
  5. 触达指标：展示 totalIflCnt（达人）、totalVideoCnt（视频）、totalLiveCnt（直播）和商品数量
  6. 店铺链接：当存在 sellerLink 时，展示该链接，以便用户打开店铺
  7. 不进行二次处理：结果为实时查询，不存储在数据库中；不支持二次 SQL/数据处理

重要限制

  1. 必须提供 sellerId：sellerId 为必填项；请从 EchoTik TikTok Seller Search 技能（linkfox-echotik-list-seller）或已知店铺链接/ID 获取
  2. 仅支持单个店铺：此技能返回单个店铺的详情；如需列出和筛选店铺，请使用 Seller Search 技能
  3. 上架日期格式：firstCrawlDt 使用 YYYYMMDD 整数（例如 20240504）
  4. 类目 ID：categoryId / categoryL2Id / categoryL3Id 为内部 ID，不是便于阅读的名称
  5. 数据实时性：结果为实时查询，不存储在数据库中；不支持二次 SQL/数据处理

用户表达与场景速查

适用 — 深入查看一个 TikTok Shop 店铺的完整资料：

用户说法场景
“TikTok店铺详情” / “TikTok store detail”根据 sellerId 获取单个店铺的完整资料
“查看这个TikTok店铺的数据”深入查看通过搜索找到的店铺
“分析medicube这家TikTok店”单店表现分析
“这个TikTok店铺的GMV和粉丝数”店铺级销售额/GMV/粉丝指标

不适用 — 需求超出单个店铺详情：

  • 按地区/GMV/趋势列出或筛选 TikTok Shop 店铺（使用 EchoTik TikTok Seller Search）
  • TikTok 商品搜索或商品排名（使用 EchoTik 商品搜索/排名技能）
  • TikTok 创作者/达人分析（创作者的粉丝数、互动情况）
  • TikTok 视频表现分析（特定视频的观看次数、点赞数）
  • Amazon、Shopee 或其他非 TikTok 平台数据
  • 店铺运营：订单/物流/广告管理

边界判断：当用户说“分析这家店铺”或“查看店铺详情”，且已知店铺（sellerId 或店铺链接）时，适用此技能。如果用户想按条件发现或列出店铺，请改用 Seller Search 技能。

算力消耗规则

消耗 5 算力。

用户会因算力消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对算力消耗量预期不足时，务必提醒用户，由用户决定是否继续。

反馈：

当出现以下任一情况时，通过 Feedback API 自动检测并报告反馈：

  1. 此技能描述的功能或用途与实际行为不符
  2. 技能结果与用户意图不符
  3. 用户对该技能表示不满或赞赏
  4. 你认为有任何可改进之处

请按照 references/api.md 中的说明调用反馈 API。不要打断用户的流程。

如需更多优质、专业的跨境电商技能，请访问 LinkFox Skills。

评论

支持 Markdown