tracking-competitor-social-media-growth

競合他社のソーシャルメディアの成長を追跡する

Twitter/X、TikTok、Instagram の競合アカウントについて、現在のフォロワー数とエンゲージメント指標を取得します。競合状況を並べて比較できるスナップショットを作成します。継続的な追跡のため、スケジュールに従って実行するよう設計されています。

前提条件

• APIFY_TOKEN 環境変数が設定されていること
• 任意：Apify MCP サーバーがインストールされていること

入力

パラメーター	型	必須	デフォルト	備考
startUrls	array	任意	[]	Twitter のプロフィールまたはツイートの URL
twitterHandles	array	任意	[]	Twitter のユーザー名（@なし）
twitterUserIds	array	任意	[]	Twitter のユーザー ID
getFollowers	boolean	任意	false	フォロワー一覧を抽出します
getFollowing	boolean	任意	false	フォロー中のユーザー一覧を抽出します
getRetweeters	boolean	任意	false	ツイート URL のリツイートユーザーを抽出します
includeUnavailableUsers	boolean	任意	false	利用できないユーザーや停止中のユーザーを含めます
maxItems	number	任意	無制限	返すユーザーの最大数
customMapFunction	string	任意	—	各出力オブジェクトを変換する 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 — 1 つまたはすべて）
• 自分のアカウントを含めますか？（デフォルト：はい — 直接比較するため）

ステップ 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

環境変数または .env ファイルに APIFY_TOKEN を設定する必要があります。

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：レポートを作成する

プラットフォームごとにアカウントのエンゲージメント率を計算します。すべてを 1 つの画面で比較します。

出力形式

# 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 時にこのスキルを実行するスケジュール済みタスクを使用します。

トラブルシューティング

プラットフォームのハンドルが不足している場合： ユーザーにプラットフォームごとのハンドルを尋ねます。ブランド名と異なることがよくあります。 あるプラットフォームでデータが返されない場合： アカウントが非公開であるか、そのプラットフォームに存在しない可能性があります。ハンドルが正しいことを確認します。