apify-lead-generation

リード獲得

Apify Actors を使用して、複数のプラットフォームからリードをスクレイピングします。

前提条件

（事前に確認する必要はありません）

• APIFY_TOKEN を含む .env ファイル
• Node.js 20.6+（ネイティブの --env-file サポート用）

ワークフロー

このチェックリストをコピーして、進捗を管理してください。

Task Progress:
- [ ] Step 1: Determine lead source (select Actor)
- [ ] Step 2: Fetch Actor schema
- [ ] Step 3: Ask user preferences (format, filename)
- [ ] Step 4: Run the lead finder script
- [ ] Step 5: Summarize results

Step 1: リードのソースを決める

ユーザーのニーズに基づいて、適切な Actor を選択します。

ユーザーのニーズ	Actor ID	最適な用途
地域のビジネス	compass/crawler-google-places	レストラン、ジム、店舗
連絡先情報の補完	vdrmota/contact-info-scraper	URL からメールアドレス、電話番号を取得
Instagram のプロフィール	apify/instagram-profile-scraper	インフルエンサーの発見
Instagram の投稿／コメント	apify/instagram-scraper	投稿、コメント、ハッシュタグ、場所
Instagram の検索	apify/instagram-search-scraper	場所、ユーザー、ハッシュタグの発見
TikTok の動画／ハッシュタグ	clockworks/tiktok-scraper	TikTok データの包括的な抽出
TikTok のハッシュタグ／プロフィール	clockworks/free-tiktok-scraper	無料の TikTok データ抽出
TikTok のユーザー検索	clockworks/tiktok-user-search-scraper	キーワードでユーザーを検索
TikTok のプロフィール	clockworks/tiktok-profile-scraper	クリエイターへのアプローチ
TikTok のフォロワー／フォロー中	clockworks/tiktok-followers-scraper	オーディエンス分析、セグメンテーション
Facebook ページ	apify/facebook-pages-scraper	ビジネスの連絡先
Facebook ページの連絡先	apify/facebook-page-contact-information	メールアドレス、電話番号、住所の抽出
Facebook グループ	apify/facebook-groups-scraper	購買意欲のシグナル
Facebook イベント	apify/facebook-events-scraper	イベントでのネットワーキング、パートナーシップ
Google 検索	apify/google-search-scraper	幅広いリードの発見
YouTube チャンネル	streamers/youtube-scraper	クリエイターとのパートナーシップ
Google Maps のメールアドレス	poidata/google-maps-email-extractor	メールアドレスの直接抽出

Step 2: Actor のスキーマを取得する

Actor の入力スキーマと詳細を取得します。

node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/fetch_actor_details.js --actor "ACTOR_ID"

ACTOR_ID を選択した Actor（例：compass/crawler-google-places）に置き換えます。

取得される内容：

• Actor の情報（タイトル、説明、URL、カテゴリー、統計、評価）
• README の概要
• 入力スキーマ（必須および任意のパラメーター）

Step 3: ユーザーの希望を確認する

簡単な検索（例：「Nike のフォロワー数は？」「プラハのコーヒーショップを5軒見つけて」）の場合は、このステップをスキップしてください。クイック回答モードを使用して、Step 4 に進みます。

大規模なスクレイピングタスクの場合は、次の項目を確認してください。

1. 出力形式：
   • クイック回答 - チャットに上位数件を表示（ファイルは保存しません）
   • CSV - すべてのフィールドを含む完全なエクスポート
   • JSON - JSON 形式での完全なエクスポート
2. 結果の件数：ユースケースの内容に基づいて決定します

コストの安全対策：Actor の入力では、常に妥当な結果件数の上限を設定してください（例：maxResults、resultsLimit、maxCrawledPages、または入力スキーマにある同等のフィールド）。ユーザーが明示的にそれ以上を求めない限り、結果は100件をデフォルトとしてください。大量のスクレイピング（1000件以上）を実行する前に、Apify クレジットの消費量が増えることをユーザーに警告してください。

Step 4: スクリプトを実行する

クイック回答（チャットに表示、ファイルなし）：

node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \
  --actor "ACTOR_ID" \
  --input 'JSON_INPUT'

CSV：

node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \
  --actor "ACTOR_ID" \
  --input 'JSON_INPUT' \
  --output YYYY-MM-DD_OUTPUT_FILE.csv \
  --format csv

JSON：

node --env-file=.env ${CLAUDE_PLUGIN_ROOT}/reference/scripts/run_actor.js \
  --actor "ACTOR_ID" \
  --input 'JSON_INPUT' \
  --output YYYY-MM-DD_OUTPUT_FILE.json \
  --format json

Step 5: 結果を要約する

完了後、次の内容を報告します。

• 見つかったリードの件数
• ファイルの場所と名前
• 利用できる主なフィールド
• 提案する次のステップ（絞り込み、情報の補完）

エラー処理

APIFY_TOKEN not found - APIFY_TOKEN=your_token を含む .env を作成するようユーザーに依頼します Actor not found - Actor ID のつづりを確認します Run FAILED - エラー出力にある Apify コンソールのリンクを確認するようユーザーに依頼します Timeout - 入力サイズを小さくするか、--timeout を増やします