amazon-product-detail

# Amazon — Product Detail

> Input any Amazon product URL → output full product record (100+ fields).

## Language

All process output to user (progress updates, process notifications) follows the user's language.

## Objective

Extract the complete product record from any Amazon detail page URL across all Amazon regional TLDs, including price, ratings breakdown, attributes, variants, bestseller ranks, seller info, delivery, and sample reviews.

## Prerequisites

- Target page is already open in the browser: any Amazon product URL (e.g. `https://www.amazon.com/dp/{ASIN}`, `https://www.amazon.com/gp/product/{ASIN}`, `https://www.amazon.co.uk/dp/{ASIN}`, or the canonical SEO-slug URL `https://www.amazon.com/{slug}/dp/{ASIN}`)
- No login required

## Pre-execution Checks

### 1. Tool Readiness

If browser-act has been confirmed available in the current session → skip this step.

Invoke `browser-act` via Skill tool to load usage. If installation or configuration issues arise, follow its guidance to resolve then retry.

## Capability Components

> This Skill's operational boundary = what the user can manually do in their browser. It only reads data already displayed to the user on the page, never bypassing authentication or access controls. Its role is equivalent to copy-pasting on the user's behalf — the data is already on screen, automation merely saves time. JS code is encapsulated in Python files under the `scripts/` directory, invoked via `browser-act --session {name} eval "$(python scripts/xxx.py {params})"`. The `$(...)` is bash command substitution — it runs the python script, captures its printed JS text, and hands that JS string as a single argument to `browser-act eval`. Do not run `eval "$(python ...)"` as a bare shell command; that would ask bash to execute the JS as shell, which fails.

### DOM: extract full product detail from current product page

Amazon detail pages are server-rendered HTML — no XHR/fetch API for detail data. All fields come from stable DOM selectors:

1. `navigate {any Amazon product URL, e.g. https://www.amazon.com/dp/{ASIN}}`
2. `wait stable`
3. Extract: `browser-act --session {name} eval "$(python scripts/extract-product-detail.py)"`

On error paths, the script returns:
- `{"error": true, "message": "product_not_found: 404 page"}` when the URL resolves to Amazon's not-found page
- `{"error": true, "message": "productTitle not found - page may not be a product detail page"}` when the URL resolves to a non-detail page (e.g. search results, homepage)

Output example:
```json
{
  "asin": "B09S3HNMHF",                                // parsed from /dp/{ASIN} or /gp/product/{ASIN} path segment
  "url": "https://www.amazon.com/dp/B09S3HNMHF",       // canonical origin + pathname
  "title": "Samsung 14\" Galaxy Chromebook Go ...",    // #productTitle
  "brand": "Samsung",                                  // #bylineInfo, falls back to attributesMapped.Brand/Manufacturer
  "price": {"value": 179.99, "currencyRaw": "$", "raw": "$179.99"},   // current buybox price, null when no offer
  "listPrice": {"value": 190.99, "currencyRaw": "$", "raw": "$190.99"}, // strike-through list price, null when absent
  "stars": 4.3,                                        // 0-5 average rating, null when no reviews
  "reviewsCount": 632,                                 // total review count, null when no reviews
  "starsBreakdown": {"5 star": 70, "4 star": 13, "3 star": 5, "2 star": 3, "1 star": 9},  // percentage per star bucket
  "answeredQuestions": null,                           // number, null when absent or non-numeric
  "inStock": true,                                     // derived from availability text, null when unclear
  "inStockText": "In Stock",                           // raw #availability text
  "delivery": "FREE delivery Wednesday, July 15",      // primary delivery message, null when absent
  "fastestDelivery": null,                             // secondary/fastest delivery, null when absent
  "returnPolicy": "30-day return period",              // null when absent
  "breadCrumbs": "Electronics > Computers > Laptops > Traditional Laptops",  // joined with ' > ', "" when absent
  "features": ["Slim design", "12-hour battery", "..."],  // #feature-bullets bullet points
  "description": "A+ in performance and value...",     // #productDescription, null when absent
  "bookDescription": null,                             // #bookDescription_feature_div for books, null otherwise
  "thumbnailImage": "https://m.media-amazon.com/images/I/51...jpg",
  "highResolutionImages": ["https://m.media-amazon.com/images/I/51...SY450_.jpg", "..."],  // from #imgTagWrapperId data-a-dynamic-image JSON
  "galleryThumbnails": ["https://m.media-amazon.com/images/I/41...jpg", "..."],
  "productOverview": [{"key": "Brand", "value": "Samsung"}, {"key": "Model Name", "value": "XE340XDA-KA2US"}],  // #productOverview_feature_div table
  "attributes": [{"key": "Color", "value": "Silver"}, {"key": "Item Weight", "value": "3.2 pounds"}],  // technical spec tables
  "attributesMapped": {"Brand": "Samsung", "Item Weight": "3.2 pounds"},  // flat merged key-value
  "bestsellerRanks": [
    {"rank": 44, "category": "Computers & Accessories", "url": "https://www.amazon.com/gp/bestsellers/pc/..."},
    {"rank": 5, "category": "Traditional Laptop Computers", "url": "https://www.amazon.com/gp/bestsellers/pc/13896615011/..."}
  ],
  "variantAttributes": [{"key": "Color", "value": "Silver"}],  // currently selected variant dimensions
  "variantAsins": ["B09S3HNMHF", "B0G4WBD45V", "B0GG2CPM1K"],  // all variant ASINs from swatches, empty [] when no variants
  "seller": {"name": "Amazon.com", "id": "ATVPDKIKX0DER", "url": "https://www.amazon.com/sp?seller=..."},  // null when no seller link
  "isAmazonChoice": false,                             // .ac-badge-rectangle presence
  "amazonChoiceText": null,                            // Amazon's Choice label text, null when badge absent
  "monthlyPurchaseVolume":