tracking-product-launch-buzz-on-twitter

Twitter での製品ローンチの話題を追跡

apidojo スクレーパーを使用して、Twitter での製品ローンチの話題を追跡します。apidojo インテリジェンススキルライブラリの一部です。

前提条件

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

入力

パラメーター	型	必須	デフォルト	備考
searchTerms	array	✅	[]	Twitter の高度な検索クエリ（例：["#AI lang:en", "from:NASA"]）
sort	string	任意	Top	並べ替え順：Latest、Top、または Latest+Top
tweetLanguage	string	任意	—	ISO 639-1 言語コード（例：en）
maxItems	number	任意	無制限	返すツイートの最大数
onlyVerifiedUsers	boolean	任意	false	認証済みユーザーのツイートのみ
onlyTwitterBlue	boolean	任意	false	Twitter Blue 登録者のツイートのみ
onlyImage	boolean	任意	false	画像付きのツイートのみ
onlyVideo	boolean	任意	false	動画付きのツイートのみ
onlyQuote	boolean	任意	false	引用ツイートのみ
author	string	任意	—	特定のユーザー名に絞り込み
inReplyTo	string	任意	—	特定のユーザー名への返信ツイート
mentioning	string	任意	—	特定のユーザー名に言及しているツイート
geotaggedNear	string	任意	—	場所の近くにあるツイート
withinRadius	string	任意	—	geotaggedNear の周囲の半径
geocode	string	任意	—	緯度・経度と半径を指定する文字列
placeObjectId	string	任意	—	場所がタグ付けされたツイート
minimumRetweets	number	任意	—	リツイート数の最小値
minimumFavorites	number	任意	—	いいね数の最小値
minimumReplies	number	任意	—	返信数の最小値
start	string	任意	—	この日付以降のツイート（YYYY-MM-DD）
end	string	任意	—	この日付以前のツイート（YYYY-MM-DD）
includeSearchTerms	boolean	任意	false	各ツイートに一致した検索語を追加
customMapFunction	string	任意	—	各出力オブジェクトを変換する JavaScript 関数

ワークフロー

Progress:
- [ ] Step 1: Define parameters
- [ ] Step 2: Run tweet-scraper
- [ ] Step 3: Filter and classify results
- [ ] Step 4: Score by quality and relevance
- [ ] Step 5: Deliver output

ステップ 2：Actor を実行

推奨 — run_actor.js（待機、出力、ファイル保存を自動処理）：

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

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

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

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

Apify MCP が利用できる場合：

Tool: apify:run-actor
Actor: "apidojo~tweet-scraper"
Input:
{
  "searchTerms": ["[PRODUCT] launch", "[PRODUCT] just launched", "new [PRODUCT]", "[PRODUCT] release"],
  "maxItems": 100
}

REST API による代替方法：

curl -X POST \
  "https://api.apify.com/v2/acts/apidojo~tweet-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms": ["[PRODUCT] launch", "[PRODUCT] just launched", "new [PRODUCT]", "[PRODUCT] release"], "maxItems": 100}'

SUCCEEDED を待ちます。データセットを取得します：

curl "https://api.apify.com/v2/actor-runs/$RUN_ID/dataset/items?token=$APIFY_TOKEN"

ステップ 3：結果を分類

classification: VIRAL (> 1000 mentions/hour) | HIGH_BUZZ (100-1000/hour) | MODERATE (10-100/hour) | LOW (< 10/hour)

ステップ 4：各結果をスコアリング

score = buzz_score = tweet_volume_24h * 0.35 + weighted_sentiment * 0.35 + influencer_mention_count * 0.30

ステップ 5：エッジケース

• 製品ローンチのツイートは48時間以内に急増した後、減少します。ピーク時の兆候を捉えるにはローンチから24～72時間以内に実行してください。古いローンチでは、誤解を招くほど件数が少なくなります

その他の代替策：

• 結果が20件未満：検索語を広げ、二次フィルターを削除します
• 結果がない：検索語が正しいことを確認し、別の表現を試します
• データ品質の問題：重要なフィールドが欠けている項目を削除し、出力に件数を記載します

出力形式

# Tracking Product Launch Buzz On Twitter
Results: [N] | Date: [DATE]

| # | [Key Field] | [Metric 1] | [Metric 2] | [Classification] | [Score] |
|---|------------|-----------|-----------|-----------------|---------|
| 1 | [value] | [value] | [value] | [type] | [0.XX] |

## Summary
Top result: [description]
Key finding: [insight]

トラブルシューティング

結果が少なすぎる場合： 主な検索語を広げ、制限の厳しいフィルターを削除します。 結果の品質が低い場合： 最小スコアしきい値（≥ 0.50）を適用してノイズを除外します。 Actor の実行に失敗する場合： API キーを確認し、apify.com/apidojo で Actor のステータスを確認します。