analyzing-tiktok-hashtag-performance

用途

「分析 TikTok 话题标签表现」（analyzing-tiktok-hashtag-performance）是一个技能，用于抓取 TikTok 话题标签页面，提取表现最佳的视频、互动数据和创作者信息，并对多个话题标签进行并列对比，以判断在特定内容类别中哪些标签能带来最佳覆盖效果。

主要能力

抓取 TikTok 话题标签页面，获取高表现视频、互动数据和创作者信息。
对比多个话题标签，识别对特定内容类别覆盖效果最好的标签。
计算话题标签级别指标，包括抽样总播放量、平均播放量、平均点赞量、平均评论量、互动率与竞争程度（基于时间戳估算每日新增视频数）。
展示每个标签下按播放量排序的前 3 个视频及创作者，以及在该标签头部内容中出现频率最高的前 3 位创作者。
依据描述/文案归纳头部视频中常见的内容形式。
输出话题标签对比表，并给出推荐的话题标签组合策略（主标签、次级标签、微标签）。

使用方式

前提条件：设置 APIFY_TOKEN 环境变量；可选安装 Apify MCP 服务器。

输入参数（可选）：

参数	类型	必填	默认	说明
startUrls	array	否	[]	TikTok URL —— 用户主页、话题标签、音乐页、搜索、地点
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 函数

运行方式（推荐 run_actor.js，自动处理等待、输出和文件保存）：

快速回答（在对话中打印表格）：

node scripts/run_actor.js \
  --actor "apidojo~tiktok-scraper" \
  --input '{"param": "value"}'

保存为 CSV：

node scripts/run_actor.js \
  --actor "apidojo~tiktok-scraper" \
  --input '{"param": "value"}' \
  --output YYYY-MM-DD_results.csv --format csv

保存为 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": ["[hashtag1]", "[hashtag2]", "[hashtag3]"],
  "shouldDownloadCovers": false
}

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": ["[hashtag1]", "[hashtag2]", "[hashtag3]"]
  }'

等待状态为 SUCCEEDED 后获取数据集。

工作流程：

明确参数：向用户询问要分析的话题标签（最多 10 个，不含 #）、每个标签的帖子数（默认 30）、分析目标（为发帖选择标签、审计竞争对手的标签策略或一般研究）。若用户尚未提供标签并希望获得推荐，询问内容领域（如「fitness」「cooking」「personal finance」），然后生成组合：2 个超大标签（1 亿以上浏览量）、3 个中量级（1000 万–1 亿）、3 个细分（100 万–1000 万）、2 个微型（100 万以下）。
对每个话题标签运行 Actor。
计算话题标签指标：total_views_sampled = sum(video.playCount)；avg_views_per_video = total_views_sampled / num_videos；avg_likes_per_video = sum(video.diggCount) / num_videos；avg_comments_per_video = sum(video.commentCount) / num_videos；engagement_rate = (avg_likes + avg_comments) / avg_views * 100；competition_level = num_videos_per_day（基于时间戳估算）。若可用，使用 challengeInfo.stats.videoCount 作为话题标签总规模的代理指标。
识别头部内容和创作者：每个标签列出按播放量排序的前 3 个视频（含创作者账号和视频 URL）、在该标签头部内容中出现频率最高的前 3 位创作者，以及头部视频中常见的内容形式（基于描述/文案）。
格式化输出，包括话题标签对比表（标签、平均播放量、平均点赞量、互动率、竞争程度、结论）、详细分解（平均播放量、互动率、竞争程度及约每日新增帖子数、头部视频、主导内容形式、建议）、推荐的话题标签策略（主标签 1–2 个、次级标签 2–3 个、微标签 1–2 个），以及这些标签中的头部创作者。

适用场景

为发帖选择话题标签。
审计竞争对手的话题标签策略。
进行一般性话题标签研究。
对比多个话题标签，找出在特定内容领域中覆盖效果最佳的标签。

限制与排查

需要 APIFY_TOKEN 环境变量；依赖 apidojo 的 TikTok 抓取器（apidojo~tiktok-scraper）和 Apify。
播放量极低：话题标签可能拼写错误或非常新，需核实拼写并尝试其他版本。
所有结果看起来相同：超大标签（#fyp、#foryou）呈现的是算法推广内容而非自然内容，建议使用细分标签以获得更好信号。
互动率看似过高或过低：互动率因内容类型差异很大，应在同一内容形式内进行比较以公平基准。
其他收费、价格、平台或效果信息暂未提供。

输出格式

# TikTok Hashtag Performance Analysis
Hashtags analyzed: [N] | Posts sampled per hashtag: [30] | Date: [DATE]

## Hashtag Comparison Table

| Hashtag | Avg Views | Avg Likes | Eng. Rate | Competition | Verdict |
|---------|-----------|-----------|-----------|-------------|---------|
| #[name] | [N]       | [N]       | [X.X%]    | [Low/Med/High] | [Use / Test / Avoid] |

## Detailed Breakdown

### #[hashtag1]
- Avg views per post: [N]
- Engagement rate: [X.X%]
- Competition level: [Low / Medium / High] — approx [N] new posts/day
- Top video: "[creator]" — [N] views | [url]
- Dominant content format: [e.g., tutorial, reaction, storytelling]
- **Recommendation:** [Use as primary / Layer with broader tags / Avoid — too saturated]

### #[hashtag2]
[same structure]

## Recommended Hashtag Strategy
For maximum reach on [CONTENT NICHE], use this combination:
- Primary (1-2 hashtags): [#hashtag] — broad reach driver
- Secondary (2-3 hashtags): [#hashtag] — niche relevance
- Micro (1-2 hashtags): [#hashtag] — community engagement

## Top Creators in These Hashtags
[Creators who appear most in top-performing content across all analyzed hashtags]
1. @[handle] — [N] top videos found | [N] followers