JP

Home Depot キーワード検索

Home Depot のカテゴリ ID、キーワード、並び順、期待件数を指定すると、価格・評価・カテゴリ・リンク付きの公開検索商品が得られます。

翻訳済み · ja-JP原文を表示

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

概要

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 から生成されています。

  • カテゴリ ID とキーワードitem必須string
    Home Depot の検索を、カテゴリ ID、アンパサンド4つ、キーワードの順で入力します。例: 5yc1vZmqo&&&&Anker。両方必須で、全体は 512 文字以内です。
    例5yc1vZmqo&&&&Anker
  • 期待結果件数crawl_count必須string
    検索結果商品の期待件数で、1~1000 です。実際の件数は少し少ない場合があります。値が大きいほど時間と費用が増えます。
    例2
  • 並び順order_type必須string(enum)
    このタスクの Home Depot 検索結果の並び順を選びます。
    選択可能な値売れ筋21価格の安い順51価格の高い順52おすすめ商品6人気順13例51

出力

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

  • ビジネスIDbiz_idstring
    この商品行に繰り返される検索条件キーです。
    例5yc1vZmqo&&&&Anker
  • 正規パスcanonical_urlstring
    商品ページのサイト相対の正規パスです。
    例/p/Anker-SOLIX-E10-Infinite-Automatic-Backup-Kits-24kWh-7-680-Watt-Running-Wattages-Air-Cooled-WholeHouse-Generator-AnkerSolix-E10-2-Auto-backup2/341855752
  • カテゴリIDcategory_idstring
    このリスティングに表示される Home Depot のカテゴリ識別子です。
    例5yc1vZmqo
  • カテゴリ階層category_levelinteger
    Home Depot カテゴリツリーにおけるこのリスティングの階層です。
    例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

料金

タスク開始ごと

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

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

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

$0.005/ 24 件

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

Credits を確認

今すぐ試す

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

サンプル
パラメータは送信前に input.schema で検証されます
$0.005 / 24 件から