用途：在 Shop.app（Shopify 的跨店购物与发现应用，区别于单个 Shopify 店铺）上搜索、浏览和分析商品、变体、店铺与评论，结果均为 Crawlora API 返回的规范化 JSON，无需抓取 HTML。
主要能力：搜索与发现（/shop-app/search，支持 deep_search、in_stock、on_sale，limit 最高 50；/shop-app/suggestions 返回自动补全；/shop-app/categories 列出公开分类）。市场快照（/shop-app/analysis 返回价格区间、货币、促销数量、折扣、头部店铺等聚合信息）。商品详情（/shop-app/products/{id}，可加 variant_id）。变体（/shop-app/products/{id}/variant 按 selected_options 精确匹配，/variants 获取相邻变体）。相关商品与评论（/related、/reviews）。店铺解析（/products/{id}/shop、/shops/{handle}、/shops/{handle}/locations）。浏览店铺目录（/shops/{handle}/products 可用 sort_by 排序，/collections/{collection_id}/products，/typeahead 店内搜索，/reviews 商家评论）。
使用方式：先在 https://crawlora.net 获取免费 API key（每月 2000 credits，无需信用卡），将 CRAWLORA_API_KEY 写入环境变量；助手从环境读取并请求 https://api.crawlora.net/api/v1，key 缺失或无效返回 401。所有请求使用 scripts/crawlora.sh，以避免 key 出现在命令行参数中。例如：scripts/crawlora.sh /shop-app/search query="running shoes" in_stock=true | jq '.'；scripts/crawlora.sh /shop-app/products/12345 | jq '.data'；scripts/crawlora.sh /shop-app/shops/some-shop-handle/products sort_by=PRICE_LOW_TO_HIGH | jq '.'。完整端点、方法与参数见 reference/endpoints.md。
适用场景：跨店发现、购买前市场快照、商家尽职调查（结合店铺资料与评论）、目录审计与价格阈值标记。
限制：按成功计费（仅 2xx 计费），免费额度每月 2000 credits。仅限公开数据，需遵守 Shop.app 条款。结果按 limit 截断，不支持 offset 分页，各端点上限不同（变体最高 100）。selected_options 需传 JSON 字符串（如 '{"Color":"Black"}'），或用重复的 option.Name=value。店铺/集合商品列表的 sort_by 仅接受 MOST_SALES、PRICE_LOW_TO_HIGH、PRICE_HIGH_TO_LOW、RELEVANCE。key 仅存于 CRAWLORA_API_KEY，切勿硬编码或提交。