apify-lead-generation について
複数のプラットフォームで Apify Actors を使ってリードを探すスキルです。Actor の選択と実行を案内し、結果をチャット、CSV、JSONで出力します。
主な機能
- 01リード元に応じた Actor の選択
- 02mcpc による Actor スキーマ取得
- 03Node.js スクリプトでの Actor 実行
- 04チャット、CSV、JSONでの結果出力
- 05リード数と項目の要約
活用シーン
- 01地域の事業者や連絡先の検索
- 02ソーシャルメディアのクリエイター発見
- 03後で確認するリードのエクスポート
MCP 対応
mcpc で mcp.apify.com を呼び出し、入力スキーマや出力項目を含む Actor の詳細を取得します。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ apify/ agent-skills --skill apify-lead-generationインストール後、Claude Code で/apify-lead-generationを入力して読み込まれたか確認します。
同梱ファイルreference/scripts/run_actor.js
詳細
リードジェネレーション
Apify Actors を使用して、複数のプラットフォームからリードをスクレイピングします。
前提条件
(事前に確認する必要はありません)
APIFY_TOKENを含む.envファイル- Node.js 20.6 以降(ネイティブの
--env-fileをサポートするため) mcpcCLI ツール:npm install -g @apify/mcpc
ワークフロー
このチェックリストをコピーして、進捗を記録します。
Task Progress:
- [ ] Step 1: Determine lead source (select Actor)
- [ ] Step 2: Fetch Actor schema via mcpc
- [ ] Step 3: Ask user preferences (format, filename)
- [ ] Step 4: Run the lead finder script
- [ ] Step 5: Summarize results
ステップ 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 マップのメールアドレス | poidata/google-maps-email-extractor | メールアドレスの直接抽出 |
ステップ 2:Actor のスキーマを取得する
mcpc を使用して、Actor の入力スキーマと詳細を動的に取得します。
export $(grep APIFY_TOKEN .env | xargs) && mcpc --json mcp.apify.com --header "Authorization: Bearer $APIFY_TOKEN" tools-call fetch-actor-details actor:="ACTOR_ID" | jq -r ".content"
選択した Actor(例:compass/crawler-google-places)に置き換えて ACTOR_ID を指定します。
取得できる情報は次のとおりです。
- Actor の説明と README
- 必須および任意の入力パラメーター
- 出力フィールド(利用可能な場合)
ステップ 3:ユーザーの希望を確認する
実行前に、次の項目を確認します。
- 出力形式:
- 簡易回答 - チャットに上位数件を表示します(ファイルは保存しません)
- CSV - すべてのフィールドを含む全件エクスポート
- JSON - JSON 形式で全件エクスポート
- 結果の件数:ユースケースの特性に基づいて決定します
ステップ 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
ステップ 5:結果を要約する
完了後、次の内容を報告します。
- 見つかったリードの件数
- ファイルの場所と名前
- 利用できる主なフィールド
- 次のステップの提案(フィルタリング、情報補完)
エラー処理
APIFY_TOKEN not found - ユーザーに APIFY_TOKEN=your_token を含む .env の作成を依頼します
mcpc not found - ユーザーに npm install -g @apify/mcpc のインストールを依頼します
Actor not found - Actor ID のスペルを確認します
Run FAILED - エラー出力内の Apify コンソールのリンクを確認するようユーザーに依頼します
Timeout - 入力サイズを小さくするか、--timeout を増やします