Home Depot キーワード検索
Home Depot のカテゴリ ID、キーワード、並び順、期待件数を指定すると、価格・評価・カテゴリ・リンク付きの公開検索商品が得られます。
翻訳済み · ja-JP原文を表示
概要
Home Depot では、買い物客は商品ページを開く前に検索カードで判断することがほとんどです。タイトル、カード上の価格、評価、カテゴリ経路、商品リンクが先に目に入ります。このアプリは、1つのカテゴリ ID とキーワードを公開検索リスティングの表に変えるので、品揃え・価格・カテゴリの確認を買い物客と同じ検索画面から始められます。
各行にはキーワード、カテゴリ、元の検索条件が商品と一緒に残るため、後からの比較も同じクエリに紐づきます。これは検索結果のワークブックであり、商品詳細ページの代わりではありません。
データ説明
各行は、公開 Home Depot キーワード検索の商品 1 件です。行は収集時刻の早い順で返り、同じ SKU ID は結果セット内で 1 回だけ残します。価格、評価、レビュー数は収集時点の検索リスティング表示値です。価格は返された数値であり、会計合計ではありません。カテゴリ名、カテゴリ経路、カテゴリURL はそのリスティングのカテゴリのスナップショットで、同じ商品が属する他のカテゴリとは異なる場合があります。収集日時とソース日はタイムゾーンなしで返されます。キーワード、検索条件、ビジネスID、元の検索条件は、同じクエリの行で検索コンテキストを繰り返します。
対象外は、商品詳細ページ、バリエーション、在庫履歴、注文、売り手向けデータ、公開検索に出てこないリスティングです。データなし標記は、商品が 0 件だった検索条件と通常の商品行を区別します。
結果のイメージ
各行は Home Depot 検索結果の商品 1 件です。
| 商品タイトル | SKU ID | 価格 | 評価 | レビュー数 | 商品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 |
カテゴリ名、カテゴリ経路、キーワード、収集日時も、リスティングに表示されている場合は利用できます。
利用シーン
- 品揃えの確認では、キーワードとカテゴリ名で行をまとめ、商品タイトルと SKU ID を見て、その検索の上位商品を把握します。
- 表示価格の比較では、価格を評価とレビュー数と並べ、プレミアム寄りかエントリー寄りかを見ます。
- カテゴリ整理では、カテゴリ経路とカテゴリURL を読み、同じキーワード結果の置き場所を確認します。
- リンク収集では、商品URL と正規パスを使って、同じ検索カードを開いたり保存したりします。
適用範囲と境界
1回のタスクでカテゴリとキーワードの検索は1件、期待結果件数は 1~1000。対象は公開 Home Depot 検索リスティングに限ります。
- 適している用途
- 1つのカテゴリ ID とキーワードで、公開 Home Depot 検索リスティングが必要なとき。
- 検索結果の表示価格、評価、レビュー数、カテゴリ、商品リンクを比較したいとき。
- 適さない用途
- 検索リスティングを超える商品詳細ページ、バリエーション、在庫履歴、仕様が必要なとき。
- 注文、売り手向けデータ、非公開の Home Depot 業務データが必要なとき。
失敗時の処理
作者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。
- 1商品が返らない場合は、カテゴリ ID とキーワードの組み合わせが公開 Home Depot で検索できるか確認し、より広いキーワードで再試行してください。
- 2部分成功のあとは取得済みの行を残し、失敗または期限切れのあとは同じ条件で再提出してください。
- 3レート制限、一時的な利用不可、タイムアウトのあとは、しばらくしてから再試行してください。
- 4認証に失敗した場合は、実行環境に設定した API Key を確認してください。
入力
この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。
| フィールド | 業務名称 | 型 | 必須 | デフォルト | 列挙値/制約 | 例 | 説明 |
|---|---|---|---|---|---|---|---|
| item | カテゴリ ID とキーワード | string | はい | — | — | 5yc1vZmqo&&&&Anker | Home Depot の検索を、カテゴリ ID、アンパサンド4つ、キーワードの順で入力します。例: 5yc1vZmqo&&&&Anker。両方必須で、全体は 512 文字以内です。 |
| crawl_count | 期待結果件数 | string | はい | — | — | 2 | 検索結果商品の期待件数で、1~1000 です。実際の件数は少し少ない場合があります。値が大きいほど時間と費用が増えます。 |
| order_type | 並び順 | string(enum) | はい | — | 21 (売れ筋) / 51 (価格の安い順) / 52 (価格の高い順) / 6 (おすすめ商品) / 13 (人気順) | 51 | このタスクの Home Depot 検索結果の並び順を選びます。 |
出力
1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。
| フィールド | 業務名称 | 型 | 例 | 説明 |
|---|---|---|---|---|
| biz_id | ビジネスID | string | 5yc1vZmqo&&&&Anker | この商品行に繰り返される検索条件キーです。 |
| 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 | 商品ページのサイト相対の正規パスです。 |
| category_id | カテゴリID | string | 5yc1vZmqo | このリスティングに表示される Home Depot のカテゴリ識別子です。 |
| category_level | カテゴリ階層 | integer | 4 | Home Depot カテゴリツリーにおけるこのリスティングの階層です。 |
| category_name | カテゴリ名 | string | Home Standby Generators | この検索リスティングに表示される末端カテゴリ名です。 |
| category_path | カテゴリ経路 | string | Outdoors:Outdoor Power Equipment:Generators:Home Standby Generators | 検索リスティングのコロン区切りカテゴリ経路です。 |
| category_url | カテゴリURL | string | https://www.homedepot.com/b/Anker/N-5yc1vZmqo | リスティングカテゴリの公開 Home Depot URL です。 |
| crawl_time | 収集日時 | string | 2026-09-11T14:48:15 | このリスティングの収集時刻です。タイムゾーンは付きません。 |
| item | 検索条件 | string | 5yc1vZmqo&&&&Anker | この商品行を生んだカテゴリ ID とキーワードの組です。 |
| keyword | キーワード | string | Anker | Home Depot 検索に使ったキーワードです。 |
| price | 価格 | number | 15130.6 | 収集時点の検索リスティング表示価格(数値)です。会計合計ではありません。 |
| product_title | 商品タイトル | string | SOLIX E10 Infinite Automatic Backup Kits 24kWh, 7,680-Watt Running Wattages, Air-Cooled WholeHouse Generator | 検索リスティングに表示される商品タイトルです。 |
| product_url | 商品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 商品ページ URL です。 |
| rating_score | 評価 | number | 5 | 収集時点の検索リスティングに表示される平均評価です。 |
| review_count | レビュー数 | integer | 1 | 収集時点の検索リスティングに表示されるレビュー数です。 |
| sku_id | SKU ID | string | 1015533081 | この検索結果商品の SKU 識別子です。 |
| source_create_time_ms | ソース時刻 | integer | 1789109295968 | 返されたソース作成時刻(ミリ秒)です。 |
| source_date | ソース日 | string | 2026-09-11 | 返されたこのリスティングのソース日です。 |
| spu_id | 商品ID | string | 341855752 | このリスティングの Home Depot 商品識別子です。 |
| task_item | 元の検索条件 | string | 5yc1vZmqo&&&&Anker | この行に紐づくタスクの検索条件です。 |
| no_data | データなし標記 | boolean | false | この検索条件が商品を返さなかったかどうかです。 |
レコード Schema
出力はレコード単位で 1 件ずつ返されます。 detail.output.idFieldHint
{
"type": "object",
"properties": {
"biz_id": {
"type": "string",
"title": "ビジネスID",
"description": "この商品行に繰り返される検索条件キーです。",
"prefill": "5yc1vZmqo&&&&Anker"
},
"canonical_url": {
"type": "string",
"title": "正規パス",
"description": "商品ページのサイト相対の正規パスです。",
"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": "この検索リスティングに表示される末端カテゴリ名です。",
"prefill": "Home Standby Generators"
},
"category_path": {
"type": "string",
"title": "カテゴリ経路",
"description": "検索リスティングのコロン区切りカテゴリ経路です。",
"prefill": "Outdoors:Outdoor Power Equipment:Generators:Home Standby Generators"
},
"category_url": {
"type": "string",
"title": "カテゴリURL",
"description": "リスティングカテゴリの公開 Home Depot URL です。",
"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": "Home Depot 検索に使ったキーワードです。",
"prefill": "Anker"
},
"price": {
"type": "number",
"title": "価格",
"description": "収集時点の検索リスティング表示価格(数値)です。会計合計ではありません。",
"prefill": 15130.6
},
"product_title": {
"type": "string",
"title": "商品タイトル",
"description": "検索リスティングに表示される商品タイトルです。",
"prefill": "SOLIX E10 Infinite Automatic Backup Kits 24kWh, 7,680-Watt Running Wattages, Air-Cooled WholeHouse Generator"
},
"product_url": {
"type": "string",
"title": "商品URL",
"description": "このリスティングの公開 Home Depot 商品ページ URL です。",
"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": "収集時点の検索リスティングに表示される平均評価です。",
"prefill": 5
},
"review_count": {
"type": "integer",
"title": "レビュー数",
"description": "収集時点の検索リスティングに表示されるレビュー数です。",
"prefill": 1
},
"sku_id": {
"type": "string",
"title": "SKU ID",
"description": "この検索結果商品の SKU 識別子です。",
"prefill": "1015533081"
},
"source_create_time_ms": {
"type": "integer",
"title": "ソース時刻",
"description": "返されたソース作成時刻(ミリ秒)です。",
"prefill": 1789109295968
},
"source_date": {
"type": "string",
"title": "ソース日",
"description": "返されたこのリスティングのソース日です。",
"prefill": "2026-09-11"
},
"spu_id": {
"type": "string",
"title": "商品ID",
"description": "このリスティングの Home Depot 商品識別子です。",
"prefill": "341855752"
},
"task_item": {
"type": "string",
"title": "元の検索条件",
"description": "この行に紐づくタスクの検索条件です。",
"prefill": "5yc1vZmqo&&&&Anker"
},
"no_data": {
"type": "boolean",
"title": "データなし標記",
"description": "この検索条件が商品を返さなかったかどうかです。",
"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": {
"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>" }
}
}
}AI に設定を任せる
設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します(プロンプトは AI があなたに API Key を尋ねる形になっているため、認証情報がチャット履歴や共有設定に残りません)。
detail.access.mcp.composeHint
料金
返される件数にかかわらず、実行の送信 1 回ごとに課金されます。
正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。 24 件を 1 つの課金単位とし、端数は 24 件に切り上げて課金されます。
複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。
Credits を確認今すぐ試す
パラメータを入力して実行してください。結果は実際の呼び出しによるものです。