tracking-competitor-social-media-growth

跟踪竞争对手的社交媒体增长

获取竞争对手在 Twitter/X、TikTok 和 Instagram 上的最新粉丝数量及互动指标，生成并排的竞争态势快照。可按计划定期运行，以持续跟踪。

前置条件

• 已设置 APIFY_TOKEN 环境变量
• 可选：已安装 Apify MCP 服务

输入

参数	类型	必填	默认值	说明
startUrls	数组	可选	[]	Twitter 个人资料或推文 URL
twitterHandles	数组	可选	[]	Twitter 用户名（不带 @）
twitterUserIds	数组	可选	[]	Twitter 用户 ID
getFollowers	布尔值	可选	false	提取粉丝列表
getFollowing	布尔值	可选	false	提取关注列表
getRetweeters	布尔值	可选	false	提取某推文 URL 的转推者
includeUnavailableUsers	布尔值	可选	false	包含不可用或已暂停的用户
maxItems	数字	可选	不限	返回的最大用户数
customMapFunction	字符串	可选	—	用于转换每个输出对象的 JavaScript 函数

工作流

Progress:
- [ ] Step 1: Define competitors and target platforms
- [ ] Step 2: Scrape Twitter/X profiles
- [ ] Step 3: Scrape TikTok profiles
- [ ] Step 4: Scrape Instagram profiles
- [ ] Step 5: Compile cross-platform comparison

步骤 1：确认参数

询问用户：

• 各平台的竞争对手账号 — 例如：
  • Twitter：@competitorA、@competitorB
  • TikTok：@competitorA、@competitorB
  • Instagram：@competitorA、@competitorB
• 要分析的平台（Twitter、TikTok、Instagram——一个或全部）
• 是否包含自己的账号？（默认：是——便于直接对标）

步骤 2：抓取 Twitter/X 个人资料

推荐 — run_actor.js（自动处理等待、输出和文件保存）：

# Quick answer (prints table to chat)
node scripts/run_actor.js \
  --actor "apidojo~twitter-user-scraper" \
  --input '{"param": "value"}'

# Save as CSV
node scripts/run_actor.js \
  --actor "apidojo~twitter-user-scraper" \
  --input '{"param": "value"}' \
  --output YYYY-MM-DD_results.csv --format csv

# Save as JSON
node scripts/run_actor.js \
  --actor "apidojo~twitter-user-scraper" \
  --input '{"param": "value"}' \
  --output YYYY-MM-DD_results.json --format json

APIFY_TOKEN 必须在环境变量或 .env 文件中设置。

如果 Apify MCP 可用：

Tool: apify:run-actor
Actor: "apidojo~twitter-user-scraper"
Input:
{
  "usernames": ["[handle1]", "[handle2]", "[handle3]", "[your_handle]"]
}

REST API 备用方案：

curl -X POST \
  "https://api.apify.com/v2/acts/apidojo~twitter-user-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"usernames": ["[handle1]", "[handle2]"]}'

需要提取的关键字段：followersCount、followingCount、statusesCount、createdAt、verified。

步骤 3：抓取 TikTok 个人资料

如果 Apify MCP 可用：

Tool: apify:run-actor
Actor: "apidojo~tiktok-profile-scraper"
Input:
{
  "usernames": ["[handle1]", "[handle2]", "[handle3]"]
}

REST API 备用方案：

curl -X POST \
  "https://api.apify.com/v2/acts/apidojo~tiktok-profile-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"usernames": ["[handle1]", "[handle2]"]}'

关键字段：fans（粉丝）、heart（总点赞数）、video（视频数量）、diggCount。

步骤 4：抓取 Instagram 个人资料

如果 Apify MCP 可用：

Tool: apify:run-actor
Actor: "apidojo~instagram-scraper"
Input:
{
  "usernames": ["[handle1]", "[handle2]"],
  "maxItems": 12
}

REST API 备用方案：

curl -X POST \
  "https://api.apify.com/v2/acts/apidojo~instagram-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"usernames": ["[handle1]", "[handle2]"], "maxItems": 12}'

关键字段：followersCount、followsCount、postsCount、biography。

步骤 5：汇总报告

计算各平台每个账号的互动率，并在同一视图中进行比较。

输出格式

# Competitive Social Media Analysis
Competitors: [N] | Platforms: [list] | Date: [DATE]

## Cross-Platform Follower Summary

| Competitor | Twitter Followers | TikTok Followers | Instagram Followers | Total Reach |
|------------|-------------------|------------------|---------------------|-------------|
| [Your Brand] | [N]             | [N]              | [N]                 | [N]         |
| Competitor A | [N]             | [N]              | [N]                 | [N]         |
| Competitor B | [N]             | [N]              | [N]                 | [N]         |

## Platform-by-Platform Analysis

### Twitter/X
| Account | Followers | Following | Tweets | Eng. Rate | Verified |
|---------|-----------|-----------|--------|-----------|----------|
| @[handle] | [N]     | [N]       | [N]    | [X.X%]    | [Y/N]    |
**Leader:** [handle] with [N] followers | **Most engaged:** [handle] at [X.X%]

### TikTok
| Account | Followers | Total Likes | Videos | Avg Views |
|---------|-----------|-------------|--------|-----------|
| @[handle] | [N]     | [N]         | [N]    | [N]       |
**Leader:** [handle] | **Most viral:** [handle]

### Instagram
| Account | Followers | Posts | Avg Likes | Eng. Rate |
|---------|-----------|-------|-----------|-----------|
| @[handle] | [N]     | [N]   | [N]       | [X.X%]    |

## Key Takeaways
1. [Competitor] is winning on [platform] — [brief insight]
2. [Your brand] has [strength/gap] on [platform]
3. Biggest opportunity: [specific platform + action]

设置定期跟踪

如需跟踪一段时间内的增长，请每周运行此技能并保存输出。两次运行结果之间的差值可显示增长速度。要自动进行每周跟踪，可设置定时任务，在每周一上午 9 点运行此技能。

故障排除

缺少平台账号： 请用户提供各平台的账号名——账号名通常与品牌名称不同。 某个平台未返回数据： 账号可能是私密账号，或在该平台上不存在。请确认账号名是否准确。