用途
该技能用于绘制某一商品品类下的 TikTok Shop 卖家图景。它帮助识别哪些商品正在被大量推广、哪些创作者产出了最多的销售内容，以及存在哪些商品空白。适用触发场景为用户要求“按细分品类查找 TikTok Shop 卖家”等相关请求。
主要能力
- 通过细分品类话题标签（如 #tiktokshop[niche]、#[niche]shop、#[niche]deals、#tiktokmademebuyit、#[niche]affiliate、#[niche]haul）搜索内容。
- 过滤带有 Shop 商品链接的帖子。
- 提取卖家资料与商品。
- 依据销售信号强度对卖家排名。
- 输出卖家/商品地图，包含竞争层级与潜在空白分析。
输入参数
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
| startUrls | array | 否 | [] | TikTok 链接——用户主页、话题标签、音乐页、搜索、地点 |
| keywords | array | 否 | [] | 用于查找帖子的搜索关键词/词条 |
| sortType | string | 否 | RELEVANCE | 关键词结果排序：RELEVANCE、MOST_LIKED、DATE_POSTED |
| location | string | 否 | — | ISO 3166-1 alpha-2 国家代码，用于地区筛选（如 US、GB） |
| maxItems | number | 否 | Unlimited | 本次运行返回的最大帖子数 |
| includeSearchKeywords | boolean | 否 | false | 为每条帖子添加匹配到的搜索关键词字段 |
| customMapFunction | string | 否 | — | 用于转换每个输出对象的 JavaScript 函数 |
工作流程
- 使用带 TikTok Shop 信号的细分品类话题标签进行搜索。
- 筛选带有 Shop 商品链接的帖子。
- 提取卖家资料与商品。
- 按销售信号强度排名。
- 交付卖家/商品地图。
第一步：搜索话题标签
# Quick answer (prints table to chat)
node scripts/run_actor.js \
--actor "apidojo~tiktok-scraper" \
--input '{"param": "value"}'
# Save as CSV
node scripts/run_actor.js \
--actor "apidojo~tiktok-scraper" \
--input '{"param": "value"}' \
--output YYYY-MM-DD_results.csv --format csv
# Save as JSON
node scripts/run_actor.js \
--actor "apidojo~tiktok-scraper" \
--input '{"param": "value"}' \
--output YYYY-MM-DD_results.json --format json
APIFY_TOKEN 必须设置在环境变量或 .env 文件中。
若 Apify MCP 可用，使用工具 apify:run-actor，Actor 为 apidojo~tiktok-scraper，输入示例：
{
"keywords": ["#tiktokshop", "#[niche]shop", "#tiktokmademebuyit"],
"maxItems": 300
}
REST API 备选方式：
curl -X POST "https://api.apify.com/v2/acts/apidojo~tiktok-scraper/runs?token=$APIFY_TOKEN" -H "Content-Type: application/json" -d '{
"keywords": ["#tiktokshop", "#kitchentools", "#tiktokmademebuyit"],
"maxItems": 300
}'
第二步：评分卖家强度
sales_signal = (playCount / 10000) * 0.35
+ (diggCount / 1000) * 0.25
+ (commentCount / 100) * 0.15
+ (shareCount / 500) * 0.15
+ (hasShopLink ? 1 : 0) * 0.10
归一化到 [0, 1]。拥有多条高信号帖子的卖家获得 multi_post_bonus = 0.15。
第三步：分类卖家类型
- BRAND = 账号已认证 或 粉丝数 > 50K 且简介含品牌名
- CREATOR_AFFILIATE = 个人账号，按销售赚取佣金
- DROPSHIPPER = 发布多个无关商品且描述通用
第四步：边界情况
- 结果中非 Shop 帖子：丢弃标题无 Shop 信号且无商品链接的帖子。
- 同一商品由多名创作者发布：按商品名去重；统计独立推广者数量作为“销售势头”信号。
- 饱和品类（活跃卖家 > 50）：标记为 HIGH_COMPETITION；给出空白分析（服务不足的子细分）。
- 单条爆款抬高的播放量：使用卖家最近 10 条帖子播放量的中位数作为信号，而非最大值。
输出格式
# TikTok Shop Seller Map: [NICHE]
Posts scanned: [N] | Unique sellers: [N] | Brands: [N] | Creator-affiliates: [N] | Date: [DATE]
## Top Sellers by Sales Signal
| Seller | Type | Product(s) | Avg Views/Post | Shop Posts | Signal Score |
|--------|------|-----------|----------------|-----------|-------------|
| @[handle] | Creator | [product] | [N] | [N] | [0.XX] |
## Top Products (by Promotion Frequency)
| Product Name | # Sellers Promoting | Avg Post Views | Price Range |
|-------------|--------------------|--------------------|-------------|
| [product] | [N] | [N] | $[X]-$[X] |
## Market Saturation
Competition level: [LOW / MEDIUM / HIGH] ([N] active sellers)
Potential gap: [sub-niche or product type with < 3 sellers]
故障排查
- 话题标签返回非 Shop 内容：在同一次搜索中将细分品类话题标签与 #tiktokshop 组合，以锚定带 Shop 链接的帖子。
- 无法确定商品价格：TikTok Shop 价格并非总在视频中——注意 URL 模式包含商品 ID，可手动交叉查询。
- 结果全部来自单个超级达人：添加 max_posts_per_creator = 5，以呈现更多样的卖家。
适用场景
适合电商选品、达人营销、竞品调研、品类空白分析等需要从 TikTok Shop 内容中挖掘卖家与商品情报的场景。
限制
需设置 APIFY_TOKEN；可选安装 Apify MCP 服务器。部分数据（如商品价格）资料中明确指出不一定能从视频中获取。