🚀 VTEX Store Catalog & Regional Price Scraper

Enterprise-grade, ultra-lightweight web extraction micro-app designed for VTEX Intelligent Commerce & Enterprise Stores. Extracts full product catalogs, variants, pricing, stock availability, SKUs, and imagery directly into clean structured data without headless browser overhead.

---

⚡ Why Use This Extractor?

• Zero Headless Browser Overhead: Bypasses heavy Chromium/Playwright instances by directly targeting structured endpoints and embedded data payloads. Runs in milliseconds with minimal RAM.
• Pay-Per-Event (PPE): Never pay for idle compute or proxy time. Only pay $2.50 / 1,000 items, with free starter runs available on your monthly Apify plan.
• AI Agent & MCP Native: Built from the ground up for function calling in Claude Desktop, Cursor, OpenAI Assistants, and LangChain via Apify MCP Server.
• Export Anywhere: Download dataset results instantly in JSON, CSV, Excel, or stream via webhooks.

---

📥 Input Parameters

Parameter	Type	Required	Default	Description
startUrls	Array	Yes	[{ "url": "https://www.carrefour.com.ar" }]	One or more store URLs or category listing pages
maxItems	Integer	No	25	Maximum number of products to extract per run
useApifyProxy	Boolean	No	true	Route through datacenter/residential proxies for maximum uptime

Input JSON Example

{
  "startUrls": [
    { "url": "https://www.carrefour.com.ar" }
  ],
  "maxItems": 25,
  "useApifyProxy": true
}

---

📤 Sample Output Data

Extracted records are formatted and validated against strict schemas before delivery:

{
  "url": "https://www.carrefour.com.ar/televisor-smart-55-4k/p",
  "title": "Smart TV 55 Inch 4K UHD HDR",
  "status": "VALID",
  "engine": "Engine-Ecommerce-JsonLD",
  "extractedAt": "2026-10-22T02:00:00Z",
  "data": {
    "productId": "998877",
    "productName": "Smart TV 55 Inch 4K UHD HDR",
    "brand": "Samsung",
    "items": [
      {
        "itemId": "1001",
        "name": "55 Inch",
        "sellers": [
          {
            "price": 650000,
            "stock": 24
          }
        ]
      }
    ]
  }
}

---

🤖 AI Agent & MCP Integration (Claude / Cursor)

Use this Actor as an autonomous tool for AI agents via the official Apify MCP Server.

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": ["-y", "@apify/actors-mcp-server", "--token", "YOUR_APIFY_TOKEN"]
    }
  }
}

Prompt example for Claude / Cursor:

"Extract the product catalogue and current pricing from https://www.carrefour.com.ar using the vtex-ecommerce-catalog-price-scraper actor."

---

🔌 Automate with n8n / Make.com

1. In n8n or Make, add an Apify node or HTTP Request.
2. Actor ID / Name: joseabreuy/vtex-ecommerce-catalog-price-scraper.
3. Pass your startUrls list.
4. Pipe output items directly to Airtable, Google Sheets, Supabase, or PostgreSQL.

---

💻 Programmatic Usage (cURL & Python)

cURL

curl --request POST \
  --url "https://api.apify.com/v2/acts/joseabreuy~vtex-ecommerce-catalog-price-scraper/runs?token=YOUR_APIFY_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "startUrls": [{ "url": "https://www.carrefour.com.ar" }],
    "maxItems": 10
  }'

Python SDK

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("joseabreuy/vtex-ecommerce-catalog-price-scraper").call(
    run_input={"startUrls": [{"url": "https://www.carrefour.com.ar"}], "maxItems": 10}
)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["title"])

---

💰 Pricing & Free Trial

• Pay-Per-Event: Only $2.50 / 1,000 items
• Minimal Start Fee: $0.00005 per run
• Free Allowance: Use your default monthly $5.00 Apify credit to run thousands of extractions at zero out-of-pocket cost!