JP

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訳文に戻す

開発者
料金
$0.005 / 24 件から
最終更新
2026-09-18

概要

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 titleSKU IDPriceRatingReview countProduct URL
SOLIX E10 Infinite Automatic Backup Kits 24kWh, 7,680-Watt Running Wattages, Air-Cooled WholeHouse Generator101553308115130.65.01https://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 Generator101553307911698.00.00https://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.

失敗時の処理

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

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

入力

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

  • Category ID and keyworditem必須string
    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.
    例5yc1vZmqo&&&&Anker
  • Expected result countcrawl_count必須string
    Expected number of search-result products, from 1 to 1000. The actual count may be slightly lower. Larger values take longer and cost more.
    例2
  • Sort orderorder_type必須string(enum)
    Choose how Home Depot search results are sorted for this task.
    選択可能な値Top selling21Price low to high51Price high to low52Featured products6Most popular13例51

出力

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

  • Business IDbiz_idstring
    Search item key repeated on this product row.
    例5yc1vZmqo&&&&Anker
  • Canonical pathcanonical_urlstring
    Site-relative canonical path of the product page.
    例/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 IDcategory_idstring
    Home Depot category identifier shown for this listing.
    例5yc1vZmqo
  • Category levelcategory_levelinteger
    Depth of the listing category in the Home Depot category tree.
    例4

サンプルデータ

output.schema から生成したサンプルです。サンプル値のないフィールドには構造上のプレースホルダーを使用しています。

output.example
{
  "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(長期有効。Data Hub コンソールで作成)を使用します。MCP クライアントは OAuth によるキー不要のログインにも対応しています。CLI や Skill など、さらに多くの連携方法も準備中です。 この App は非同期で実行され、途中でキャンセルできます:キャンセル後、実行は停止します。納品済みのレコードは保持され、課金対象になります。

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

クライアント設定

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

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

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 で検証されます
$0.005 / 24 件から