概览
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 同源。
- 类目 ID 与关键词
item必填string按“类目ID&&&&关键词”填写 Home Depot 搜索条件,例如“5yc1vZmqo&&&&Anker”;类目 ID 和关键词均不能为空。示例5yc1vZmqo&&&&Anker - 期望采集条数
limit必填string填写 1–1000 的正整数作为期望采集数量;结果按每批 24 条完整批次返回,实际数量可能向上取整,数量越大耗时越长。示例24 - 排序方式
order_type必填string(enum)选择 Home Depot 搜索结果的排序方式;未选择其他排序时按所选方式返回。可选值热销商品21价格升序51价格降序52热门产品6最受欢迎13示例51
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 业务标识
biz_idstring商品搜索记录的业务标识,通常由类目 ID 与关键词组成。示例5yc1vZmqo&&&&Anker - 规范路径
canonical_urlstringHome Depot 商品的规范相对路径。示例/p/Anker-SOLIX-E10-Infinite-Automatic-Backup-Kits-24kWh-7-680-Watt-Running-Wattages-Air-Cooled-WholeHouse-Generator-AnkerSolix-E10-2-Auto-backup2/341855752 - 类目 ID
category_idstring商品所属的 Home Depot 类目标识。示例5yc1vZmqo - 类目层级
category_levelinteger商品所属类目在 Home Depot 类目树中的层级。示例4
示例数据
以下示例按 output.schema 生成;未提供示例值的字段使用结构占位符。
{
"biz_id": "5yc1vZmqo&&&&Anker",
"canonical_url": "/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": "5yc1vZmqo",
"category_level": 4,
"category_name": "Home Standby Generators",
"category_path": "Outdoors:Outdoor Power Equipment:Generators:Home Standby Generators",
"category_url": "https://www.homedepot.com/b/Anker/N-5yc1vZmqo",
"crawl_time": "2026-09-11T14:48:15",
"item": "5yc1vZmqo&&&&Anker",
"keyword": "Anker",
"price": 15130.6,
"product_title": "SOLIX E10 Infinite Automatic Backup Kits 24kWh, 7,680-Watt Running Wattages, Air-Cooled WholeHouse Generator",
"product_url": "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": 5,
"review_count": 1,
"sku_id": "1015533081",
"source_create_time_ms": 1789109295968,
"source_date": "2026-09-11",
"spu_id": "341855752",
"task_item": "5yc1vZmqo&&&&Anker",
"no_data": false
}调用方式
本 App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"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 条计。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。