This repository demonstrates how to use OpenAI's Response API (with GPT-4.1 and tool calling) to extract the main product image URL from an e-commerce product page. It provides both Python and TypeScript implementations, returning a structured output for easy integration.

• Extracts the main product image URL from a given e-commerce product page.
• Uses OpenAI tool-calling to orchestrate the extraction process.
• Returns a structured response with the image URL, source URL, and extraction method.
• Supports both Python and TypeScript (Node.js) environments.

• The script fetches the product page HTML.
• It tries to extract the main image using Open Graph (og:image), a product image class, or the first image on the page.
• The result is returned in a structured format, including the extraction method used.

flowchart TD
    A[User provides product URL] --> B(OpenAI Response API: tool calling)
    B --> C{Tool: extract_image_url}
    C --> D[Fetch product page HTML]
    D --> E{Extraction strategies}
    E -->|og:image| F[Extract from Open Graph meta tag]
    E -->|product__media| G[Extract from product__media class]
    E -->|first_img| H[Extract first <img> tag]
    F & G & H --> I[Return structured output]
    I --> J[OpenAI returns structured JSON]
    J --> K[User receives image_url, source_url, found_method]

{
  "image_url": "http://minecraftshop.com/cdn/shop/files/MINE-PLU1_R_MF_1200x1200.jpg?v=1729532536",
  "source_url": "https://minecraftshop.com/collections/plush/products/minecraft-goat-8-plush",
  "found_method": "og:image"
}

• Python 3.8+ (for Python version)
• Node.js 18+ (for TypeScript version)
• Access to Azure OpenAI or OpenAI API (with appropriate keys and endpoint)

git clone <repo-url>
cd get-item-image

Copy .env.sample to .env and fill in your API keys and endpoints:

cp .env.sample .env

Edit .env and set:

• AZURE_OPENAI_V1_API_ENDPOINT
• AZURE_OPENAI_API_KEY
• AZURE_OPENAI_API_MODEL

pip install -r requirements.txt
# or manually:
pip install openai python-dotenv beautifulsoup4 requests

npm install

python get_item_image.py "https://minecraftshop.com/collections/plush/products/minecraft-goat-8-plush"

npx ts-node get_item_image.ts "https://minecraftshop.com/collections/plush/products/minecraft-goat-8-plush"

• get_item_image.py — Python implementation
• get_item_image.ts — TypeScript/Node.js implementation
• .env.sample — Example environment variable file
• demo.gif — Demo animation

MIT