analyzing-competitor-twitter-profile-content

競合他社のTwitterプロフィールコンテンツを分析する

---

入力

パラメーター	型	必須	デフォルト	備考
startUrls	配列	任意	[]	TwitterプロフィールのURL（x.comまたはtwitter.com形式）
twitterHandles	配列	任意	[]	Twitterユーザー名（@なし）
start	文字列	任意	—	この日付以降のツイート（YYYY-MM-DDまたはYYYY-MM-DD_HH:MM:SS_UTC）
end	文字列	任意	—	この日付より前のツイート（YYYY-MM-DDまたはYYYY-MM-DD_HH:MM:SS_UTC）
includeNativeRetweets	ブール値	任意	false	結果にネイティブのリツイートを含める
onlyImages	ブール値	任意	false	画像を含むツイートのみ
getReplies	ブール値	任意	false	ツイートへの返信を含める
minReplyCount	数値	任意	—	返信数の最小しきい値
getAboutData	ブール値	任意	false	プロフィールの概要データをすべて取得する
maxItems	数値	任意	無制限	返すツイートの最大数
customMapFunction	文字列	任意	—	各出力オブジェクトを変換するJavaScript関数

実行方法

run_actor.jsを使用する（推奨）

# Quick answer (table)
node scripts/run_actor.js --actor "apidojo~twitter-profile-scraper" --input '{"twitterHandles": ["competitor_handle"], "maxItems": 100}'

# Save as CSV
node scripts/run_actor.js --actor "apidojo~twitter-profile-scraper" --input '{"twitterHandles": ["competitor_handle"], "maxItems": 100}' --output results.csv --format csv

# Save as JSON
node scripts/run_actor.js --actor "apidojo~twitter-profile-scraper" --input '{"twitterHandles": ["competitor_handle"], "maxItems": 100}' --output results.json --format json

REST APIの代替手段

curl -X POST "https://api.apify.com/v2/acts/apidojo~twitter-profile-scraper/runs" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"twitterHandles": ["competitor_handle"], "maxItems": 100}'

Apify MCPを利用できる場合： Apify MCPのcall_actorツールで、アクターapidojo~twitter-profile-scraperを使用し、上記の入力を渡します。

---

スコアリングとランキング

競争に関するインテリジェンスとしての価値に基づき、各ツイートを採点します：

• engagement_total = likeCount + retweetCount + replyCount + quoteCount → 0～1に正規化（上限10K）、重み0.50
• viewCount → 0～1に正規化（上限500K）、重み0.30
• has_media（画像または動画を含む）→ 0または1、重み0.20

score = 0.50 * min(engagement_total / 10000, 1.0) + 0.30 * min(viewCount / 500000, 1.0) + 0.20 * int(has_media)

---

分類

スコア	ティア	ラベル
≥ 0.70	A	HIGH_IMPACT_TWEET
0.40–0.69	B	NOTABLE_TWEET
< 0.40	C	LOW_ENGAGEMENT

---

エッジケース

• 非公開アカウント：ツイートを0件返します。競合他社がアカウントをロックしていないか確認してください。
• 最低40件のツイート：基本料金には最初の40件が含まれます。それ以上は1ツイートあたり$0.0004です。
• リツイートを含む：結果にはRTが含まれます。テキストが「RT @」で始まるか確認してフィルタリングしてください。
• 日付範囲内の結果が少ない：投稿頻度の低いアカウントもあります。日付範囲を広げるか、フィルターを解除してください。
• 複数の競合他社：ハンドルごとに個別に実行し、データセットを統合してください。