用途:通过 Crawlora API 浏览和搜索 Target 商品目录,获取商品详情、价格、库存、问答与评论,全部以规范化 JSON 返回,无需自行抓取 HTML。
主要能力:/target/categories 列出分类菜单与 id;/target/category-products(category_id)或 /target/search(q)返回分页商品及可用筛选组;/target/filter-options 单独返回查询或分类的动态筛选组,选中项通过 filter_ids(逗号分隔)回传以缩小结果;/target/product(tcin)获取完整商品内容、图片、价格、评分、分类及门店级库存;/target/questions 与 /target/reviews(均以 tcin 为键)拉取分页问答与文字评论。
使用方式:先在 https://crawlora.net 获取免费 Crawlora API 密钥(每月 2000 积分,无需信用卡),将 CRAWLORA_API_KEY 设置到环境变量,助手会读取该变量并向 https://api.crawlora.net/api/v1 发送请求,密钥缺失或无效返回 401。所有请求使用 scripts/crawlora.sh,避免密钥出现在命令行参数中。示例:scripts/crawlora.sh /target/search q="standing desk" sort=price-low | jq '.';scripts/crawlora.sh /target/category-products category_id=5xtg6 store_id=1234 filter_ids=5xtvw | jq '.';scripts/crawlora.sh /target/product tcin=54191097 | jq '.data';scripts/crawlora.sh /target/reviews tcin=54191097 per_page=20 | jq '.'。完整端点、方法与参数见 reference/endpoints.md。
适用场景:查询某商品在 Target 的价格或查找商品;浏览某分类;按品牌、尺寸、价格筛选;拉取某商品的问答或评论;查询特定门店的价格或库存;对比多个商品或门店的 JSON 字段后作答。
限制:仅限公开数据,需遵守 Target 条款;按成功计费,仅 2xx 计费,免费层每月 2000 积分;结果分页,需传 page(及支持的 per_page/count)遍历;商品标识为 tcin(Target 数字商品 id),非 SKU 或 ASIN;分页不统一,category-products/search 使用从 1 开始的 page(最大 50),questions/reviews 使用从 0 开始的 page(reviews 最大 50);store_id 可选,但决定门店级价格与库存,省略则为通用/全国结果;密钥仅存于 CRAWLORA_API_KEY,切勿硬编码、放入查询参数或提交。