HomeDepot 商品搜索
yasina-homedepot-search搜家装建材五金商品，看这个渠道的价格标杆与同款条码。
这个技能能做什么
搜 Home Depot（家得宝）的在售商品 —— 做家居、建材、五金、园艺、工具这些类目时，这里才是真正的价格标杆，亚马逊上同类品的定价往往跟着它走。返回售价与划线价、省了多少与折扣百分比、品牌与型号、评分与评论数、角标（专营/清仓等）、是否免运费、是否免费送到店、系列名（同系列凑单是这个渠道的常见打法）、Home Depot 的商品 ID。支持关键词检索、**美国站与加拿大站**、价格区间、按门店查（价格与库存按门店不同）、排序、翻页，并返回该关键词下可用的筛选项。两个子命令：`--detail` 看单品详情（含 UPC 条码，可跨平台对同款）、`--reviews` 看买家评论（支持多星级组合筛选）。当用户提到家得宝、home depot、homedepot、五金、建材、家装、装修材料、工具、电动工具、水暖、油漆、园艺、木材、瓷砖、灯具、家居建材、北美家装渠道、线下家装、专业渠道价、home depot price, hardware, building materials, tools, home improvement, lumber 时触发此技能。即使用户未明确提及“家得宝”，只要其需求涉及家装建材五金类目的价格标杆、这类产品在北美专业渠道卖多少、要不要做这个家装类目，也应触发。不适用于：亚马逊商品（用 yasina-amazon-search）、沃尔玛商品（用 yasina-walmart-search）、一次看全网多个零售商报价（用 yasina-google-shopping）、非家装类目的商品（这个渠道只卖家居建材五金）。
怎么用
复制下面这句话，发给你的 AI 助手（WorkBuddy、Claude Code、Codex 都可以）：
下载 https://plusskill.oss-cn-guangzhou.aliyuncs.com/skills/yasina-homedepot-search.zip 并安装这个 skill，然后阅读这个 skill 告诉我如何使用
助手会自动下载安装并读懂用法，然后告诉你能问它什么。 首次使用它会引导你用手机号注册，赠送 50 积分。
入参
本技能覆盖 3 个端点，参数各不相同，按各自的表来传。
HomeDepot 商品搜索
POST /v2/homedepot/search| 参数 | 类型 | 必填 | 说明 | 默认 |
|---|---|---|---|---|
q | string | 是 | 搜索关键词 | — |
country | string | 否 | us / ca | us |
hd_sort | string | 否 | US 站的排序参数：top_sellers / price_low_to_high / price_high_to_low / top_rated / best_match。CA 站传它会报错，那边叫 sort | — |
sort | string | 否 | CA 站的排序参数（取值与 US 完全不同）：price-asc / price-desc / reviewAvgRating / relevance。US 站传它会报错，那边叫 hd_sort | — |
ps | int | 否 | US 站每页条数，上限 24。CA 站传它会报错，那边叫 pagesize | 24 |
pagesize | int | 否 | CA 站每页条数，上限 40。US 站传它会报错，那边叫 ps | 40 |
store_id | string | 否 | US 站门店 ID。CA 站传它会报错，那边叫 store | — |
store | string | 否 | CA 站门店 ID。US 站传它会报错，那边叫 store_id | — |
page | int | 否 | 页码 | 1 |
delivery_zip | string | 否 | 配送邮编 | — |
lowerbound | number | 否 | 最低价 | — |
upperbound | number | 否 | 最高价 | — |
单品详情（含 UPC 条码）
--detailPOST /v2/homedepot/product-detail| 参数 | 类型 | 必填 | 说明 | 默认 |
|---|---|---|---|---|
product_id | string | 是 | 商品 ID，取搜索结果 | — |
delivery_zip | string | 否 | 配送邮编 | — |
store_id | string | 否 | 门店 ID | — |
买家评论（支持多星级筛选）
--reviewsPOST /v2/homedepot/product-reviews| 参数 | 类型 | 必填 | 说明 | 默认 |
|---|---|---|---|---|
product_id | string | 是 | 商品 ID | — |
rating | int | 否 | 只看某个星级，1~5。支持英文逗号分隔多选（如 | — |
sort_by | string | 否 | 上游是连写小写：photoreview / mosthelpfull（上游自己的拼写，照传不要改对）/ oldest / newest / highestrating / lowestrating | — |
term | string | 否 | 在评论里搜关键词 | — |
verified_purchases | bool | 否 | 只看已验证购买 | — |
start | int | 否 | 起始位置 | 1 |
pagesize | int | 否 | 每页条数，上限 100 | 100 |
返回值
HomeDepot 商品搜索
POST /v2/homedepot/search| 字段 | 怎么用 |
|---|---|
products[] | 商品原样： |
search_information |
|
filters[] | 筛选项 |
pagination | 分页信息 |
taxonomy[] | 类目路径 |
单品详情（含 UPC 条码）
--detailPOST /v2/homedepot/product-detail| 字段 | 怎么用 |
|---|---|
product_results | 商品原样： |
search_information.taxonomy | 类目路径 |
买家评论（支持多星级筛选）
--reviewsPOST /v2/homedepot/product-reviews| 字段 | 怎么用 |
|---|---|
reviews[] | 评论原样： |
overall_rating | 总体评分 |
ratings[] | 星级分布（ |
search_information.total_results | ⚠️ 当前筛选条件下的条数，但它与 `ratings` 对不上，且系统性偏小 —— 实测同一商品： 所以 si 只能当「这次能翻到多少条」用，不能当某星级的真实总数 —— 要算占比请用 |
total_review | 评论总数（与 |
total_positive_recommendation / total_negative_recommendation | 推荐 / 不推荐数（实测 497 / 48）。⚠️ 两者之和远小于 |
积分收费规则
15 积分/次，两个子命令同价。翻页是另一次调用。
这个渠道只卖家居建材五金 —— 别的类目搜不到东西，调用前先确认用户的品类对得上。
调用失败（参数错误、数据源不可用）不扣积分。
对应的 API 端点
- POST
/v2/homedepot/search - POST
/v2/homedepot/product-detail - POST
/v2/homedepot/product-reviews