エージェントブラウザを使用してホームデポの商品データをスクレイピングする方法

npm install -g scrapeless-scraping-browser

scrapeless-scraping-browser config set apiKey your_api_token_here
scrapeless-scraping-browser config get apiKey   # 確認

export SCRAPELESS_API_KEY=your_api_token_here

{
  "productId": "204279858",
  "productUrl": "https://www.homedepot.com/p/DEWALT-20V-MAX-Cordless-1-2-in-Drill-Driver-2-20V-1-3Ah-Batteries-Charger-and-Bag-DCD771C2/204279858",
  "productName": "DEWALT 20V MAX Cordless 1/2 in. Drill/Driver, (2) 20V 1.3Ah Batteries, Charger and Bag DCD771C2",
  "brand": "DEWALT",
  "sku": "1000014677",
  "modelNumber": "DCD771C2",
  "overallRating": 4.7,
  "totalReviews": 11168,
  "reviewsReturned": 10,
  "reviews": [
    {
      "title": "素晴らしいツール！",
      "text": "こちらを2週間使用していますが、値段以上の価値があります。品質は非常に良いです...",
      "rating": 5,
      "reviewer": { "name": "kevein" },
      "time": null,
      "original_source": { "name": "homedepot.com" }
    },
    {
      "title": null,
      "text": "古いCraftsmanのコードレスドリルを交換するために、Dewalt 20v max Drill/Driverを購入しました...",
      "rating": 5,
      "reviewer": { "name": "DIYer_Bill" },
      "time": null,
      "original_source": { "name": "homedepot.com" }
    }
    // ... 同じ形式のレビューがさらに8件
  ]
}

SESSION=$(scrapeless-scraping-browser new-session \
  --name "homedepot-product-data" \
  --ttl 1800 \
  --recording true \
  --proxy-country US \
  --json | jq -r '.data.taskId')

echo "Session: $SESSION"

SESSION=$(scrapeless-scraping-browser new-session \
  --name "homedepot-product-data" --ttl 1800 --recording true \
  --proxy-country US --json \
  | grep -oE '"taskId":"[^"]*"' | cut -d'"' -f4)

PRODUCT_ID="204279858"

PRODUCT_SLUG="DEWALT-20V-MAX-コードレス-1-2-インチ-ドリル-ドライバー-2-20V-1-3Ah-バッテリー-充電器-および-バッグ-DCD771C2"
PDP_URL="https://www.homedepot.com/p/$PRODUCT_SLUG/$PRODUCT_ID"

scrapeless-scraping-browser --session-id $SESSION open "$PDP_URL"
# 次の待機がナビゲーションが確定する前にプリウォームの
# chrome://new-tab-page/に解決しないように、短いポーズをとります。
scrapeless-scraping-browser --session-id $SESSION wait 1500
# H1プロダクトタイトルを待つ — JSON-LDブロックはサーバーでレンダリングされ、
# 同じ静的HTMLに統合され、H1が見えるときには必ず存在します。
# (`script[type="application/ld+json"]` で直接待たないでください — `wait`は
# 「可視」状態をデフォルトとしており、`<script>`要素は決して可視になりません。)
scrapeless-scraping-browser --session-id $SESSION wait 'h1'

scrapeless-scraping-browser --session-id $SESSION eval '
  (() => {
    const ld = [...document.querySelectorAll("script[type=\"application/ld+json\"]")]
      .map((s) => { try { return JSON.parse(s.textContent); } catch { return null; } })
      .filter(Boolean);
    const product = ld.find((o) => o["@type"] === "Product");
    if (!product) return JSON.stringify({ error: "このページにProduct JSON-LDがありません" });

    const productId =
      product.productID || product.sku ||
      location.pathname.match(/\/(\d+)(?:\/\d+)?(?:[/?#]|$)/)?.[1] || null;

    const offers = Array.isArray(product.offers) ? product.offers[0] : product.offers || null;
    const offerPrice = offers
      ? (offers.price ?? offers.priceSpecification?.price ?? offers.lowPrice ?? null)
      : null;
    const availability = offers?.availability
      ? String(offers.availability).replace(/^https?:\/\/schema\.org\//, "")
      : null;

    const images = []
      .concat(product.image || [])
      .flat()
      .filter(Boolean);

    const reviews = (Array.isArray(product.review) ? product.review : product.review ? [product.review] : [])
      .map((r) => ({
        title: r.headline || null,
        text: r.reviewBody || null,
        rating: Number(r.reviewRating?.ratingValue) || null,
        reviewer: { name: r.author?.name || null },
        time: r.datePublished || null,
        original_source: { name: "homedepot.com" },
      }));

    return JSON.stringify({
      productId,
      productUrl: location.href,
      productName: product.name,
      brand: product.brand?.name || product.brand || null,
      sku: product.sku || null,
      modelNumber: product.model || null,
      gtin: product.gtin13 || product.gtin14 || product.gtin12 || product.gtin8 || product.gtin || null,
      mpn: product.mpn || null,
      category: product.category || null,
      description: product.description || null,
      color: product.color || null,
      image: images[0] || null,
      images,
      offers: {
        price: offerPrice != null ? Number(offerPrice) : null,
        currency: offers?.priceCurrency || null,
        availability,
        priceValidUntil: offers?.priceValidUntil || null,
        itemCondition: offers?.itemCondition
          ? String(offers.itemCondition).replace(/^https?:\/\/schema\.org\//, "")
          : null,
        seller: offers?.seller?.name || null,
      },
      overallRating: Number(product.aggregateRating?.ratingValue) || null,
      totalReviews: Number(product.aggregateRating?.reviewCount) || null,
      reviewsReturned: reviews.length,
      reviews,
    });
  })()
'

# セッションはまだステップ2からPDP上にあります。価格領域がレンダリングされるのを待ち、
# 周囲のHTMLを覗いてアンカーを確認します。
scrapeless-scraping-browser --session-id $SESSION wait '[data-testid*="price" i], [class*="price" i], [data-component*="Price"]'
scrapeless-scraping-browser --session-id $SESSION get html '[data-testid*="price" i], [data-testid*="fulfillment" i]'

scrapeless-scraping-browser --session-id $SESSION eval '
  (() => {
    const text = (el) => (el ? el.textContent.replace(/\s+/g, " ").trim() : null);
    const number = (s) => {
      if (!s) return null;
      const m = String(s).replace(/,/g, "").match(/-?\d+(?:\.\d+)?/);
      return m ? Number(m[0]) : null;
    };

    const priceText =
      text(document.querySelector("[data-testid*=\"price\" i]")) ||
      text(document.querySelector("[class*=\"price\" i]"));
    const wasPriceText = text(document.querySelector(
      "[data-testid*=\"was-price\" i], [class*=\"was-price\" i], [data-testid*=\"strike\" i]"
    ));
    const onSale = !!wasPriceText && priceText !== wasPriceText;

    const promotion = text(document.querySelector("[data-testid*=\"promo\" i], [data-testid*=\"saving\" i]"));

    const fulfillment = [...document.querySelectorAll(
      "[data-testid*=\"fulfillment\" i] button, [aria-label*=\"Ship\" i], [aria-label*=\"Pickup\" i], [aria-label*=\"Delivery\" i]"
    )].map((btn) => {
      const label = btn.getAttribute("aria-label") || text(btn);
      return label ? { option: label, available: !btn.matches("[disabled], [aria-disabled=\"true\"]") } : null;
    }).filter(Boolean);

    const availabilityText = text(document.querySelector(
      "[data-testid*=\"availability\" i], [data-testid*=\"in-stock\" i]"
    ));

    const heroImg = document.querySelector(
      "img[data-testid*=\"main-image\" i], [data-testid*=\"image-gallery\" i] img, picture img"
    );

    const features = [...document.querySelectorAll(
      "[data-testid*=\"feature\" i] li, [class*=\"feature\" i] li, [data-testid*=\"highlights\" i] li"
    )].map(text).filter(Boolean).slice(0, 20);

    const specs = Object.fromEntries(
      [...document.querySelectorAll("[data-testid*=\"specs\" i] tr, [class*=\"specs\" i] tr")]
        .map((row) => {
          const cells = [...row.querySelectorAll("th, td")].map(text);
          return cells.length >= 2 ? [cells[0], cells.slice(1).join(" ")] : null;
        })
        .filter(Boolean)
    );

    return JSON.stringify({
      productUrl: location.href,
      price: number(priceText),
      priceText,
      wasPrice: number(wasPriceText),
      onSale,
      promotion,
      currency: "USD",
      fulfillment,
      availabilityText,
      image: heroImg?.currentSrc || heroImg?.src || null,
      features,
      specs,
    });
  })()
'

QUERY="cordless drill"
# クエリ内のスペースをエンコードします（ホームデポは標準的なURLエンコーディングを使用）
SEARCH_URL="https://www.homedepot.com/s/${QUERY// /%20}"

scrapeless-scraping-browser --session-id $SESSION open "$SEARCH_URL"
# 検索ページは二段階のレンダリングを行います：最初に
# 単一カードを持つReactプレースホルダースケルトンがマウントされ、その後本物の約24カードのグリッドが
# 構築されます。単純な`wait '[data-testid*="product-pod" i]'`はプレースホルダーで解決できるため、
# エクストラクタは空のグリッドに対して実行されます。実際のグリッド（≥ 5カード）を待機し、
# 単一の一致を待たないようにします。
scrapeless-scraping-browser --session-id $SESSION wait 3000
scrapeless-scraping-browser --session-id $SESSION eval \
  'document.querySelectorAll("[data-testid*=\"product-pod\" i], [data-pod-position]").length >= 5'

scrapeless-scraping-browser --session-id $SESSION eval '
  (() => {
    const text = (el) => (el ? el.textContent.replace(/\s+/g, " ").trim() : null);
    const number = (s) => {
      if (!s) return null;
const m = String(s).replace(/,/g, "").match(/-?\d+(?:\.\d+)?/);
return m ? Number(m[0]) : null;
};
const cards = [...document.querySelectorAll("[data-testid*=\"product-pod\" i], [data-pod-position]")];
const results = cards.map((c) => {
const link = c.querySelector("a[href*=\"/p/\"]");
const href = link?.getAttribute("href");
const productId = href?.match(/\/(\d{6,})(?:[/?#]|$)/)?.[1] || null;
const titleEl = c.querySelector("[data-testid*=\"product-title\" i], [class*=\"product-title\" i], h2, h3");
const ratingEl = c.querySelector("[aria-label*=\"out of\" i]");
const reviewCountEl = c.querySelector("[data-testid*=\"review-count\" i], [class*=\"review-count\" i]");
const priceEl = c.querySelector("[data-testid*=\"price\" i], [class*=\"price\" i]");
const brandEl = c.querySelector("[data-testid*=\"brand\" i], [class*=\"brand\" i]");
const img = c.querySelector("img");
return {
productId,
productUrl: href ? new URL(href, location.origin).href : null,
title: text(titleEl),
brand: text(brandEl),
price: number(text(priceEl)),
priceText: text(priceEl),
rating: number(ratingEl?.getAttribute("aria-label")),
reviewCount: number(text(reviewCountEl)),
image: img?.currentSrc || img?.src || null,
};
}).filter((r) => r.productId || r.productUrl);
const offset = Number(new URLSearchParams(location.search).get("Nao") || 0);
return JSON.stringify({
query: location.href,
page: Math.floor(offset / 24) + 1,
pageSize: results.length,
results,
});
})()

**ページネーションループ** 最初の5ページのために：

```bash
for offset in 0 24 48 72 96; do
scrapeless-scraping-browser --session-id $SESSION open "$SEARCH_URL?Nao=$offset"
scrapeless-scraping-browser --session-id $SESSION wait 1500
scrapeless-scraping-browser --session-id $SESSION wait '[data-testid*="product-pod" i], [data-pod-position]'
scrapeless-scraping-browser --session-id $SESSION eval '/* 同じリスティング抽出器 */' \
> "search-page-$((offset / 24 + 1)).json"
done

ZIP="90015"

# 1. PDPを開いて、ロケーションセレクタのアクセシビリティ参照を表示します。
scrapeless-scraping-browser --session-id $SESSION open \
"https://www.homedepot.com/p/$PRODUCT_SLUG/$PRODUCT_ID"
scrapeless-scraping-browser --session-id $SESSION wait 1500
scrapeless-scraping-browser --session-id $SESSION wait '[data-testid*="store-locator" i], [aria-label*="store" i]'
scrapeless-scraping-browser --session-id $SESSION snapshot -i > /tmp/pdp-refs.txt

# 2. 「ストアを変更」 / 「私のストア」をクリック → ZIPを入力 → 確認します。
#    スナップショットが返すものに応じて、以下の @e<n> 参照を調整してください。
scrapeless-scraping-browser --session-id $SESSION click @e15 # ストアを変更
scrapeless-scraping-browser --session-id $SESSION wait 800
scrapeless-scraping-browser --session-id $SESSION fill @e22 "$ZIP" # ZIP入力
scrapeless-scraping-browser --session-id $SESSION click @e25 # 検索 / 確認
scrapeless-scraping-browser --session-id $SESSION wait 1500
scrapeless-scraping-browser --session-id $SESSION wait '[data-testid*="fulfillment" i], [data-testid*="availability" i]'

# 3. 店舗ごとの在庫 + ストアバッジを抽出します。
scrapeless-scraping-browser --session-id $SESSION eval '
(() => {
const text = (el) => (el ? el.textContent.replace(/\s+/g, " ").trim() : null);
return JSON.stringify({
productUrl: location.href,
store: text(document.querySelector("[data-testid*=\"store-name\" i], [data-testid*=\"my-store\" i]")),
zip: "'$ZIP'",
```json
{
  "availabilityText": "テキスト(document.querySelector(\"[data-testid*='availability' i], [data-testid*='in-stock' i]\"))",
  "pickupEta": "テキスト(document.querySelector(\"[data-testid*='pickup' i], [aria-label*='Pickup' i]\"))",
  "stockCount": "テキスト(document.querySelector(\"[data-testid*='stock-count' i], [class*='stock-count' i]\"))"
}

REVIEWS_URL="https://www.homedepot.com/p/reviews/$PRODUCT_SLUG/$PRODUCT_ID/1"

scrapeless-scraping-browser --session-id $SESSION open "$REVIEWS_URL"
scrapeless-scraping-browser --session-id $SESSION wait 1500
# networkidleはホームデポでは安定しないため、レビューカードアンカーを待機します。
scrapeless-scraping-browser --session-id $SESSION wait "#reviews, [itemprop='review'], [data-testid*='review' i]"

# アンカーを確認するためにレビュー区域のHTMLを覗き見します
scrapeless-scraping-browser --session-id $SESSION get html "#reviews, [data-component*='Review' i]"

scrapeless-scraping-browser --session-id $SESSION eval '
  (() => {
    const text = (el) => (el ? el.textContent.replace(/\s+/g, " ").trim() : null);
    const number = (v) => {
      if (v == null) return null;
      const m = String(v).replace(/,/g, "").match(/-?\d+(?:\.\d+)?/);
      return m ? Number(m[0]) : null;
    };
    const unique = (xs) => [...new Set(xs.filter(Boolean))];

    const productId =
      location.pathname.match(/\/(\d+)(?:\/\d+)?(?:[/?#]|$)/)?.[1] || null;

    const root =
      document.querySelector("#reviews") ||
      document.querySelector("[data-component*=\"Review\" i]") ||
      document.querySelector("[data-testid*=\"review\" i]") ||
      document.body;

    const cards = [...root.querySelectorAll(
      "[itemprop=\"review\"], [data-testid*=\"review\" i], article, li"
    )].filter((c) => {
      const bodyStr = text(c) || "";
      const hasRating = !!c.querySelector("[aria-label*=\"out of\" i]");
      const looksReviewish = /(verified|recommend|helpful|review|purchased)/i.test(bodyStr);
      return bodyStr.length > 40 && (hasRating || looksReviewish);
    });

    const reviews = cards.map((c) => {
      const bodyStr = text(c) || "";
      const ratingLabel =
        c.querySelector("[aria-label*=\"out of\" i]")?.getAttribute("aria-label") ||
        text(c.querySelector("[data-testid*=\"rating\" i]"));
      const dateEl = c.querySelector("time, [datetime], [data-testid*=\"date\" i]");
      const helpfulText = unique(
        [...c.querySelectorAll("button, [aria-label*=\"helpful\" i]")]
          .map((el) => el.getAttribute("aria-label") || text(el))
      ).join(" ");
      return {
        id: c.getAttribute("id") || c.getAttribute("data-review-id") || null,
        title: text(c.querySelector("[data-testid*=\"title\" i], h3, h4")),
        text: text(c.querySelector("[data-testid*=\"body\" i], p")),
        rating: number(ratingLabel),
        isRecommended: /recommend/i.test(bodyStr)
          ? !/not recommend|would not recommend/i.test(bodyStr) : null,
        badges: unique(
          [...c.querySelectorAll("[data-testid*=\"badge\" i], [class*=\"badge\" i]")].map(text)
            .concat(bodyStr.match(/Verified Purchaser|Verified Buyer|Pro|Staff Pick|Incentivized/gi) || [])
        ),
        reviewer: { name: text(c.querySelector("[data-testid*=\"author\" i], [class*=\"author\" i]")) },
        time: dateEl?.getAttribute("datetime") || text(dateEl),
        original_source: { name: "homedepot.com" },

return JSON.stringify({ productId, productUrl: location.href, reviewsReturned: reviews.length, reviews });

レンダードDOMエクストラクタはレビューのページングのパス（ステップ8）、適用されたソート/フィルター（ステップ7）、およびワークフローがレビュー11+を必要とするたびに適用される。欠落したフィールドは、キーを削除するのではなく、`null` または `[]` として扱い、Home Depotがレビューカードテンプレートを回転させたときにダウンストリームパイプラインの安定性を保つ。

> **レビューごとのスキーマ:** `id`, `title`, `text`, `rating`, `badges`, `reviewer.name`（ネスト）、`time`, `original_source.name`（ネスト）、`images[].link`（オブジェクトの配列）、`total_positive_feedback`, `total_negative_feedback`、さらにScrapelessの追加情報 `isRecommended`（レビューのテキストから派生したブール値）と `verified`（バッジのテキストから派生したブール値）。欠落したフィールドは `null` または `[]` として保持し、ダウンストリームの消費者がDOMの回転にわたって安定するようにする。

もしレンドレビューのパスが待機後にゼロカードを返す場合、マイクロフロントエンドが完全に水和していない。待機を再試行し、`Access Denied` が返された場合は新しいセッションで再試行するか、ステップ2のJSON-LDトップ10とGraphQLページングパス（`/federation-gateway/graphql?opname=reviewSentiments`）にフォールバックして詳細なクエリを行う。

---

## ステップ7 — UIを介してレビューをソートおよびフィルタリング

Home Depotはレビューページに（最新、評価最高、評価最低、最も役立つ、写真レビューのみ）ソートオプションを公開している。それらのコントロールを同じ持続的セッション内で操作する — スナップショット → クリックの調整によりクッキーと適用された状態が保持されます。

> スニペット内の `@e34` / `@e35` / `@e36` / `@e41` リファレンスはプレースホルダー — Scrapeless `snapshot -i` はページレンダリングごとにリファレンスを動的に割り当てます。最初にスナップショットをキャプチャし、ソートドロップダウンとフィルターボタンの行を見つけ、実際の数字に置き換えてからクリックシーケンスを実行します。

```bash
# インタラクティブコントロールのアクセシビリティリファレンスを表示する
scrapeless-scraping-browser --session-id $SESSION snapshot -i > /tmp/reviews-refs.txt

# スナップショットからソートドロップダウン/フィルターボタンのリファレンスを特定し、クリックします。
# 通常のHome Depotレビューページでは、これらは次のように示されます：
#   @e34 [button] "ソート基準: 最も役立つ"
#   @e35 [button] "写真のみ"
#   @e36 [button] "確認済み購入者"
# 下の@refナンバーはスナップショットによって返されたものに調整してください。

scrapeless-scraping-browser --session-id $SESSION click @e34   # ソートドロップダウンを開く
scrapeless-scraping-browser --session-id $SESSION wait 800
scrapeless-scraping-browser --session-id $SESSION snapshot -i > /tmp/sort-options.txt
scrapeless-scraping-browser --session-id $SESSION click @e41   # "最新"オプション
scrapeless-scraping-browser --session-id $SESSION wait 1500
scrapeless-scraping-browser --session-id $SESSION wait "#reviews, [data-component*='Review' i]"

# レビュー領域が再描画された後、抽出を再実行する
scrapeless-scraping-browser --session-id $SESSION eval '/* ステップ6と同じレビュー抽出本体 */'

for page in $(seq 1 5); do
  scrapeless-scraping-browser --session-id $SESSION eval '/* レビュースキーマを抽出 */' \
    > "reviews-page-$page.json"

  # 表示されている「次へ」ページネーションコントロールをクリック
  scrapeless-scraping-browser --session-id $SESSION eval '
    (() => {
      const next = [...document.querySelectorAll("a, button")]
        .find((el) => /next/i.test(el.getAttribute("aria-label") || el.textContent || ""));
      if (!next) return false;
      next.scrollIntoView({ block: "center" });
      next.click();
      return true;
    })()
  '
  scrapeless-scraping-browser --session-id $SESSION wait 1500
  scrapeless-scraping-browser --session-id $SESSION wait "#reviews, [data-component*='Review' i]"
done

PRODUCT_ID="326716329"
SLUG="NextWall-31-35-sq-ft-Off-White-Faux-Shiplap-Vinyl-Paintable-Peel-and-Stick-Wallpaper-Roll-PP10000"

for page in $(seq 1 10); do

SID=$(scrapeless-scraping-browser new-session \
    --name "hd-reviews-p$page" --ttl 300 --proxy-country US --json \
    | jq -r '.data.taskId')

  URL="https://www.homedepot.com/p/reviews/$SLUG/$PRODUCT_ID/$page"
  scrapeless-scraping-browser --session-id $SID open "$URL"
  scrapeless-scraping-browser --session-id $SID wait 1500
  scrapeless-scraping-browser --session-id $SID wait "#reviews, [data-component*='Review' i]"
  scrapeless-scraping-browser --session-id $SID eval '/* review-extraction body */' \
    > "reviews-page-$page.json"
  scrapeless-scraping-browser stop $SID
done

// スキーマは実際にステップ 6 の eval が発行する内容を反映しています。
// フィールド値は説明用のサンプルであり、どの製品の固定スナップショットではありません。
{
  "productId": "326716329",
  "productUrl": "https://www.homedepot.com/p/reviews/<slug>/326716329/1",
  "reviewsReturned": 1,
  "reviews": [
    {
      "id": "abc123",
      "title": "簡単な取り付けと堅実な品質",
      "text": "製品はクリーンに取り付けられ、期待通りに動作しました。",
      "rating": 5,
      "isRecommended": true,
      "badges": ["認証購入者"],
      "reviewer": { "name": "HomeDepotCustomer" },
      "time": "2024-04-04",
      "original_source": { "name": "homedepot.com" },
      "images": [],
      "total_positive_feedback": 8,
      "total_negative_feedback": 0,
      "verified": true
    }
  ]
}

- **WAFインタースティシャル。** 一部のアロケーションはHome Depotの`アクセス拒否`ページにたどり着きます（`bodyLen` ≪ 1000、レビューマーカーなし）。ステップ6のスクリプトはそのページを検出する必要があります（例：`if (/Access Denied|Error Page/i.test(document.title)) throw`）ので、呼び出し元は新しいセッションで再試行します。

## 無料プランを取得してスクレイプを始める:
Scrapelessの活気あるコミュニティに参加して、$5-10の**無料プラン**を取得し、仲間の革新者たちとつながりましょう。

[Scrapeless公式Discordコミュニティ](https://discord.gg/stFPK2xKHY)
[Scrapeless公式Telegramコミュニティ](https://t.me/+uELlyZh2JGw1M2Ux)

---

## よくある質問

**Q1: Home Depotをスクレイピングするのにプロキシは必要ですか？**  
はい — 100%。Home Depotはアメリカの小売サイトであり、アメリカ以外の出入口には一般的なエラーページを表示します。`--proxy-country US`はすべてのセッションで必要です。

**Q2: 価格と履行オプションはどこにありますか — JSON-LDそれともレンダリングされたDOMですか？**  
両方です。JSON-LDは標準的な`offers.price`、`offers.priceCurrency`、および`offers.availability`（ステップ2）を提供します。セール価格のオーバーライド、現在のプロモーションテキスト、各店舗の在庫バッジ、履行ボタン（自宅配送/受け取り/配達）は、Reactがハイドレートした後にポピュレートされ、レンダリングされたDOMから抽出されます（ステップ3）。

**Q3: 店舗ごとの在庫をどうやってスクレイピングしますか？**  
ロケーションセレクターモーダルを操作します：PDPを開き、「店舗を変更」をクリックし、ZIPを入力し、確認します。同じセッション内の後続のeval呼び出しは地域のビューを返します。完全なスナップショット→クリック→入力の振り付けについてはステップ5を参照してください。モーダルにアクセスできない環境のために、クッキーセットフォールバック（`THD_LOCSTORE` / `THD_PERSIST`）がステップ5の最後に文書化されています。

**Q4: なぜ私のセッションは時々`ERR_TUNNEL_CONNECTION_FAILED`を返しますか？**  
プロキシプールにはアロケーション時に利用可能な住宅IPがありませんでした。新しいセッションを発行し、短時間再試行してください。

**Q5: なぜページは時々`アクセス拒否`を返しますか？**  
Home DepotのWAFは時々新しいアロケーションに挑戦します。新しいセッションを発行し、再試行してください。ステップ6のエクストラクターはエラーページのタイトルを検出し、呼び出し元が新しいセッションで再試行できるようにスローする必要があります。

**Q6: 検索およびカテゴリーのページはどのようにページネーションされますか？**  
`Nao` URLオフセット（`?Nao=24`、`?Nao=48`、…）を介して、ページあたり24枚のカードです。ステップ4ではリスティングエクストラクターとページネーションループを扱っています。カテゴリーランディングページ（`/b/<slug>`）は同じオフセットを受け入れます。

**Q7: 写真レビューのみをスクレイピングできますか？**  
はい。まずは表示可能な写真レビューのフィルターを試してください（ステップ7）。特定の製品にそのコントロールが存在しない場合、すべての表示可能なレビューを抽出し、`images.length > 0`でポストフィルターしてください。

**Q8: 最新または最低評価のレビューをどうやって取得しますか？**  
同じ永続セッション内のUIソートコントロールを使用します — スナップショット→クリックの振り付けはステップ7にあります。関連するコントロールをクリックし、レビュー領域が再レンダリングされるのを待ってから、抽出`eval`を再実行します。

**Q09: Home DepotがDOMを変更した場合はどうなりますか？**  
ディスカバーパスを再実行します：`get html "<region>"`、現在の安定したアンカー（`data-testid`、`aria-label`、`[itemprop]`、意味的ID）を特定し、`eval`セレクターを調整します。ハッシュ化されたクラス名を永続的なセレクターとして出荷しないでください。

**Q10: 1つのセッションで何製品を収集できますか？**  
信頼性のために、1つのScrapelessセッションを小さな論理的スクレイプ（いくつかのPDPまたはいくつかの検索ページ）に保ちなさい。大規模な作業には、タスクごとに新しいセッションを発行し、並行処理をホストごとに≤ 3に保ちます（ステップ8の並行ワーカーの注意）。ファンアウトを高くするためにホスト間でシャーディングします。

**Q11: AIエージェントなしで実行できますか？**  
はい。ステップ1〜8のCLIコマンドは、エンドツーエンドでbashとして動作します。エージェント駆動のワークフロー（スキル + 自然言語プロンプト）は推奨される道です。なぜなら、スキルは発見→抽出パターン、待機の落とし穴、並行ワーカーのルールを持たせるため、プロンプトは1行に保つことができるからです。

**Q12: なぜ単純な製品IDではなく標準の`/p/<slug>/<productId>` URLを使用するのですか？**  
単独のIDのみのURL（例：`/p/<productId>`）は、検証時にHome Depotの一般的なエラーページを返しました。標準のPDP URL `/p/<slug>/<productId>`および標準のレビューURL `/p/reviews/<slug>/<productId>/<page>`は信頼できるブラウザターゲットです。ページを開く前に製品IDをそれらの形状に解決してください。