用途:查询餐厅评论、预订与外卖菜单,并跨餐厅、外卖、杂货平台做搜索,结果以规范化 JSON 返回,无需自行抓取外卖应用页面。
主要能力:Yelp 支持搜索、地址地理编码、商家详情、评论(含搜索与亮点)、菜单、照片;OpenTable 支持搜索餐厅、餐厅详情(可带日期时间与人数查看可用性)、菜单、评论;DoorDash 支持按关键词与坐标搜索、浏览附近餐厅、查看单个店铺的菜单/信息/评论;Uber Eats 支持按坐标搜索、浏览信息流、查看店铺菜单与评论;Instacart 支持按邮编解析门店、按商品词搜索、查看分类与热门商品。
使用方式:先在 https://crawlora.net 获取免费 API Key(每月 2000 积分,无需信用卡),将 CRAWLORA_API_KEY 写入环境变量,助手会向 https://api.crawlora.net/api/v1 发请求,缺失或无效密钥返回 401。所有请求建议通过 scripts/crawlora.sh 发起,以避免密钥出现在命令行参数中。示例:scripts/crawlora.sh /yelp/search term="ramen" location="San Francisco, CA" | jq '.';scripts/crawlora.sh /doordash/search query="pizza" latitude=37.7749 longitude=-122.4194 | jq '.';scripts/crawlora.sh /opentable/search term="Italian" latitude=37.7749 longitude=-122.4194 | jq '.';scripts/crawlora.sh /instacart/stores postal_code=94103 | jq '.'。完整端点、方法与参数见 reference/endpoints.md。
适用场景:跨应用外卖比价、订位前的餐厅尽调、按坐标找附近可配送餐厅、查看某道菜价格、按邮编搜索杂货门店商品。
限制:多数平台按位置限定,DoorDash、Uber Eats、OpenTable 的搜索与店铺调用必须提供经纬度或邮编,仅有街道地址时需先地理编码;Instacart 按门店限定,需先从 /instacart/stores 取得 shop_id 与 store_slug。仅访问公开的列表、菜单与评论页面,不执行下单或支付操作。计费按成功响应(2xx)计,免费额度每月 2000 积分。密钥仅存放于 CRAWLORA_API_KEY,切勿硬编码、放入查询参数或提交到仓库。