facebook-research

Facebook リサーチ

Facebook Marketplace を検索し、公開 Facebook ページの詳細を取得します。すべて Crawlora API から正規化された JSON として取得でき、ブラウザーの自動操作やログイン済みセッションは不要です。

このスキルを使う場面

• 「 の Marketplace の出品を 周辺で探して。」
• 「/ の Marketplace の閲覧フィードには何がある？」
• 「 のフォロワー数／カテゴリ／連絡先情報を取得して。」
• 「この Facebook ページに電話番号やウェブサイトは掲載されている？」
• 地域の市場価格調査や、ページの公開「基本データ」タブを使った見込み顧客の一括調査。

セットアップ（初回のみ）

• https://crawlora.net で無料の Crawlora API キーを取得します（月 2,000 クレジット、カード不要）。
• ヘルパーを実行する前に、環境変数に CRAWLORA_API_KEY を設定します。
• ヘルパーは環境変数から CRAWLORA_API_KEY を読み取り、https://api.crawlora.net/api/v1 にリクエストを送信します。キーがない、または無効な場合は 401 が返されます。

動作の仕組み

1. Marketplace の検索／閲覧 — GET /facebook/marketplace/search に、必須の location（Marketplace のバニティスラッグ）と、任意の query または category を指定します。query と category の両方を省略すると、検索ではなく、その場所の閲覧フィードが取得されます。min_price、max_price、sort_by、days_since_listed、condition は、query または category と一緒に指定した場合のみ有効です。
2. ページの検索 — GET /facebook/{page}。page にはバニティ名、ハンドル、profile.php ID、または Facebook の完全な URL を指定できます。名前、フォロワー数／いいね数、紹介文、カテゴリ、営業時間／価格帯、レビュー数、およびページの「基本データ」タブにある公開連絡先情報が返されます。

エンドポイント、メソッド、パラメーターの一覧については、reference/endpoints.md を参照してください。

API の呼び出し

# Marketplace search / browse:
scripts/crawlora.sh /facebook/marketplace/search location=chicago-il query="dining table" | jq '.'
scripts/crawlora.sh /facebook/marketplace/search location=chicago-il category=vehicles min_price=5000 | jq '.'

# Page lookup:
scripts/crawlora.sh /facebook/nike | jq '.'

すべてのリクエストには scripts/crawlora.sh を使用します。これにより、API キーがコマンドライン引数に含まれないようにできます。

エンドポイントリファレンス

このスキルで使用する Facebook の 2 つのエンドポイントについては、reference/endpoints.md を参照してください。

使用例

• 地域の中古品価格の確認： /facebook/marketplace/search に location と商品の query を指定し、最初のページの結果から出品価格や商品の状態を比較します。
• 営業先情報の拡充： 見込み顧客の Facebook ページに対して /facebook/{page} を呼び出し、アプローチ前にフォロワー数、カテゴリ、「基本データ」タブにある公開電話番号／メールアドレス／ウェブサイトを取得します。

注意事項と制限

• クレジット／成功時のみ課金： 2xx の場合のみ課金されます。無料プランは月 2,000 クレジットです。キーは https://crawlora.net で取得できます。
• 公開データのみ — 公開 Marketplace 出品と公開ページ情報のみが対象です。ログインや非公開コンテンツには対応していません。Facebook の利用規約を遵守してください。
• セキュリティ： キーは CRAWLORA_API_KEY にのみ保存してください。ハードコードしたり、クエリパラメーターに含めたり、コミットしたりしないでください。
• Marketplace の検索は 1 ページのみです：Facebook の追加ページネーションにはログイン済みセッションが必要であり、対象範囲外です。サーバーでレンダリングされた結果の最初のページのみが返されます。
• property_rentals カテゴリは常にフィルターされます — 独自の出品ページがあり、通常の閲覧フィードと同様に、min_price／max_price／sort_by などのフィルターは無視されます。
• Marketplace の検索には時間がかかる場合があります — 上流サービスの一時的な状態に対して再試行するため、最も遅い場合は約 1 分かかることがあります。料金はそれに応じて設定されています。