apify-market-research

市場調査

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

前提条件

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

• APIFY_TOKEN を含む .env ファイル
• Node.js 20.6 以降（ネイティブの --env-file サポートに必要）
• mcpc CLI ツール：npm install -g @apify/mcpc

ワークフロー

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

Task Progress:
- [ ] Step 1: Identify market research type (select Actor)
- [ ] Step 2: Fetch Actor schema via mcpc
- [ ] 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 のスキーマを取得する

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_ID を選択した Actor（例：compass/crawler-google-places）に置き換えます。

以下が返されます。

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

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

実行前に、次の項目を確認します。

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

ステップ 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 を増やします