模板名称: Amazon 商品 URL 采集器
模板代码: amazon_product_by_url
当前版本: v7
功能简介 #
该模板根据 Amazon 商品页面 URL 采集页面可获取的结构化商品信息。输出涵盖商品基本信息、价格与报价、库存状态、评分与评论、图片、分类、销售排名和商品规格,可用于商品研究、价格监测、竞品分析和商品信息同步。
模板提供同步和异步两种执行模式。在 Clawoxy 控制台的 Scraping API 中选择此模板,在“采集调试”填写参数并发起请求;程序接入可参考页面生成的 Shell 请求示例。
输入参数 #
| 参数 | 类型 | 必填 | 规则与说明 |
|---|---|---|---|
url | string | 是 | 有效 URI,最多 2048 个字符。填写目标 Amazon 商品链接,例如 https://www.amazon.com/dp/B0EXAMPLES。 |
country | string | 否 | 两个字符的国家/站点代码。可在国家选择框中搜索名称或代码。 |
调试表单默认选择“同步”模式。可在“本次执行模式”中切换同步或异步;请求参数中对应的模式值为 sync 或 async。提交前确认商品 URL 和站点代码与目标 Amazon 页面匹配。
也可以通过代码调用:在自己的程序中请求 Scraping API,传入本模板代码和输入参数,并按所选同步或异步模式处理结果。如果不确定如何编写代码,可以把目标网站链接和本模板说明提供给 AI,请 AI 根据模板支持的输入参数和 Scraping API 接口要求生成调用代码。使用前请核对参数、API Key 处理方式及结果解析逻辑。
输出内容 #
| 字段 | 类型 | 说明 |
|---|---|---|
| url | string | Amazon 商品页面链接。 |
| asin | string | 商品 ASIN。 |
| url_asin | string | 从输入链接中解析出的 ASIN。 |
| parent_asin | string | 父商品 ASIN(页面提供时)。 |
| title | string | 商品标题。 |
| brand | string | 品牌名称。 |
| manufacturer | string | 制造商名称。 |
| description | string | 商品描述。 |
| bullet_points_text | string | 商品卖点文本。 |
| store_url | string | 店铺页面链接。 |
| image_urls | array<string> | 商品图片链接列表。 |
| has_videos | boolean | 页面是否包含商品视频。 |
| categories | array<object> | 商品分类列表;每项的 category_path 为分类路径数组,包含 url(分类链接)和 name(分类名称)。 |
| sales_ranks | array<object> | 销售排名列表;每项包含 rank(排名)和 category_path(分类路径,含 url、name)。 |
| price | number | 模板返回的商品价格数值。 |
| currency | string | 页面提供的币种代码或符号,不会自动换算。 |
| buybox_price | number | Buy Box 价格数值。 |
| buybox_offers | array<object> | Buy Box 报价列表;每项包含 price(报价数值)和 availability_text(可售状态原文)。 |
| offer_count | integer | 商品报价数量。 |
| original_price | number | 页面展示的原价数值。 |
| max_price | number | 页面提供的最高价格数值。 |
| shipping_price | number | 配送费数值。 |
| coupon_text | string | 优惠券说明原文。 |
| availability_text | string | 页面显示的可售状态原文。 |
| is_prime_eligible | boolean | Prime 资格标记。 |
| rating | number | 商品评分。 |
| review_count | integer | 评论数量。 |
| rating_distribution | array<object> | 评分分布列表;每项包含 stars(星级)和 percentage(占比)。 |
| reviews | array<object> | 评论列表;每项包含 id、title、rating、content、date_text、helpful_count 和 is_verified_purchase。 |
| review_summary | string | 评论摘要。 |
| specifications | object | 商品规格对象,包含 material、model_name、weight_text、manufacturer、model_number、unit_quantity_text、package_dimensions_text、first_available_date_text。 |
| specifications.material | string | 规格中的材质。 |
| specifications.model_name | string | 规格中的型号名称。 |
| specifications.weight_text | string | 重量及单位原文。 |
| specifications.manufacturer | string | 规格区域中的制造商。 |
| specifications.model_number | string | 型号编号。 |
| specifications.unit_quantity_text | string | 单位数量及计量单位原文。 |
| specifications.package_dimensions_text | string | 包装尺寸及单位原文。 |
| specifications.first_available_date_text | string | 首次上架日期原文。 |
示例返回 #
以下为返回结构示例,空值和默认值仅用于展示字段类型,不代表真实商品数据。
{
"url": "",
"asin": "",
"brand": "",
"price": 0,
"title": "",
"rating": 0,
"reviews": [{ "id": "", "title": "", "rating": 0, "content": "", "date_text": "", "helpful_count": 0, "is_verified_purchase": false }],
"currency": "",
"url_asin": "",
"max_price": 0,
"store_url": "",
"categories": [{ "category_path": [{ "url": "", "name": "" }] }],
"has_videos": false,
"image_urls": [""],
"coupon_text": "",
"description": "",
"offer_count": 0,
"parent_asin": "",
"sales_ranks": [{ "rank": 0, "category_path": [{ "url": "", "name": "" }] }],
"buybox_price": 0,
"manufacturer": "",
"review_count": 0,
"buybox_offers": [{ "price": 0, "availability_text": "" }],
"original_price": 0,
"review_summary": "",
"shipping_price": 0,
"specifications": { "material": "", "model_name": "", "weight_text": "", "manufacturer": "", "model_number": "", "unit_quantity_text": "", "package_dimensions_text": "", "first_available_date_text": "" },
"availability_text": "",
"is_prime_eligible": false,
"bullet_points_text": "",
"rating_distribution": [{ "stars": 0, "percentage": 0 }]
}
结果保留 #
采集结果保留 3 天。
使用注意 #
price表示模板返回的商品价格,不会自动替换为buybox_price。分析时请按用途选择对应字段。currency保留页面来源的币种代码或符号,不会统一换算。跨站点比较价格前,应自行确认币种并换算。- 示例返回是字段结构示例,不是真实采集数据。示例中的空字符串、
0和false不能据此理解为商品的实际值;例如original_price的0可能是占位值。 - 页面字段是对来源页面可获取信息的结构化整理;商品页面未展示或当次未能获取的字段可能为空或使用默认值。使用前应结合字段说明检查数据。