restaurant-food-delivery-research

レストラン・フードデリバリーの調査

Crawlora API から正規化された JSON 形式で、レストランの口コミ、予約、デリバリーメニューのほか、レストラン、デリバリー、食料品の各プラットフォームをまたいで食料品を検索できます。デリバリーアプリのページをスクレイピングする必要はありません。

このスキルを使う場面

• 「このレストランの口コミ／メニューは？」（Yelp、OpenTable）
• 「のテーブルを予約できますか？」（OpenTable の空席状況）
• 「近くでデリバリーを頼めるものは？」（DoorDash、Uber Eats）
• 「このレストランのデリバリーメニューには何がある？／この料理はいくら？」
• 「この Instacart の店舗で食料品を検索して。」

セットアップ（一度だけ）

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

仕組み

これらのプラットフォームのほとんどは位置情報に基づいています。キーワードだけでなく、すべての検索／店舗呼び出しで latitude／longitude（または postal_code）が必要です。

1. Yelp — /yelp/search（term+location）、または最初に /yelp/geocode で住所をジオコードします。詳細には /yelp/business/{id}、口コミには /reviews（および /reviews/search、/reviews/highlights）、メニューには /menu、写真には /photos を使います。
2. OpenTable — /opentable/search（term+latitude+longitude）でレストランを探し、次に /opentable/restaurant（restaurant_id。空席状況の確認には任意で date_time+party_size を指定）、/menus、/reviews を使います。
3. DoorDash — /doordash/search（必須の query+latitude+longitude）、または /doordash/feed／/doordash/explore で近くのレストランを閲覧します。1 軒のレストランの情報には /doordash/store/{store_id}（および /menu、/info、/reviews）を使います。すべての店舗呼び出しでも latitude+longitude が必要です。
4. Uber Eats — /ubereats/search（latitude+longitude、query は任意）または /ubereats/feed を使います。店舗情報には /ubereats/store/{store_id}（および /menu、/reviews）を使います。
5. Instacart — まず /instacart/stores（postal_code）で店舗を特定し、その shop_id／store_slug を取得します。次に /instacart/search（shop_id+store_slug+q）で商品名の候補を検索し、/instacart/departments でカテゴリー体系を確認します。人気商品は /instacart/trending（postal_code）で検索できます。

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

API の呼び出し

# Yelp:
scripts/crawlora.sh /yelp/search term="ramen" location="San Francisco, CA" | jq '.'

# DoorDash (lat/lon required):
scripts/crawlora.sh /doordash/search query="pizza" latitude=37.7749 longitude=-122.4194 | jq '.'

# OpenTable:
scripts/crawlora.sh /opentable/search term="Italian" latitude=37.7749 longitude=-122.4194 | jq '.'

# Instacart (resolve store first):
scripts/crawlora.sh /instacart/stores postal_code=94103 | jq '.'

すべてのリクエストには scripts/crawlora.sh を使います。API キーをコマンドライン引数に含めずに済みます。

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

レストラン、チェーン店のメニュー、デリバリー、食料品カタログでサポートされている全項目については、reference/endpoints.md を参照してください。

例

• 複数アプリ間でのデリバリー比較： 同じ座標と料理ジャンルで /doordash/search と /ubereats/search を実行し、表示されるレストランや価格を比較します。
• レストランの事前調査： 予約前に /yelp/business/{id}（評価、口コミの要点）と /opentable/restaurant/reviews を確認します。
• 食料品の買い物： /instacart/stores で最寄りの店舗を探し、次に /instacart/departments でカテゴリーを閲覧します。

注意事項と制限

• クレジット／成功時課金： 2xx の場合にのみ課金されます。無料枠は月2,000クレジットです。 https://crawlora.net でキーを取得してください。
• 公開データのみ — 公開されている店舗情報、メニュー、レビューのページが対象です。注文や支払いの操作は行われません。
• セキュリティ： キーは CRAWLORA_API_KEY にのみ保存してください。ハードコード、クエリパラメーターへの指定、コミットは絶対にしないでください。
• 位置情報は必須であり、省略できません。 DoorDash、Uber Eats、OpenTable の検索／店舗呼び出しでは位置情報が必要です。住所しかわからない場合は、先に住所をジオコーディングしてください（例：/yelp/geocode または web-utilities-research の geocoding_* エンドポイントを使用）。
• Instacart は店舗ごとに利用します — search／item／departments を使用する前に、/instacart/stores から shop_id と store_slug を取得する必要があります。