Home Depot Keyword Search

Give a Home Depot category ID, keyword, sort order, and expected count to get public search products with price, rating, category, and links.

原文 · en-US訳文に戻す

データ収集 E-commerce & Retail General Web Products

概要

Shoppers on Home Depot usually decide from search cards long before they open a product page: the title, the price on the card, the rating, the category path, and the product link. This app turns one category ID and keyword into a structured table of those public search listings so assortment, pricing, and category work can start from the same view a shopper would see.

Each row keeps the keyword, category, and original search item beside the product, so later comparisons stay attached to the query that produced them. It is a search-result workbook, not a substitute for a full product page.

Data notes

Each row is one product from a public Home Depot keyword search. Rows are returned in collection-time order from earliest to latest, and the same SKU ID is kept once in the returned set. Price, Rating, and Review count are the values shown on the search listing at collection time; Price is a number as returned and is not a normalized checkout total. Category name, Category path, and Category URL describe the listing's category snapshot, which can differ from other categories the same product appears in. Collected at and Source date are returned without a timezone. Keyword, Search item, Business ID, and Source item repeat the search context across rows from the same query.

The collection does not cover product-detail pages, variants, inventory history, orders, or seller-backend data, and it does not include listings that are not visible on the public search page. A No-data marker distinguishes a search item that produced no products from ordinary product rows.

What a result looks like

Each row is one Home Depot search-result product.

Product title	SKU ID	Price	Rating	Review count	Product URL
SOLIX E10 Infinite Automatic Backup Kits 24kWh, 7,680-Watt Running Wattages, Air-Cooled WholeHouse Generator	1015533081	15130.6	5.0	1	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
SOLIX E10 Infinite Automatic Backup Kits, 12kWh/15.2kW Rated Output, 5X Backup Time, Air-Cooled WholeHouse Generator	1015533079	11698.0	0.0	0	https://www.homedepot.com/p/Anker-SOLIX-E10-Infinite-Automatic-Backup-Kits-12kWh-15-2kW-Rated-Output-5X-Backup-Time-Air-Cooled-WholeHouse-Generator-AnkerSolix-E10-2-Auto-backup1/341855718

Category name, Category path, Keyword, and Collected at are also available when the listing shows them.

Use cases

For assortment checks, group rows by Keyword and Category name, then scan Product title and SKU ID to see which products occupy the first results for a query.
For list-price comparison, rank Price against Rating and Review count to see which cards look like premium versus entry listings.
For category mapping, read Category path with Category URL to see where Home Depot places the same keyword results.
For link harvesting, copy Product URL with Canonical path to open or archive the same search cards.

適用範囲と境界

One category-and-keyword search per task with an expected result count from 1 to 1000; coverage is limited to public Home Depot search listings.

適している用途
When you need public Home Depot search listings for one category ID and keyword.
When you need to compare list-page prices, ratings, review counts, categories, and product links from search results.

適さない用途
When you need a full product page, variants, inventory history, or specifications beyond the search listing.
When you need orders, seller-backend data, or non-public Home Depot business data.

失敗時の処理

作者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。

1If no products are returned, confirm the category ID and keyword combination is searchable on public Home Depot, then retry with a broader keyword.
2Keep completed records after a partial success; resubmit the same input after a failed or expired task.
3Retry later after rate limiting, temporary unavailability, or a timeout.
4If authentication fails, verify the API Key configured for the execution environment.

入力

この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。

フィールド	業務名称	型	必須	デフォルト	列挙値／制約	例	説明
item	Category ID and keyword	string	はい	—	—	5yc1vZmqo&&&&Anker	Enter one Home Depot search as category ID, four ampersands, then the keyword, such as 5yc1vZmqo&&&&Anker. Both parts are required and the whole value must be 512 characters or fewer.
crawl_count	Expected result count	string	はい	—	—	2	Expected number of search-result products, from 1 to 1000. The actual count may be slightly lower. Larger values take longer and cost more.
order_type	Sort order	string(enum)	はい	—	21 (Top selling) / 51 (Price low to high) / 52 (Price high to low) / 6 (Featured products) / 13 (Most popular)	51	Choose how Home Depot search results are sorted for this task.

出力

1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。

フィールド	業務名称	型	例	説明
biz_id	Business ID	string	5yc1vZmqo&&&&Anker	Search item key repeated on this product row.
canonical_url	Canonical path	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	Site-relative canonical path of the product page.
category_id	Category ID	string	5yc1vZmqo	Home Depot category identifier shown for this listing.
category_level	Category level	integer	4	Depth of the listing category in the Home Depot category tree.
category_name	Category name	string	Home Standby Generators	Leaf category name shown for this search listing.
category_path	Category path	string	Outdoors:Outdoor Power Equipment:Generators:Home Standby Generators	Colon-separated category path from the search listing.
category_url	Category URL	string	https://www.homedepot.com/b/Anker/N-5yc1vZmqo	Public Home Depot URL for the listing category.
crawl_time	Collected at	string	2026-09-11T14:48:15	Collection timestamp of this listing as returned, without a timezone.
item	Search item	string	5yc1vZmqo&&&&Anker	Category ID and keyword pair that produced this product row.
keyword	Keyword	string	Anker	Keyword used in the Home Depot search.
price	Price	number	15130.6	Search-listing display price as a number at collection time, not a checkout total.
product_title	Product title	string	SOLIX E10 Infinite Automatic Backup Kits 24kWh, 7,680-Watt Running Wattages, Air-Cooled WholeHouse Generator	Product title shown on the search listing.
product_url	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	Public Home Depot product page URL for this listing.
rating_score	Rating	number	5	Average rating shown on the search listing at collection time.
review_count	Review count	integer	1	Number of reviews shown on the search listing at collection time.
sku_id	SKU ID	string	1015533081	SKU identifier for this search-result product.
source_create_time_ms	Source time	integer	1789109295968	Source create time in milliseconds as returned.
source_date	Source date	string	2026-09-11	Source date of this listing as returned.
spu_id	Product ID	string	341855752	Home Depot product identifier for this listing.
task_item	Source item	string	5yc1vZmqo&&&&Anker	Task search item associated with this row.
no_data	No-data marker	boolean	false	Whether this search item produced no products.

レコード Schema

出力はレコード単位で 1 件ずつ返されます。 detail.output.idFieldHint

output.schema

{
  "type": "object",
  "properties": {
    "biz_id": {
      "type": "string",
      "title": "Business ID",
      "description": "Search item key repeated on this product row.",
      "prefill": "5yc1vZmqo&&&&Anker"
    },
    "canonical_url": {
      "type": "string",
      "title": "Canonical path",
      "description": "Site-relative canonical path of the product page.",
      "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": "Category ID",
      "description": "Home Depot category identifier shown for this listing.",
      "prefill": "5yc1vZmqo"
    },
    "category_level": {
      "type": "integer",
      "title": "Category level",
      "description": "Depth of the listing category in the Home Depot category tree.",
      "prefill": 4
    },
    "category_name": {
      "type": "string",
      "title": "Category name",
      "description": "Leaf category name shown for this search listing.",
      "prefill": "Home Standby Generators"
    },
    "category_path": {
      "type": "string",
      "title": "Category path",
      "description": "Colon-separated category path from the search listing.",
      "prefill": "Outdoors:Outdoor Power Equipment:Generators:Home Standby Generators"
    },
    "category_url": {
      "type": "string",
      "title": "Category URL",
      "description": "Public Home Depot URL for the listing category.",
      "prefill": "https://www.homedepot.com/b/Anker/N-5yc1vZmqo"
    },
    "crawl_time": {
      "type": "string",
      "title": "Collected at",
      "description": "Collection timestamp of this listing as returned, without a timezone.",
      "prefill": "2026-09-11T14:48:15"
    },
    "item": {
      "type": "string",
      "title": "Search item",
      "description": "Category ID and keyword pair that produced this product row.",
      "prefill": "5yc1vZmqo&&&&Anker"
    },
    "keyword": {
      "type": "string",
      "title": "Keyword",
      "description": "Keyword used in the Home Depot search.",
      "prefill": "Anker"
    },
    "price": {
      "type": "number",
      "title": "Price",
      "description": "Search-listing display price as a number at collection time, not a checkout total.",
      "prefill": 15130.6
    },
    "product_title": {
      "type": "string",
      "title": "Product title",
      "description": "Product title shown on the search listing.",
      "prefill": "SOLIX E10 Infinite Automatic Backup Kits 24kWh, 7,680-Watt Running Wattages, Air-Cooled WholeHouse Generator"
    },
    "product_url": {
      "type": "string",
      "title": "Product URL",
      "description": "Public Home Depot product page URL for this listing.",
      "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": "Rating",
      "description": "Average rating shown on the search listing at collection time.",
      "prefill": 5
    },
    "review_count": {
      "type": "integer",
      "title": "Review count",
      "description": "Number of reviews shown on the search listing at collection time.",
      "prefill": 1
    },
    "sku_id": {
      "type": "string",
      "title": "SKU ID",
      "description": "SKU identifier for this search-result product.",
      "prefill": "1015533081"
    },
    "source_create_time_ms": {
      "type": "integer",
      "title": "Source time",
      "description": "Source create time in milliseconds as returned.",
      "prefill": 1789109295968
    },
    "source_date": {
      "type": "string",
      "title": "Source date",
      "description": "Source date of this listing as returned.",
      "prefill": "2026-09-11"
    },
    "spu_id": {
      "type": "string",
      "title": "Product ID",
      "description": "Home Depot product identifier for this listing.",
      "prefill": "341855752"
    },
    "task_item": {
      "type": "string",
      "title": "Source item",
      "description": "Task search item associated with this row.",
      "prefill": "5yc1vZmqo&&&&Anker"
    },
    "no_data": {
      "type": "boolean",
      "title": "No-data marker",
      "description": "Whether this search item produced no products.",
      "prefill": false
    }
  },
  "required": [],
  "additionalProperties": false
}

連携方法

この App は MCP、API、SDK、ファイルエクスポートのいずれでも連携でき、どのチャネルも同じ能力と料金を共有します。すべてのリクエストは Authorization: Bearer ヘッダーで認証し、認証情報には API Key（長期有効。Data Hub コンソールで作成）を使用します。MCP クライアントは OAuth によるキー不要のログインにも対応しています。CLI や Skill など、さらに多くの連携方法も準備中です。

MCP（Model Context Protocol）を使うと、Claude や Cursor などの AI クライアントからこの App を直接呼び出せます。クライアントと認証方式を選び、下の設定をコピーしてください。

クライアント設定

Bearer の後の値を長期有効な API Key に置き換えてください。あらゆるクライアント、CI、ヘッドレス環境で利用できます。

mcpServers config

{
  "mcpServers": {
    "hello_moto__homedepot-keyword-search": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=hello_moto/homedepot-keyword-search",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

自分の API Keys を表示 →

AI に設定を任せる

設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します（プロンプトは AI があなたに API Key を尋ねる形になっているため、認証情報がチャット履歴や共有設定に残りません）。

detail.access.mcp.composeHint

料金

per task start

返される件数にかかわらず、実行の送信 1 回ごとに課金されます。

$0.0001/ 回

per product record

正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 24 件を 1 つの課金単位とし、端数は 24 件に切り上げて課金されます。

$0.005/ 24 件

複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。

Credits を確認

今すぐ試す

パラメータを入力して実行してください。結果は実際の呼び出しによるものです。

サンプル

パラメータは送信前に input.schema で検証されます

Category ID and keyworditem*Enter one Home Depot search as category ID, four ampersands, then the keyword, such as 5yc1vZmqo&&&&Anker. Both parts are required and the whole value must be 512 characters or fewer.

Expected result countcrawl_count*Expected number of search-result products, from 1 to 1000. The actual count may be slightly lower. Larger values take longer and cost more.

Sort orderorder_type*Choose how Home Depot search results are sorted for this task.

まず必須パラメータを入力してください

$0.005 / 24 件から