Universally extracts verified, high-resolution product photography and official sources across the web.

USE THIS TOOL WHEN:

• You need product photos, packshots, visual references, or master CDN assets for any physical item.

• You want Promas to automatically discover authoritative stores, scrape candidate pages, verify images via HTTP, and deduplicate near-identical photo crops.

EXAMPLE QUERIES:

• fetch_product_images(query="Sony FX3 Cinema Camera", max_images=5)

• fetch_product_images(query="Nike Air Jordan 1", site_filter="nike.com")

• fetch_product_images(query="https://www.target.com/p/apple-iphone-16-pro/-/A-93597960")

RETURNS:

• ProductImageResult containing:

  • status: 'success' or 'error'

  • title: Cleaned product title

  • sources_scraped: List of retail & brand URLs visited

  • images: List of verified master-resolution image URLs (up to 2500px+)

Discovers and ranks candidate e-commerce product pages for a given query (Discovery only).

USE THIS TOOL WHEN:

• You want to find authoritative product detail pages (PDPs) across retailers without downloading or scraping images yet.

• You want to preview which stores/URLs exist for a product before selecting one to scrape.

EXAMPLE CALL:

• search_product_urls(query="Sony FX3 Cinema Camera", max_urls=3)

• search_product_urls(query="MacBook Pro M3", site_filter="apple.com")

RETURNS:

• A list of ranked, direct product destination URLs.

Extracts high-resolution product imagery from a single direct product URL (Extraction only).

USE THIS TOOL WHEN:

• You already have an exact product URL (from search_product_urls or user input) and want to extract master photos strictly from that page.

• Uses universal Schema.org JSON-LD, OpenGraph, dynamic JS datasets, DOM selectors, and CDN upscalers.

EXAMPLE CALL:

• scrape_single_url(url="https://www.apple.com/iphone-16-pro/")

RETURNS:

• ProductImageResult containing extracted images and metadata from the specified URL.

Backward-compatible alias for fetch_product_images.