apify-market-research

市場調査

Apify Actor を使用して、複数のプラットフォームからデータを抽出し、市場調査を行います。

前提条件

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

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

ワークフロー

このチェックリストをコピーして、進捗を記録します。

Task Progress:
- [ ] Step 1: Identify market research type (select Actor)
- [ ] Step 2: Fetch Actor schema
- [ ] Step 3: Ask user preferences (format, filename)
- [ ] Step 4: Run the analysis script
- [ ] Step 5: Summarize findings

ステップ 1：市場調査の種類を特定する

調査のニーズに応じて、適切な Actor を選択します。

ユーザーのニーズ	Actor ID	最適な用途
市場密度	compass/crawler-google-places	立地分析
地理空間分析	compass/google-maps-extractor	ビジネスのマッピング
地域の関心	apify/google-trends-scraper	トレンドデータ
価格と需要	apify/facebook-marketplace-scraper	市場価格
イベント市場	apify/facebook-events-scraper	イベント分析
消費者ニーズ	apify/facebook-groups-scraper	グループ調査
市場の状況	apify/facebook-pages-scraper	ビジネスページ
ビジネス密度	apify/facebook-page-contact-information	連絡先データ
文化的な洞察	apify/facebook-photos-scraper	ビジュアル調査
ニッチなターゲティング	apify/instagram-hashtag-scraper	ハッシュタグ調査
ハッシュタグの統計	apify/instagram-hashtag-stats	市場規模の推定
市場の活動状況	apify/instagram-reel-scraper	活動分析
市場インテリジェンス	apify/instagram-scraper	完全なデータ
製品ローンチ調査	apify/instagram-api-scraper	API アクセス
ホスピタリティ市場	voyager/booking-scraper	ホテルデータ
観光の洞察	maxcopell/tripadvisor-reviews	レビュー分析

ステップ 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 の概要
• 入力スキーマ（必須および任意のパラメーター）

ステップ 3：ユーザーの希望を確認する

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

大規模なスクレイピングタスクの場合は、次の項目を確認します。

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

コストの安全対策：Actor の入力には、常に適切な結果上限を設定します（例：maxResults、resultsLimit、maxCrawledPages、または入力スキーマにある同等のフィールド）。ユーザーから明示的に追加の結果を求められない限り、デフォルトは 100 件とします。Apify クレジットをより多く消費するため、大規模なスクレイピング（1000 件以上）を実行する前にユーザーに警告します。

ステップ 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 - ユーザーに .env ファイルを作成し、APIFY_TOKEN=your_token を設定するよう依頼します Actor not found - Actor ID のスペルを確認します Run FAILED - エラー出力内の Apify コンソールへのリンクを確認するようユーザーに依頼します Timeout - 入力サイズを減らすか、--timeout を増やします