菜单
通过 ClawEC API 对 TikTok Shop 品类做选品机会分析（热销排行、阶段判断、进入窗口、达人/视频趋势），可选 AI 解读。在用户需要 TikTok 选品机会、品类扫描、product opportunity、TikTok 选品调研、/tool/tiktok-product-research 时使用。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | clawec-tiktok-product-research |
| description | 通过 ClawEC API 对 TikTok Shop 品类做选品机会分析（热销排行、阶段判断、进入窗口、达人/视频趋势），可选 AI 解读。在用户需要 TikTok 选品机会、品类扫描、product opportunity、TikTok 选品调研、/tool/tiktok-product-research 时使用。 |
ClawEC（虾船长）是跨境电商一站式 AI 工具箱，覆盖 TikTok Shop、Amazon 等主流平台的选品、调研、运营与合规场景。平台将分散的数据查询与人工分析沉淀为可复用的 Web 工具与开放 API，并配合 AI 解读与定时任务，帮助卖家在单人或少人条件下完成从市场洞察到决策落地的闭环。
在 TikTok Shop 方向，ClawEC 可做的事包括：选品机会分析（扫描品类近 7 天热销、判断商品阶段与进入窗口）、商品分析（拆解渠道分布、内容形式与付费/自然流量）、店铺分析（查看店铺规模、类目/地区排名与自营品牌账号）。本技能调用选品机会分析 API，与 Web 端 /tool/tiktok-product-research 页面一致。
https://www.clawec.com/apiContent-Type: application/jsonAuthorization: Bearer <API_KEY>优先从环境变量 CLAWEC_API_KEY 读取密钥；未设置时向用户索取，勿硬编码。
Step 1 POST /aigc/ec/tiktok/product_opportunity/search → 提交分析
Step 2 GET /aigc/ec/tiktok/product_opportunity/search/logs → 定位本次记录
Step 3 GET /aigc/ec/tiktok/product_opportunity/search/log/detail → 获取完整结果
Step 4 （aiInterpret=true 时）轮询 log/detail → 等待 AI 解读完成
Web 端通过 WebSocket tiktok_product_opportunity_result_refresh 推送刷新；脚本场景用 轮询 log/detail 即可。
完整 API 字段见 docs/tiktok-product-research-api.md。
POST /aigc/ec/tiktok/product_opportunity/search
| 参数 | 必填 | 说明 |
|---|---|---|
| region | 是 | 目标市场代码（见下表） |
| category | 是 | 品类关键词或名称，如「瑜伽裤」「手机壳」，用于匹配 TikTok 类目 |
| days | 否 | 分析周期天数，默认 7，对应近 N 天销量/GMV 等指标 |
| aiInterpret | 否 | 是否开启 AI 解读，默认 false |
| 代码 | 市场 |
|---|---|
| US | 美国 |
| UK | 英国 |
| ID | 印度尼西亚 |
| TH | 泰国 |
| MY | 马来西亚 |
| PH | 菲律宾 |
| VN | 越南 |
| SG | 新加坡 |
| BR | 巴西 |
| MX | 墨西哥 |
| DE | 德国 |
| FR | 法国 |
| IT | 意大利 |
| ES | 西班牙 |
| JP | 日本 |
未指定 region 时默认 US；未指定 days 时默认 7。
curl -s -X POST "https://www.clawec.com/api/aigc/ec/tiktok/product_opportunity/search" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $CLAWEC_API_KEY" \
-d '{"region":"US","category":"瑜伽裤","days":7,"aiInterpret":true}'
或使用脚本：
# 品类 + 市场 + 天数
bash scripts/search.sh "瑜伽裤" US 7
# 开启 AI 解读
bash scripts/search.sh "手机壳" US 7 --ai
GET /aigc/ec/tiktok/product_opportunity/search/logs
| 参数 | 说明 |
|---|---|
| start | 分页索引，从 1 开始 |
| size | 每页条数，默认 20 |
| begin | 可选，开始时间戳 |
| end | 可选，结束时间戳 |
bash scripts/logs.sh 1 20
返回 data.items 为历史记录数组。提交分析后，按 param.region、param.category、param.days 匹配本次记录，取 id 作为详情查询参数。
GET /aigc/ec/tiktok/product_opportunity/search/log/detail?id=<记录ID>
bash scripts/log_detail.sh 123456789
详情 data 字段含完整分析结果，以及 AI 相关字段（若开启解读）：
| 字段 | 说明 |
|---|---|
| param | 原始搜索参数 |
| data.categoryInfo | 解析后的类目信息 |
| data.categoryOverview | 类目竞争与市场概览 |
| data.items | 热销/机会商品排行 |
| data.openWindowCount | 对新卖家仍开放进入窗口的商品数量 |
| aiStatus | appending 解读中；success 已完成；fail 失败 |
| aiStatusDesc | AI 解读状态描述 |
| aiAnalysis | AI 解读正文（Markdown） |
| 字段 | 说明 |
|---|---|
| categoryName | 类目中文名 |
| categoryFullName | 类目完整路径 |
| matchScore | 匹配分数 |
| 字段 | 说明 |
|---|---|
| basicMetrics | 基础指标（类目规模、竞争密度等） |
| salesTrends | 销售趋势指标 |
| authorSalesMatrix | 达人带货矩阵（不同粉丝层级销售贡献） |
| competitionDensity | 竞争密度：低/中/高 |
| competitionDesc | 竞争密度说明 |
| 字段 | 说明 |
|---|---|
| rank | 排名 |
| productId / productName / cover / price | 商品 ID、名称、封面、价格 |
| day7UnitsSold / day7Gmv | 近 7 天销量 / GMV |
| totalUnitsSold / totalGmv | 累计销量 / GMV |
| growthRate | 增长率 |
| creatorCount / videoCount / sellerCount | 带货达人数 / 视频数 / 卖家数 |
| creatorTrend / videoTrend | 达人/视频趋势描述 |
| stage / stageDesc | 阶段：NEW/GROWTH/EXPLOSIVE/STABLE → 新品/成长/爆发/稳定 |
| entryWindowOpen / entryWindowReason | 进入窗口是否开放及说明 |
| fromNewListed | 是否来自新品榜 |
| detailUrl | 商品详情链接 |
| shop | 店铺信息 |
当 aiInterpret=true 时，分析完成后 AI 解读为异步任务：
log/detail，检查 aiStatusaiStatus === "appending" 或尚无 aiStatus 时，等待 3–5 秒 后重试aiStatus === "success" 时读取 aiAnalysis 并输出aiStatus === "fail" 时告知用户解读失败，仍可输出原始分析数据一键执行（分析 + 定位记录 + 拉详情 + AI 轮询）：
bash scripts/search_and_poll.sh "瑜伽裤" US 7 --ai
{
"status": 1,
"code": 200,
"msg": "success",
"data": { ... },
"pointInfo": { "type": 0, "point": 0 }
}
status: 1 = 成功，0 = 失败code: 业务码；2001 = 未登录/Token 无效，2002 = 积分不足data: 业务数据pointInfo: 积分消耗信息region、品类关键词 category、分析周期 days（默认 7）aiInterpret=trueCLAWEC_API_KEY 是否可用dataaiStatus 为 success 或 fail默认中文摘要，包含：
categoryInfo.categoryFullName、匹配分数openWindowCount、结果条数entryWindowOpen=true 的商品及原因aiAnalysis；失败时说明状态输入：美国站，品类「phone case」，近 7 天，需要 AI 解读
步骤：
bash scripts/search_and_poll.sh "phone case" US 7 --ai
输出摘要：
| 指标 | 值 |
|---|---|
| 匹配类目 | 手机配件 > 手机壳 |
| 竞争密度 | 中 |
| 开放窗口商品数 | 8 |
| 结果条数 | 50 |
Top 机会品：#1 iPhone 15 Case — 阶段：成长，近7天销量 12K，进入窗口：开放 …
AI 解读：（Markdown 正文摘要）
通过 ClawEC API 进行亚马逊 ABA 选品（按类目与时间维度分析 ABA 市场趋势，发现热门与异动关键词，支持搜索模式筛选与 AI 解读）。在用户需要 ABA 选品、亚马逊 ABA 选品、market trend、市场趋势选品、/tool/market-trend-analysis 时使用。
通过 ClawEC API 分析亚马逊 ASIN 优势（详情、销量趋势、销量预测），可选 AI 解读。在用户需要 asin advantage、ASIN 优势分析时使用。
通过 ClawEC API 分析亚马逊 ASIN 流量来源（关键词流向、关联流量、流量词、出单词），可选 AI 解读。在用户需要 asin traffic source、流量来源分析时使用。
通过 ClawEC API 分析亚马逊细分市场（市场统计、商品/品牌/卖家集中度），可选 AI 解读。在用户需要 category research、细分市场研究、类目分析时使用。
通过 ClawEC API 查询亚马逊竞品（按品牌/卖家/ASIN/关键词），可选 AI 解读。在用户需要竞品监控、competitor monitor、竞品 lookup 时使用。
通过 ClawEC API 分析亚马逊关键词（ABA、关键词挖掘、关键词趋势），可选 AI 解读。在用户需要 keyword search、关键词分析、关键词挖掘时使用。