product-price-research

产品与价格调研

查询并比较 Amazon、 eBay、Shopify 商店、Shop.app、Target、Costco、Zalando、Walmart、H&M、 Kohl's、Lululemon、Macy's、Nike、Old Navy（以及使用相同端点的 Gap、Banana Republic 和 Athleta）、Sam's Club、Ulta Beauty、Wayfair、Wish、Zappos、Zara、Adidas、Best Buy、 Home Depot、Sephora、SHEIN、IKEA 和 Chewy 上的产品、价格、卖家和评价——所有数据均以 Crawlora API 提供的标准化 JSON 格式返回，无需抓取 HTML。Walgreens 仅支持门店查询（不提供产品目录）。

何时使用此技能

• “X 在 Amazon / eBay / Target / Walmart 上卖多少钱？”或“比较 X 在各卖家/零售商处的价格。”
• “查找 X 的商品信息”/“搜索这家 Shopify 商店”/“这个系列里有哪些商品？”
• “获取这个产品或卖家的评价/评分。”
• “追踪这个产品的价格/变体/库存情况。”
• 竞争性定价、目录或市场评价调研。
• “浏览 Wayfair / Kohl's / Sam's Club 上的 X 类商品”，适用于零售商自身不提供关键词搜索的情况。
• 跨 Nike、Zara、H&M、Old Navy/Gap/Banana Republic/Athleta、Lululemon、Ulta Beauty、Adidas 或 Sephora 查询服装/美妆商品目录。
• 跨 Home Depot、Best Buy、IKEA 或 Chewy 查询家居用品/电子产品/宠物用品。
• “查找最近的 Walgreens”（仅限门店查询——不提供产品目录）。

设置（一次性）

• 免费获取 Crawlora API key（每月 2,000 点额度，无需银行卡）：https://crawlora.net。
• 运行辅助程序前，在环境中设置 CRAWLORA_API_KEY。
• 辅助程序会从环境中读取 CRAWLORA_API_KEY，并向 https://api.crawlora.net/api/v1 发送请求。缺少或无效的密钥 → 401。

工作原理

先选择市场，再选择任务：

1. 搜索 / 发现 — /amazon/search、/ebay/search、/shopify/products、 /shop-app/search、/target/search、/costco/search、/walmart/search、 /hm/search、/nike/search、/oldnavy/search（通过 brand=on|gap|br|at 覆盖 Old Navy、Gap、 Banana Republic 和 Athleta，默认值为 on）、 /ulta/search、/wish/search、/zappos/search、/zara/search（需要 section，例如 WOMAN/MAN 这样的部门），以及 /zalando/search（此接口 需要 market，即 Zalando 国家店铺代码，例如 de、 fr、com；通过 /zalando/markets 列出）可按关键词查找候选商品。Kohl's、Lululemon、Macy's、Sam's Club 和 Wayfair 没有关键词搜索接口——请改为浏览分类： /kohls/category（facets 会提供后续分类字符串）、 /lululemon/categories → /lululemon/category、/samsclub/departments → /samsclub/category 和 /wayfair/categories → /wayfair/category。 Macy's 既没有搜索功能，也不能浏览分类——只有直接按 productId 查询（见下文），以及 /macys/suggest 自动补全接口。 /adidas/search（必须且只能提供 query 或 category 其中一项）、 /bestbuy/search（q）、/homedepot/search（q）、/sephora/search （query，以及 brand/filter/price_min+price_max （必须成对提供）/rating_min/is_new facets）、/ikea/search （q，或者直接解析 IKEA 商品编号），以及 /chewy/search （q——如果类别匹配度很高，例如“dog food”，则会自动重定向 到该分类列表）也可用于搜索。Walgreens 完全没有商品目录——其唯一接口 /walgreens/stores（按 lat/lon 或邮政编码查询），用于查找门店。
2. 详情 — 获取特定商品（/amazon/product、/ebay/item、 /shopify/products/{handle}、/shop-app/products/{id}、 /target/product（tcin）、/costco/product/{id}、/walmart/product/{item_id}、 /zalando/product（sku+market）、/hm/product/{product_id}、 /nike/product（slug+style_color）、/oldnavy/product（pid+brand）、 /lululemon/product/{product_id}、/macys/product/{productId}、 /samsclub/product/{id}、/ulta/product/{productId}、/wayfair/product/{id}、 /wish/product/{id}、/zappos/product/{productId}、/zara/product/{productId}、 /adidas/product（product_id）、/bestbuy/product（sku）、 /homedepot/product/{id}、/sephora/product（product_id——完整的 商品页面 slug，例如 lip-sleeping-mask-P420652，而不只是 SKU）、 /shein/products/detail（goods_id+goods_sn）、/ikea/product （item_no）、/chewy/product（id）），以获取价格、款式、规格。Kohl's 没有独立的商品详情接口——商品卡片（包括下文获取评论所需的 web_id） 只会随 /kohls/category 的商品列表一起返回。
3. 卖家 — 对于 eBay/Shop.app，解析卖家/店铺（/ebay/seller/...、 /shop-app/shops/{handle}）以比较报价。
4. 评论 — 在可用时获取商品/卖家评论 （/shop-app/products/{id}/reviews、/ebay/seller/.../feedback、 /target/reviews、/costco/product/{id}/reviews、/walmart/product/{item_id}/reviews、 /kohls/product/reviews（web_id）、/macys/product/reviews（product_id）、 /nike/product/reviews（slug+style_color）、/oldnavy/product/reviews （pid+brand）、/ulta/product/reviews（product_id）、/wish/product/{id}/reviews）。 H&M、Lululemon、Sam's Club 和 Zappos 会在各自的商品详情接口响应中内嵌评论（如果有），而不是提供单独的接口； Wayfair 和 Zara 完全不提供评论——Wayfair 的商品详情只有汇总评分。 /bestbuy/product/reviews（sku）、/sephora/product/reviews（product_id）和 /ikea/reviews （item_no）分别提供这三家的评论；Home Depot 和 Chewy 则会在各自的商品详情接口响应中内嵌评论。Adidas 的评论和评分汇总可通过 /adidas/product/reviews 获取，使用搜索结果中的 model_number（而不是 SKU）。通过 /adidas/product/review-topics 按型号发现评论主题； locale 决定评论语言，也可能导致评论样本为空。此目录中的 SHEIN 不提供评论接口。
5. 比较 JSON 字段（价格、货币、评分、卖家）并作答。 完整的端点列表、方法和参数：reference/endpoints.md。

调用 API

# Search a marketplace (GET, key=value params):
scripts/crawlora.sh /amazon/search k="standing desk" | jq '.'
scripts/crawlora.sh -X POST /ebay/search '{"keyword":"mechanical keyboard"}' | jq '.'
scripts/crawlora.sh /shop-app/search query="running shoes" | jq '.'
scripts/crawlora.sh /target/search q="standing desk" | jq '.'
scripts/crawlora.sh /walmart/search q="standing desk" | jq '.'
scripts/crawlora.sh /zalando/search q="running shoes" market=de | jq '.'
scripts/crawlora.sh /nike/search keyword="running shoes" | jq '.'
scripts/crawlora.sh /ulta/search query="retinol serum" | jq '.'
scripts/crawlora.sh /bestbuy/search q="laptop" | jq '.'
scripts/crawlora.sh /sephora/search query="retinol serum" | jq '.'
scripts/crawlora.sh /chewy/search q="salmon dog food" | jq '.'

# Product detail:
scripts/crawlora.sh /amazon/product/B0XXXXXXX | jq '.data'
scripts/crawlora.sh /ikea/product item_no=00263850 | jq '.'

# Category browse (no keyword search on this platform):
scripts/crawlora.sh /wayfair/category category=478390 | jq '.'
scripts/crawlora.sh /zara/category/2420463/products | jq '.'

# Store locator only (no product catalog):
scripts/crawlora.sh /walgreens/stores zip=10001 | jq '.'

所有请求均使用 scripts/crawlora.sh；它可以避免 API 密钥出现在命令行参数中。

端点参考

请参阅 reference/endpoints.md，了解此技能使用的所有端点， 包括其方法、路径、参数和平台覆盖范围。

示例

• 跨平台比价： 搜索 /amazon/search 和 /ebay/search 中的相同查询，分别收集 price，并展示价格差异。
• 卖家尽职调查： 使用 /ebay/seller/{seller} + /ebay/seller/{seller}/feedback 汇总卖家的评级和近期反馈，再决定是否购买。
• Shopify 商品目录审核： 对 /shopify/products 分页，列出商店的 商品目录及价格，然后标记高于／低于阈值的商品。
• 不支持搜索的零售商浏览： 对于不支持关键词搜索的零售商 （Kohl's、Wayfair、Sam's Club），先调用类别／部门发现 端点（/kohls/category 的 facets、/wayfair/categories、 /samsclub/departments）查找类别 ID，然后直接浏览该类别， 不要尝试按关键词搜索。

注意事项与限制

• 额度／成功后付费： 仅对 2xx 响应计费；免费套餐每月 2,000 个额度。 在 https://crawlora.net 获取密钥。
• 仅限公开数据——公开的商品／商品列表页面；请遵守各电商平台的条款。
• 安全性： 密钥仅存放在 CRAWLORA_API_KEY 中——切勿硬编码、作为查询参数传递或提交。
• 结果采用分页；遍历商品列表时传入 page（以及受支持时的 count）。
• Zalando 始终需要 market（没有默认店面）——如不确定，可通过 /zalando/markets 查询有效代码。
• Macy's 不支持搜索或类别浏览——仅支持 /macys/product/{productId} （需要已知的 productId）和 /macys/suggest 自动补全。
• Wayfair 不支持搜索，也没有评论端点——仅支持 /wayfair/categories → /wayfair/category 和 /wayfair/product/{id} （后者包含汇总评分，但不含评论文本）。
• Kohl's 不支持搜索或独立的商品详情端点——浏览 /kohls/category（其 category 参数接受以 + 连接的分类字符串， 请将 + 百分号编码为 %2B），并从商品列表中读取商品卡片； /kohls/product/reviews 需要使用该列表中的 web_id。
• Sam's Club 没有关键词搜索端点——从 /samsclub/departments 或 /samsclub/category 开始；也没有专用的评论端点 （评分／评论数仅来自 /samsclub/product/{id}）。
• Lululemon 没有关键词搜索端点——通过 /lululemon/categories → /lululemon/category 浏览；评论嵌入在 /lululemon/product/{product_id} 中，不需要单独调用。
• Zara 的 /zara/search 需要 section（例如 WOMAN 这样的部门）， 且 Zara 完全没有评论端点。
• Old Navy 的端点由四个店面共享——传入 brand=on|gap|br|at（Old Navy／Gap／Banana Republic／Athleta；默认值为 on）；在某个品牌下找到的 cid／pid 仅适用于同一品牌。

AliExpress 商品与属性比较

应用属性 ID 和值 ID 进行搜索前，先针对确切查询发现 aliexpress_search_filters。 属性组合因查询而异，每组最多选一个值，最多可使用五组；不要重复使用其他搜索的筛选标识符。 保留商品列表中的变体、货币（搜索价格筛选使用 USD）、卖家／商品状况证据、运费计算依据和返回的来源标识符。 评论样本不能验证卖家身份，也不能证明典型配送时间。 Choice／免运费标记是来源标签；标示的运费和总成本仍可能取决于目的地和结账条件。 比较实际观察到的报价，不要将其视为有保证的到手价，也不要根据排序推断交易量。

scripts/crawlora.sh /aliexpress/search-filters q="usb c hub"
scripts/crawlora.sh /aliexpress/search q="usb c hub" page=1 sort=best_match