apify-market-research

市場調査

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

使用する場面

• 市場規模、地域別需要、価格、トレンド、または消費者行動のデータが必要な場合。
• Apify を使用して、地図、旅行、Facebook、Instagram、またはトレンドの情報源から調査データを収集する場合。
• 構造化された市場データと、機会やリスクを統合した見解が必要な場合。

前提条件

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

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

ワークフロー

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

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

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

以下の情報が返されます。

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

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

実行前に、以下を確認してください。

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

ステップ 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

ステップ 5：調査結果を要約する

完了後、以下を報告してください。

• 見つかった結果の件数
• ファイルの場所と名前
• 市場に関する主な洞察
• 推奨される次のステップ（詳細な分析、検証）

エラー処理

APIFY_TOKEN not found - ユーザーに .env を作成し、APIFY_TOKEN=your_token を設定するよう依頼します
Connector unavailable - Console でスキーマを確認してください。利用できないツールを呼び出したと主張しないでください。
Actor not found - Actor ID のつづりを確認してください
Run FAILED - エラー出力にある Apify console のリンクを確認するようユーザーに依頼してください
Timeout - ローカルのタイムアウトではリモート実行は中止されません。重複課金を避けるため、再試行する前に Console で表示された実行 ID を確認してください。

実行範囲

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

制限事項

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