logo
languageJPdown
menu

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 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

カテゴリ名、カテゴリ経路、キーワード、収集日時も、リスティングに表示されている場合は利用できます。

利用シーン

  • 品揃えの確認では、キーワードとカテゴリ名で行をまとめ、商品タイトルと SKU ID を見て、その検索の上位商品を把握します。
  • 表示価格の比較では、価格を評価とレビュー数と並べ、プレミアム寄りかエントリー寄りかを見ます。
  • カテゴリ整理では、カテゴリ経路とカテゴリURL を読み、同じキーワード結果の置き場所を確認します。
  • リンク収集では、商品URL と正規パスを使って、同じ検索カードを開いたり保存したりします。

適用範囲と境界

1回のタスクでカテゴリとキーワードの検索は1件、期待結果件数は 1~1000。対象は公開 Home Depot 検索リスティングに限ります。

  • 適している用途
  • 1つのカテゴリ ID とキーワードで、公開 Home Depot 検索リスティングが必要なとき。
  • 検索結果の表示価格、評価、レビュー数、カテゴリ、商品リンクを比較したいとき。
  • 適さない用途
  • 検索リスティングを超える商品詳細ページ、バリエーション、在庫履歴、仕様が必要なとき。
  • 注文、売り手向けデータ、非公開の Home Depot 業務データが必要なとき。

失敗時の処理

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

  1. 1商品が返らない場合は、カテゴリ ID とキーワードの組み合わせが公開 Home Depot で検索できるか確認し、より広いキーワードで再試行してください。
  2. 2部分成功のあとは取得済みの行を残し、失敗または期限切れのあとは同じ条件で再提出してください。
  3. 3レート制限、一時的な利用不可、タイムアウトのあとは、しばらくしてから再試行してください。
  4. 4認証に失敗した場合は、実行環境に設定した API Key を確認してください。

入力

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

フィールド業務名称型必須デフォルト列挙値/制約例説明
itemカテゴリ ID とキーワードstringはい——5yc1vZmqo&&&&AnkerHome 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ビジネスIDstring5yc1vZmqo&&&&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カテゴリIDstring5yc1vZmqoこのリスティングに表示される Home Depot のカテゴリ識別子です。
category_levelカテゴリ階層integer4Home Depot カテゴリツリーにおけるこのリスティングの階層です。
category_nameカテゴリ名stringHome Standby Generatorsこの検索リスティングに表示される末端カテゴリ名です。
category_pathカテゴリ経路stringOutdoors:Outdoor Power Equipment:Generators:Home Standby Generators検索リスティングのコロン区切りカテゴリ経路です。
category_urlカテゴリURLstringhttps://www.homedepot.com/b/Anker/N-5yc1vZmqoリスティングカテゴリの公開 Home Depot URL です。
crawl_time収集日時string2026-09-11T14:48:15このリスティングの収集時刻です。タイムゾーンは付きません。
item検索条件string5yc1vZmqo&&&&Ankerこの商品行を生んだカテゴリ ID とキーワードの組です。
keywordキーワードstringAnkerHome Depot 検索に使ったキーワードです。
price価格number15130.6収集時点の検索リスティング表示価格(数値)です。会計合計ではありません。
product_title商品タイトルstringSOLIX E10 Infinite Automatic Backup Kits 24kWh, 7,680-Watt Running Wattages, Air-Cooled WholeHouse Generator検索リスティングに表示される商品タイトルです。
product_url商品URLstringhttps://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評価number5収集時点の検索リスティングに表示される平均評価です。
review_countレビュー数integer1収集時点の検索リスティングに表示されるレビュー数です。
sku_idSKU IDstring1015533081この検索結果商品の SKU 識別子です。
source_create_time_msソース時刻integer1789109295968返されたソース作成時刻(ミリ秒)です。
source_dateソース日string2026-09-11返されたこのリスティングのソース日です。
spu_id商品IDstring341855752このリスティングの Home Depot 商品識別子です。
task_item元の検索条件string5yc1vZmqo&&&&Ankerこの行に紐づくタスクの検索条件です。
no_dataデータなし標記booleanfalseこの検索条件が商品を返さなかったかどうかです。

レコード Schema

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

output.schema
{
  "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 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>" }
    }
  }
}

AI に設定を任せる

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

detail.access.mcp.composeHint

料金

タスク開始ごと

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

$0.0001/ 回
商品レコードごと

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

$0.005/ 24 件

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

Credits を確認

今すぐ試す

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

サンプル
パラメータは送信前に input.schema で検証されます
まず必須パラメータを入力してください
$0.005 / 24 件から