1. Bright Data CLI installed:
   bash

   curl -fsSL https://cli.brightdata.com/install.sh | bash

2. One-time login completed:
   bash

   bdata login    # or: bdata login --device  (SSH / headless)

if ! command -v bdata >/dev/null 2>&1; then
    echo "bdata CLI not installed — see skills/bright-data-best-practices/references/cli-setup.md"
elif ! bdata zones >/dev/null 2>&1; then
    echo "bdata not authenticated — run: bdata login"
fi

1. Clarify scope — What product (name, ASIN, or URL)? Which retailers (default: Amazon + Google Shopping)? Which country/region (default: US — it changes price, currency, availability, and which retailers apply)? What matters beyond price (reviews, shipping/Prime, new vs refurbished)?
2. Resolve, then collect — If you only have a product name, use

   amazon_product_search

   and

   bdata search --type shopping

   to resolve it to concrete product URLs/offers, then pull each retailer's structured data. Parallelize independent calls.
3. Normalize — Collapse every result into the single offer schema in references/output-and-pricing.md before comparing. Convert all prices to one currency and note the rate + date used.
4. Rank & flag — Sort by total landed cost (price + shipping). Flag out-of-stock, refurbished/used, and third-party-seller offers — a lower price that's unavailable or used is not the winner by default.
5. Deliver — Produce the comparison table (Output A), then the explicit "Best buy" recommendation. Every report names the cheapest in-stock option and any meaningful trade-offs.

• Resolve names to URLs first. You rarely have clean URLs up front. Use

  amazon_product_search "<query>" "https://www.amazon.com"

  and

  bdata search "<product>" --type shopping --json

  to find the exact items, then feed those URLs to product pipelines.
• Prefer pipelines over scraping for supported retailers. Amazon, Walmart, eBay, Best Buy, Google Shopping all have structured pipelines that return clean price/availability/rating JSON. Never

  bdata scrape amazon.com

  — Amazon blocks scrapers; the pipeline bypasses that reliably.
• Always pass

  --json

  when you need to parse or compare output.
• Be cost-efficient — a standard comparison is ~3–8

  bdata

  calls, not 50. Pull the offers the user asked about, not every seller on the page.
• Parallelize independent calls across multiple Bash tool calls in one response — don't wait for Amazon before starting Walmart.
• Every price needs a source URL and a collection timestamp. No unattributed or undated prices, ever.
• Never fabricate a price or fill gaps. If a retailer returns nothing, report it in "Gaps & caveats".

bdata scrape "https://retailer.example/product-page"

Pipeline names are inconsistent (

amazon_product

singular,

bestbuy_products

plural,

walmart_product

). Confirm with the type list before hardcoding — the

data-feeds

skill has the verified list, and keyword/multi-arg pipelines (

amazon_product_search

) take

<keyword> <domain_url>

, not a single URL.

• Country changes everything — price, currency, stock, and which retailers exist. Always confirm the region before running; default US only if the user doesn't say.
• Pass

  --country <code>

  to

  bdata search

  for localized SERP/shopping results (e.g.

  --country il

  for Israel,

  de

  ,

  uk

  ).
• Use the local Amazon domain in product URLs. Many regions (e.g. Israel) buy via

  amazon.com

  with international shipping and via local chains — cover both and label shipping/import implications.
• Normalize currencies to one display currency, state the rate and the date you used, and keep each offer's original-currency price in the dataset.

• The normalized offer record schema (row shape for both the table and the dataset output).
• Total-cost ranking rules (price + shipping + import/tax where known; in-stock and condition gates before declaring a winner).
• Currency normalization conventions.
• Output templates — A (comparison table + recommendation), B (structured dataset), C (both).

1. Every price has a source URL and a timestamp — no undated, unattributed prices.
2. Always show availability next to price — a cheaper out-of-stock offer is not the winner. Flag refurbished/used/third-party explicitly.
3. Name one "Best buy" — the cheapest in-stock, comparable-condition option, with the runner-up and why someone might pick it instead.
4. Be honest about gaps — list retailers that returned nothing or were gated this run. Note when a price looks stale or is a "from" range.
5. State currency and region — "$ USD · region: US" or the rate used for conversions.
6. Never estimate a missing price. Report the gap; don't fill it.