概览
Home Depot 关键词搜索商品采集
面向商品研究、选品和价格比较场景,按 Home Depot 的类目与关键词获取公开搜索结果。结果保留商品标题、价格、评分、评论数、类目层级以及商品和类目链接,方便快速整理目标品类的商品清单。
数据说明
数据来自 Home Depot 公开商品搜索结果,记录带有搜索关键词、类目路径和采集时间。价格、评分和评论数保留来源返回的数值;来源日期和时间戳同时保留,便于按日期进行快照分析。搜索结果按每批 24 条完整批次返回,实际记录数可能略高于期望数量。
结果长什么样
| 商品标题 | 价格 | 评分 | 评论数 | 类目名称 | SKU 编号 | 商品链接 |
|---|---|---|---|---|---|---|
| SOLIX E10 Infinite Automatic Backup Kits 24kWh, 7,680-Watt Running Wattages, Air-Cooled WholeHouse Generator | 15130.6 | 5.0 | 1 | Home Standby Generators | 1015533081 | https://www.homedepot.com/p/Anker-SOLIX-E10-Infinite-Automatic-Backup-Kits-24kWh-7-680-Watt-Running-Wattages-Air-Cooled-WholeHouse-Generator-AnkerSolix-E10-2-Auto-backup2/341855752 |
应用场景
- 对比同一 Home Depot 类目下不同品牌或关键词的商品价格与评分。
- 汇总商品标题、SKU、评论数和商品链接,建立选品候选清单。
- 结合类目路径和采集日期,观察公开搜索结果的品类结构与变化。
适用边界
单次提交 1–1000 条期望数量,结果按每批 24 条完整批次返回,实际数量可能向上取整;覆盖公开 Home Depot 商品搜索结果。
- 适合用于
- 需要按 Home Depot 类目和关键词批量获取商品搜索结果时
- 需要比较商品价格、评分、评论数、分类和商品链接时
- 不要用于
- 需要单个商品的完整详情、变体或库存历史时——本 App 只覆盖搜索结果页公开信息
- 需要订单、销量或卖家后台数据时——本 App 不提供非公开业务数据
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1返回空结果时,先确认类目 ID 和关键词组合有效,再缩小检索范围后重新提交
- 2鉴权失败时检查执行环境中的 API Key 配置;限流或服务暂不可用时稍后重试
- 3任务部分成功时保留已返回的商品结果;任务失败或过期后可用相同条件重新提交
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
| 字段名 | 业务名称 | 类型 | 必填 | 默认值 | 枚举 / 约束 | 示例 | 说明 |
|---|---|---|---|---|---|---|---|
| item | 类目 ID 与关键词 | string | 是 | — | — | 5yc1vZmqo&&&&Anker | 按“类目ID&&&&关键词”填写 Home Depot 搜索条件,例如“5yc1vZmqo&&&&Anker”;类目 ID 和关键词均不能为空。 |
| limit | 期望采集条数 | string | 是 | — | — | 24 | 填写 1–1000 的正整数作为期望采集数量;结果按每批 24 条完整批次返回,实际数量可能向上取整,数量越大耗时越长。 |
| order_type | 排序方式 | string(enum) | 是 | — | 21(热销商品) / 51(价格升序) / 52(价格降序) / 6(热门产品) / 13(最受欢迎) | 51 | 选择 Home Depot 搜索结果的排序方式;未选择其他排序时按所选方式返回。 |
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
| 字段名 | 业务名称 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
| biz_id | 业务标识 | string | 5yc1vZmqo&&&&Anker | 商品搜索记录的业务标识,通常由类目 ID 与关键词组成。 |
| canonical_url | 规范路径 | string | /p/Anker-SOLIX-E10-Infinite-Automatic-Backup-Kits-24kWh-7-680-Watt-Running-Wattages-Air-Cooled-WholeHouse-Generator-AnkerSolix-E10-2-Auto-backup2/341855752 | Home Depot 商品的规范相对路径。 |
| category_id | 类目 ID | string | 5yc1vZmqo | 商品所属的 Home Depot 类目标识。 |
| category_level | 类目层级 | integer | 4 | 商品所属类目在 Home Depot 类目树中的层级。 |
| category_name | 类目名称 | string | Home Standby Generators | 商品所属的 Home Depot 类目名称。 |
| category_path | 类目路径 | string | Outdoors:Outdoor Power Equipment:Generators:Home Standby Generators | 从上级到当前类目的完整路径,使用冒号分隔。 |
| category_url | 类目链接 | string | https://www.homedepot.com/b/Anker/N-5yc1vZmqo | Home Depot 类目页面的完整链接。 |
| crawl_time | 采集时间 | string | 2026-09-11T14:48:15 | 该商品搜索记录的采集时间,保留接口返回的时间字符串。 |
| item | 采集项 | string | 5yc1vZmqo&&&&Anker | 生成该记录的类目 ID 与关键词组合。 |
| keyword | 搜索关键词 | string | Anker | 该商品结果对应的搜索关键词。 |
| price | 商品价格 | number | 15130.6 | Home Depot 搜索结果展示的商品价格数值。 |
| product_title | 商品标题 | string | SOLIX E10 Infinite Automatic Backup Kits 24kWh, 7,680-Watt Running Wattages, Air-Cooled WholeHouse Generator | Home Depot 搜索结果展示的商品标题。 |
| product_url | 商品链接 | string | https://www.homedepot.com/p/Anker-SOLIX-E10-Infinite-Automatic-Backup-Kits-24kWh-7-680-Watt-Running-Wattages-Air-Cooled-WholeHouse-Generator-AnkerSolix-E10-2-Auto-backup2/341855752 | Home Depot 商品详情页的完整链接。 |
| rating_score | 评分 | number | 5 | 商品在 Home Depot 搜索结果中的评分数值。 |
| review_count | 评论数 | integer | 1 | 商品在 Home Depot 上的评论数量。 |
| sku_id | SKU 编号 | string | 1015533081 | 商品的稳定 SKU 标识,用于识别和去重。 |
| source_create_time_ms | 来源创建时间 | integer | 1789109295968 | 来源系统记录的创建时间,使用 Unix 毫秒时间戳。 |
| source_date | 来源日期 | string | 2026-09-11 | 来源系统记录的日期字符串。 |
| spu_id | SPU 编号 | string | 341855752 | 商品的 SPU 标识。 |
| task_item | 任务采集项 | string | 5yc1vZmqo&&&&Anker | 任务元信息中记录的类目 ID 与关键词组合。 |
| no_data | 是否无数据 | boolean | false | 该任务采集项是否没有可用商品结果。 |
记录 Schema
输出按记录逐条返回。记录主键为 sku_id,去重、增量、关联以它为准。
{
"type": "object",
"properties": {
"biz_id": {
"type": "string",
"title": "业务标识",
"description": "商品搜索记录的业务标识,通常由类目 ID 与关键词组成。",
"prefill": "5yc1vZmqo&&&&Anker"
},
"canonical_url": {
"type": "string",
"title": "规范路径",
"description": "Home Depot 商品的规范相对路径。",
"prefill": "/p/Anker-SOLIX-E10-Infinite-Automatic-Backup-Kits-24kWh-7-680-Watt-Running-Wattages-Air-Cooled-WholeHouse-Generator-AnkerSolix-E10-2-Auto-backup2/341855752"
},
"category_id": {
"type": "string",
"title": "类目 ID",
"description": "商品所属的 Home Depot 类目标识。",
"prefill": "5yc1vZmqo"
},
"category_level": {
"type": "integer",
"title": "类目层级",
"description": "商品所属类目在 Home Depot 类目树中的层级。",
"prefill": 4
},
"category_name": {
"type": "string",
"title": "类目名称",
"description": "商品所属的 Home Depot 类目名称。",
"prefill": "Home Standby Generators"
},
"category_path": {
"type": "string",
"title": "类目路径",
"description": "从上级到当前类目的完整路径,使用冒号分隔。",
"prefill": "Outdoors:Outdoor Power Equipment:Generators:Home Standby Generators"
},
"category_url": {
"type": "string",
"title": "类目链接",
"description": "Home Depot 类目页面的完整链接。",
"prefill": "https://www.homedepot.com/b/Anker/N-5yc1vZmqo"
},
"crawl_time": {
"type": "string",
"title": "采集时间",
"description": "该商品搜索记录的采集时间,保留接口返回的时间字符串。",
"prefill": "2026-09-11T14:48:15"
},
"item": {
"type": "string",
"title": "采集项",
"description": "生成该记录的类目 ID 与关键词组合。",
"prefill": "5yc1vZmqo&&&&Anker"
},
"keyword": {
"type": "string",
"title": "搜索关键词",
"description": "该商品结果对应的搜索关键词。",
"prefill": "Anker"
},
"price": {
"type": "number",
"title": "商品价格",
"description": "Home Depot 搜索结果展示的商品价格数值。",
"prefill": 15130.6
},
"product_title": {
"type": "string",
"title": "商品标题",
"description": "Home Depot 搜索结果展示的商品标题。",
"prefill": "SOLIX E10 Infinite Automatic Backup Kits 24kWh, 7,680-Watt Running Wattages, Air-Cooled WholeHouse Generator"
},
"product_url": {
"type": "string",
"title": "商品链接",
"description": "Home Depot 商品详情页的完整链接。",
"prefill": "https://www.homedepot.com/p/Anker-SOLIX-E10-Infinite-Automatic-Backup-Kits-24kWh-7-680-Watt-Running-Wattages-Air-Cooled-WholeHouse-Generator-AnkerSolix-E10-2-Auto-backup2/341855752"
},
"rating_score": {
"type": "number",
"title": "评分",
"description": "商品在 Home Depot 搜索结果中的评分数值。",
"prefill": 5
},
"review_count": {
"type": "integer",
"title": "评论数",
"description": "商品在 Home Depot 上的评论数量。",
"prefill": 1
},
"sku_id": {
"type": "string",
"title": "SKU 编号",
"description": "商品的稳定 SKU 标识,用于识别和去重。",
"prefill": "1015533081"
},
"source_create_time_ms": {
"type": "integer",
"title": "来源创建时间",
"description": "来源系统记录的创建时间,使用 Unix 毫秒时间戳。",
"prefill": 1789109295968
},
"source_date": {
"type": "string",
"title": "来源日期",
"description": "来源系统记录的日期字符串。",
"prefill": "2026-09-11"
},
"spu_id": {
"type": "string",
"title": "SPU 编号",
"description": "商品的 SPU 标识。",
"prefill": "341855752"
},
"task_item": {
"type": "string",
"title": "任务采集项",
"description": "任务元信息中记录的类目 ID 与关键词组合。",
"prefill": "5yc1vZmqo&&&&Anker"
},
"no_data": {
"type": "boolean",
"title": "是否无数据",
"description": "该任务采集项是否没有可用商品结果。",
"prefill": false
}
},
"required": [],
"additionalProperties": false
}调用方式
本 App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"mona_kk__homedepot-keyword-search": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=mona_kk/homedepot-keyword-search",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
每提交一次任务计费一次,与返回条数无关。
按实际成功返回的数据条数计费,任务失败不计费。每 24 条为一个计费单位,不足 24 条按 24 条计。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。