ebay-item-detail

# eBay — Item Detail Extraction

> Input: an open eBay item URL (`/itm/{itemNumber}`) → Output: full detail JSON with 25+ fields (title, price, wasPrice, sold, available, seller, itemLocation, brand, MPN/UPC/EAN, condition, images, itemSpecifics map, whyToBuy signals, etc.).

## Language

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

## Objective

Given a live eBay item detail page, harvest every field visible on the listing that has clear semantic value (price surface, seller card, condition, item specifics table, sold / availability counters, item location, images) and return a compact JSON object suitable for downstream storage or comparison.

## Prerequisites

- Target page is already open in the browser: `https://www.ebay.{tld}/itm/{itemNumber}` — the extractor validates that the current URL matches `/itm/{digits}` and refuses to run otherwise.
- No login is required for public listings. Extraction runs against whatever the anonymous browser session sees.

## 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 `eval "$(python scripts/xxx.py {params})"`. `$(...)` is bash syntax; it is recommended to use the bash tool for execution.

Below are all atomic capabilities discovered and verified during the exploration phase. Simply invoke them as needed — no need to read `scripts/*.py` source code or re-verify. Only inspect scripts when execution fails for troubleshooting.

### DOM: extract full item detail from the current item page

Precondition: `navigate {item URL}` → `wait stable` first. The page URL must be an eBay item URL (`/itm/{digits}`).

Extract: `eval "$(python scripts/extract-item-detail.py)"`

Parameters: none.

Output example:
```json
{
  "url": "https://www.ebay.com/itm/127962632528",
  "itemNumber": "127962632528",
  "title": "2017 Apple MacBook Pro 13.3\" i7 3.5GHz 16GB RAM 500GB SSD Space Gray A1706",
  "subTitle": null,                                 // .x-item-title__subTitle; often null
  "categories": ["Electronics", "Computers/Tablets & Networking", "Laptops & Netbooks", "Apple Laptops"],  // breadcrumb, deduped
  "price": 284.99,                                  // parsed numeric price
  "priceWithCurrency": "C $284.99",                 // original price string (with "or Best Offer" suffix stripped)
  "currency": "CAD",                                // ISO code inferred from prefix (US $, C $, AU $, HK $, SG $, NZ $, plain $, €, £, ¥, or explicit ISO in string)
  "wasPrice": null,                                 // strikethrough / MSRP; null when not discounted
  "wasPriceWithCurrency": null,
  "available": 1,                                   // integer; 1 when text is "LAST ONE"
  "availableText": "LAST ONE",                      // original availability string
  "sold": 982,                                      // parsed sold count
  "image": "https://i.ebayimg.com/images/g/hyIAAeSw23FqTV51/s-l1600.jpg",  // primary photo, upgraded to s-l1600
  "images": [                                       // deduplicated hi-res gallery
    "https://i.ebayimg.com/images/g/hyIAAeSw23FqTV51/s-l1600.jpg"
  ],
  "seller": "PayMore Halifax",                      // seller display name (parsed from _ssn metadata first, falls back to .x-sellercard-atf__info)
  "sellerUrl": "https://www.ebay.com/str/paymorehalifax",  // seller storefront or profile URL
  "sellerFeedbackCount": 18,                        // integer (K suffix expanded, e.g. 15.9K -> 15900)
  "sellerPositiveRating": 100,                      // percent as float
  "itemLocation": "Halifax, Nova Scotia, Canada",   // parsed from ux-labels-values Location row or Shipping "Located in:" tail
  "brand": "Apple",                                 // from Item specifics
  "type": "MacBook Pro",                            // from Item specifics "Type" or falls back to "Model"
  "mpn": "A1706",                                   // from Item specifics
  "upc": null,                                      // from Item specifics
  "ean": null,                                      // from Item specifics
  "condition": "Used",                              // short condition label (New / Used / etc.), long marketing prose trimmed
  "shippingCost": "Free",                           // "Free" if any free-shipping wording detected, otherwise the first currency-prefixed price found in the shipping row
  "shipping": "Free UPS Standard Canada. See detailsfor shippingLocated in: Halifax, Nova Scotia, Canada",  // full shipping-row text
  "whyToBuy": ["982 sold", "Free shipping", "Last one"],  // composed selling signals: sold count, free shipping flag, last-one flag, percent-off, top-rated seller flag
  "itemSpecifics": {                                // full label -> value map from the Item specifics section
    "Brand": "Apple",
    "Color": "Space Gray",
    "MPN": "A1706",
    "Model": "MacBook Pro",
    "Condition": "Used: An item that has been used previously...",
    "Location": "Halifax, Nova Scotia, Canada"
  }
}
```

Error handling:
- If the page URL does not contain `/itm/{digits}` (e.g., a redirect landed on `/sch/i.html`), the script returns `{"error": true, "message": "current URL does not look like an eBay item page ..."}`. Root cause is usually that the itemNumber points to an ended / sold-out listing and eBay redirected to a simila