target-research

Target 研究

浏览和搜索 Target 商品目录，并获取商品详情、价格、库存情况、问答和评论——全部通过 Crawlora API 以规范化 JSON 返回，无需抓取 HTML。

适用场景

• “Target 上的 X 多少钱？”或“在 Target 上找 X。”
• “浏览 Target 的这个品类”／“Target 的[部门]里有什么？”
• “按[品牌／尺寸／价格]筛选 Target 商品。”
• “获取这款 Target 商品的问答／评论。”
• “查询这款 Target 商品在指定门店的价格或库存情况。”

设置（一次性）

• 获取免费的 Crawlora API 密钥（每月 2,000 个额度，无需银行卡）：https://crawlora.net。
• 运行辅助脚本前，将 CRAWLORA_API_KEY 设置到环境中。
• 辅助脚本会从环境中读取 CRAWLORA_API_KEY，并向 https://api.crawlora.net/api/v1 发送请求。密钥缺失或无效时会返回 401。

工作原理

1. 浏览或搜索 — /target/categories 列出品类菜单及其 ID；/target/category-products（category_id）或 /target/search（q）会返回分页商品，以及适用于该结果集的筛选分组和选项。
2. 筛选 — 如果需要在浏览前单独获取筛选选项，/target/filter-options 可针对查询（q）或品类（category_id）返回动态筛选分组；在 category-products 或 search 请求中，通过 filter_ids（逗号分隔）传入所选选项的 ID，即可缩小结果范围。
3. 详情 — /target/product（tcin）可获取完整商品内容、图片、价格、评分、品类和门店级库存情况。
4. 问答和评论 — /target/questions 和 /target/reviews（均按 tcin 查询）可获取分页的商品问题／回答及书面评论。
5. 比较各商品或门店的 JSON 字段（价格、评分、库存情况）并作答。

完整端点列表、方法和参数：reference/endpoints.md。

调用 API

# Search Target (GET, key=value params):
scripts/crawlora.sh /target/search q="standing desk" sort=price-low | jq '.'

# Browse a category, filtered and priced for a store:
scripts/crawlora.sh /target/category-products category_id=5xtg6 store_id=1234 filter_ids=5xtvw | jq '.'

# Product detail:
scripts/crawlora.sh /target/product tcin=54191097 | jq '.data'

# Reviews:
scripts/crawlora.sh /target/reviews tcin=54191097 per_page=20 | jq '.'

所有请求都使用 scripts/crawlora.sh；它可避免将 API 密钥暴露在命令行参数中。

端点参考

参阅 reference/endpoints.md，了解此技能使用的所有 Target 端点（方法、路径、参数、说明）。

示例

• 按品类查看价格： 使用 /target/categories 查找某个部门的 category_id，然后通过设置 store_id，分页调用 /target/category-products，列出本地价格和库存情况。
• 全面了解商品： 调用 /target/product 获取价格／评分，然后通过 tcin 调用 /target/questions 和 /target/reviews，总结购物者在推荐前提出的问题和发表的看法。
• 筛选搜索： 使用 /target/search 查询，检查返回的筛选分组，然后再次调用并设置 filter_ids，按品牌／尺寸／价格区间缩小结果范围。

备注和限制

• 额度／成功后计费： 仅对 2xx 响应计费；免费套餐每月 2,000 个额度。获取密钥：https://crawlora.net。
• 仅限公开数据 — 公开的 Target 商品／品类页面；请遵守 Target 的条款。
• 安全性： 密钥仅存放在 CRAWLORA_API_KEY 中——切勿硬编码、作为查询参数传递或提交到代码库。
• 结果采用分页形式——遍历商品列表时，传入 page（以及支持时的 per_page／count）。
• 商品标识为 tcin（Target 数字商品 ID），而非 SKU 或 ASIN — /target/product、/target/questions 和 /target/reviews 均以此为查询键。
• 分页方式不统一： category-products／search 使用从 1 开始的 page（最大为 50）；questions／reviews 使用从 0 开始的 page（reviews 的最大值也为 50）。
• store_id 为可选项，但会影响门店专属价格和库存情况——省略时返回通用／全国范围的结果。