apify-lead-generation

リード獲得

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

使用する場面

• 地図、検索、ソーシャル、動画プラットフォームから、企業、クリエイター、連絡先のリードを取得する必要がある場合。
• 見込み顧客を見つけてアプローチ用データを抽出するために、Apify Actor を選択するタスクの場合。
• エクスポートしたリードデータと、リードの品質やセグメント分けに関する簡潔な概要が必要な場合。

前提条件

有料実行の前に、前提条件を確認してください。

• APIFY_TOKEN を含む .env ファイル
• Node.js 20.6 以降（ネイティブの --env-file 対応に必要）
• 選択した Actor とそのスキーマを確認するための、承認済み Apify コネクターまたは Console へのアクセス権。付属のランナーは REST を直接使用します。
• .env は追跡対象外にして非公開にしてください。トークンはローカルで設定し、チャットやコマンド引数に貼り付けないでください。

ワークフロー

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

Task Progress:
- [ ] Step 1: Determine lead source (select Actor)
- [ ] Step 2: Fetch Actor schema via an approved connector or Console
- [ ] 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 のスキーマを取得する

セッションで利用できる認証済み Apify コネクター、またはその Console ページを使用して、現在の Actor の詳細と入力スキーマを確認してください。呼び出す前に、実際のツール名とパラメーターを確認してください。シェルの置換で .env を解析したり、CLI のヘッダー引数としてトークンを渡したりしないでください。Actor の一覧は候補を見つけるためのものであり、利用可能性やスキーマが検証済みであることを示すものではありません。

次の情報が返されます。

• Actor の説明と README
• 必須および任意の入力パラメーター
• 出力フィールド（利用可能な場合）

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

実行前に、次の項目を確認してください。

1. 出力形式：
   • 簡易回答 - 上位数件の結果をチャットに表示します（ファイルは保存しません）
   • CSV - 返されたフィールドを統合した、件数を制限したエクスポート
   • JSON - JSON 形式で、件数を制限したエクスポート
2. 結果の件数：ユースケースの特性に基づいて決定します

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

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

node --env-file=.env "<resolved-skill-directory>/reference/scripts/run_actor.js" \
  --actor "ACTOR_ID" \
  --input 'JSON_INPUT'

CSV：

node --env-file=.env "<resolved-skill-directory>/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 "<resolved-skill-directory>/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 - ユーザーに .env を作成し、APIFY_TOKEN=your_token を設定するよう依頼します。 Connector unavailable - Console でスキーマを確認します。利用できないツールを呼び出したと主張してはいけません。 Actor not found - Actor ID のスペルを確認します。 Run FAILED - エラー出力にある Apify コンソールのリンクを確認するようユーザーに依頼します。 Timeout - ローカルのタイムアウトによってリモート実行が中断されることはありません。重複課金を避けるため、再試行する前に Console で出力された run ID を確認してください。

実行の境界

起動前に、選択した Actor、許可された公開データの範囲、現在の入力スキーマ、結果の上限、料金がユーザーの依頼に沿っていることを確認します。データソースの利用規約とアクセス制御を遵守し、非公開グループのデータや不要な個人の連絡先情報を収集してはいけません。まず Actor が対応する小さな入力上限から始めます。--max-items はダウンロードする出力のみを制限します（デフォルトは 1000）。Actor の処理や課金には上限を設けません。このヘルパーは、スキルを識別する User-Agent を Apify に送信します。コマンドのプレースホルダーには、インストール済みのスキルディレクトリを指定してください。出力ファイルには新しいパスを指定する必要があります。エクスポートでは、長い値や形式の異なるフィールドが保持されます。簡潔な回答では最大 5 件のレコードを取得し、共有する前に個人情報フィールドを最小限にするか、伏せてください。

許可された目的に必要な業務連絡先情報のみを収集してください。公開されていることは、連絡への同意を意味しません。ソース URL と日付を保持し、配信停止の申し出と重複を除外したうえで、利用前に管轄区域およびプラットフォームの制限を確認してください。フォロワーやグループのメンバーであることから、機微な個人特性を推測してはいけません。見込み顧客の発見は、メッセージの送信や連絡先の別サービスへのアップロードを許可するものではありません。

制限事項

• 上記の説明にある対象範囲とタスクが明確に一致する場合にのみ、このスキルを使用してください。
• 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が不明な場合は、作業を中止して確認を求めてください。