finding-twitter-spaces-hosts-by-topic

トピック別にTwitter Spacesのホストを検索

apidojoのスクレイパーを使用して、トピック別にTwitter Spacesのホストを検索します。apidojoインテリジェンススキルライブラリの一部です。

前提条件

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

入力

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

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

Apify MCPが利用可能な場合：

Tool: apify:run-actor
Actor: "apidojo~tweet-scraper"
Input:
{
  "searchTerms": ["Twitter Spaces [TOPIC]", "join my Space [TOPIC]", "hosting a Space about [TOPIC]", "upcoming Space [TOPIC]"],
  "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": ["Twitter Spaces [TOPIC]", "join my Space [TOPIC]", "hosting a Space about [TOPIC]", "upcoming Space [TOPIC]"], "maxItems": 100}'

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

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

ステップ3：結果を分類する

classification: REGULAR_HOST (> 2 Spaces/month) | OCCASIONAL_HOST (1-2/month) | ONE_TIME (single event) | UPCOMING (announced future Space)

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

score = spaces_host_score = (hosts_regularly: > 2/month = 1, 1/month = 0.6) * 0.40 + (followerCount > 2000 ? 1 : followerCount/2000) * 0.35 + (topic_alignment ? 1 : 0.5) * 0.25

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

• Twitter Spacesの告知ツイートには、必ずしも #Spaces が含まれるとは限りません。Spacesに特化したツイートを特定するには、「link in bio」+「Space」で検索するか、SpacesカードのURLパターン（twitter.com/i/spaces/）を検索してください

その他のフォールバック：

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

出力形式

# Finding Twitter Spaces Hosts By Topic
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のステータスを確認します。