# Frávega Argentina Scraper - Precios, Cuotas y Stock (`latinamericadata/fravega-argentina`) Actor

Extrae electrodomésticos y tecnología de Frávega Argentina. Obtén precios, cuotas, stock, SKU, EAN, marcas y URLs en Dataset, JSON, CSV, Excel o API.

- **URL**: https://apify.com/latinamericadata/fravega-argentina.md
- **Developed by:** [Latin America Data](https://apify.com/latinamericadata) (community)
- **Categories:** Automation, E-commerce, Integrations
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Frávega Argentina Scraper - Precios, Cuotas y Stock

Extraé electrodomésticos, tecnología y productos para el hogar de Frávega Argentina y obtené precios, cuotas, stock, SKU, EAN, marcas, vendedores y URLs de producto. El Actor organiza los resultados en un Dataset listo para descargar como JSON, CSV o Excel, o para integrar mediante API.

Para quienes buscan una Frávega Argentina API o un scraper Frávega para automatizar consultas, este Actor entrega precios, cuotas y stock de televisores, celulares, informática, electrodomésticos y artículos para el hogar. Es útil tanto para consultas puntuales como para monitoreo de precios y ofertas del marketplace de Frávega en Argentina.

### Para qué sirve este Actor

Este Actor automatiza la consulta del catálogo público de Frávega Argentina. Podés buscar electrodomésticos, tecnología y productos para el hogar por palabra clave con `searchTerms` o recorrer categorías con `categories`, controlar el volumen y solicitar detalles comerciales y técnicos.

Cada fila exitosa representa una combinación de SKU y vendedor, porque un mismo producto puede tener ofertas de Frávega o de distintos vendedores de su marketplace. La paginación usa un orden determinístico y deduplicación para evitar repetir productos. Además, conserva `source_url`, `request_url` y `scraped_at` para que puedas auditar el origen y la fecha de cada dato.

### Casos de uso

- Monitorear precios, stock y cuotas de electrodomésticos, tecnología y hogar.
- Comparar precio actual, precio de lista, descuento, financiación y vendedor.
- Seguir televisores, celulares, notebooks, climatización, cocina, línea blanca y muebles.
- Comparar ofertas de Frávega y vendedores externos dentro de su marketplace.
- Detectar cambios de disponibilidad y promociones en ejecuciones programadas.
- Alimentar catálogos, tableros, alertas, agentes de IA e inteligencia competitiva.
- Integrar datos de Frávega Argentina con una API o exportarlos a JSON, CSV y Excel.

### Qué datos entrega

- Identificadores `product_id`, `sku_id` y `ean`.
- Nombre del producto y del SKU, marca, categoría y especificaciones.
- `price`, `list_price`, `discount_percent` y `currency`.
- Disponibilidad, cantidad informada, vendedor, promociones y cuotas.
- Cantidad de cuotas y valor de cuota cuando la fuente los informa.
- Descripción, imagen y URL pública del producto cuando están disponibles.
- Estado `success` en cada fila del Dataset. Los estados operativos `no_results`, `blocked` y `failed` se registran en `RUN_SUMMARY` y en los logs sin crear resultados artificiales.

### Ejemplo de entrada

```json
{
  "searchTerms": ["cable"],
  "maxItems": 100,
  "withDetails": true
}
```

### Resultado de ejemplo

```json
{
  "status": "success",
  "country": "AR",
  "source": "Frávega Argentina",
  "input_type": "search",
  "input_value": "cable",
  "page": 1,
  "product_id": "12345",
  "sku_id": "67890",
  "ean": "7790000000000",
  "product_name": "Cable HDMI 2 metros",
  "brand": "Marca de ejemplo",
  "category": "Cables y conectividad",
  "price": 799999,
  "list_price": 899999,
  "currency": "ARS",
  "available": true,
  "installment_count": 12,
  "installment_value": 66666.58,
  "source_url": "https://www.fravega.com/cable-hdmi-producto-de-ejemplo/p"
}
```

Los valores son ilustrativos. La estructura refleja los nombres de campo reales del Dataset.

### Inicio rápido

1. Abrí el Actor en Apify Console.
2. Cargá uno o más términos en `searchTerms`, o categorías en `categories`.
3. Definí `maxItems` o `maxPages` si querés limitar costo y duración.
4. Activá `withDetails` para incluir descripción, especificaciones, promociones y cuotas.
5. Ejecutá el Actor y revisá la pestaña Dataset.

### Input

| Campo | Uso |
| --- | --- |
| `searchTerms` | Productos, marcas o palabras clave para buscar. |
| `categories` | IDs, rutas o URLs completas de categorías VTEX. |
| `maxItems` | Máximo opcional de registros guardados entre todos los objetivos. |
| `maxPages` | Máximo opcional de páginas por búsqueda o categoría. |
| `startPage` | Primera página que se solicitará, numerada desde 1. |
| `pageSize` | Productos solicitados por página, hasta 50. |
| `sortOrder` | Orden determinístico aplicado a la paginación. |
| `withDetails` | Incluye descripción, especificaciones, promociones y cuotas. |
| `includeUnavailable` | Incluye SKU y vendedores sin stock. |
| `requestDelayMillis` | Espera entre solicitudes al catálogo. |
| `requestTimeoutSecs` | Tiempo máximo por solicitud. |
| `retries` | Cantidad máxima de intentos ante un error transitorio. |
| `failOnNoResults` | Hace fallar la ejecución si no hay coincidencias. |

`maxItems` y `maxPages` son opcionales. Si no los definís, el Actor continúa hasta agotar el alcance seleccionado.

### Precios

El Actor utiliza pago por evento con una tarifa plana y predecible.

| Evento | Precio y cuándo se cobra |
|---|---|
| `apify-default-dataset-item` (`result`, evento principal) | USD 0.003 por cada producto o SKU guardado en el Dataset predeterminado (USD 3.00 cada 1.000 resultados). |
| Actor start | USD 0.00005 al iniciar la ejecución. Es un evento sintético administrado por Apify; los primeros 5 segundos de uso no generan costo de plataforma. |

`result` es el evento principal que Apify usa para mostrar y comunicar el precio. `withDetails` entrega más campos pero mantiene el mismo precio por resultado. Las filas operativas `no_results`, `blocked` y `failed` no se guardan ni se cobran como `result`: el diagnóstico queda en `RUN_SUMMARY` y en los logs. Una ejecución sin resultados puede conservar el cargo de Actor start.

Si el usuario define un cargo máximo para la ejecución, el Actor reduce preventivamente `maxItems` de acuerdo con la tarifa de USD 0.003 y respeta el límite más bajo entre ese cálculo y el `maxItems` solicitado. Si el límite no alcanza para un resultado, finaliza sin extraer ni guardar datos y registra `charge_limit_reached` con `results: 0` en `RUN_SUMMARY`. El uso de la plataforma Apify queda a cargo del usuario.

### API, agentes y exportaciones

Podés ejecutar el Actor desde Apify Console, programaciones, REST API, clientes de JavaScript o Python, MCP y flujos con agentes. El Dataset se puede descargar como JSON, CSV o Excel, o consumir directamente desde la API para automatizar monitoreo de precios, análisis de cuotas y alertas de stock.

### Preguntas frecuentes

#### ¿Necesita usuario o contraseña de Frávega Argentina?

No. El Actor consulta el contrato público del catálogo y no accede a cuentas de clientes ni datos privados.

#### ¿Cómo evita resultados duplicados?

Usa paginación determinística y deduplica cada combinación de SKU y vendedor antes de guardarla y facturarla.

#### ¿Qué pasa si una búsqueda no encuentra productos?

No agrega una fila artificial al Dataset. Deja el Dataset sin resultados y registra el estado `no_results` en `RUN_SUMMARY` y en los logs, salvo que actives `failOnNoResults`, que hace fallar la ejecución.

#### ¿Cómo se representan los vendedores del marketplace?

Cada combinación de SKU y vendedor se guarda como una fila independiente. Así podés comparar precio, stock, promociones y cuotas sin mezclar ofertas comerciales diferentes.

#### ¿Las cuotas y el precio son definitivos?

No necesariamente. La financiación, el precio, la entrega y la disponibilidad pueden variar por vendedor, ubicación, medio de pago y condiciones comerciales.

### Fuente, límites y uso responsable

La fuente es el catálogo público de Frávega Argentina expuesto mediante VTEX. Los precios, promociones, cuotas, vendedores y cantidades pueden cambiar sin aviso y dependen del contexto comercial informado por la fuente. El contrato público también puede modificarse.

El Actor aplica una espera configurable entre solicitudes y distingue un bloqueo real de una búsqueda sin resultados. Usalo con límites razonables y de acuerdo con los términos aplicables de la fuente y la legislación vigente.

### Independencia

Esta es una herramienta de datos independiente. No está afiliada, respaldada ni operada por Frávega Argentina. Todas las marcas comerciales pertenecen a sus respectivos titulares.

# Actor input Schema

## `searchTerms` (type: `array`):

Uno o más productos, marcas o palabras clave para buscar.

## `categories` (type: `array`):

IDs de categoría de VTEX, rutas de categoría o URLs completas, opcionales.

## `maxItems` (type: `integer`):

Cantidad máxima opcional de combinaciones de SKU y vendedor de Frávega que se guardarán entre todos los objetivos.

## `maxPages` (type: `integer`):

Límite opcional de páginas para cada búsqueda o categoría. Si se omite, la paginación continúa hasta agotar los resultados.

## `startPage` (type: `integer`):

Primera página de VTEX que se solicitará, numerada desde 1.

## `pageSize` (type: `integer`):

Cantidad de productos solicitados a VTEX por página. VTEX admite hasta 50.

## `sortOrder` (type: `string`):

Un orden determinístico evita productos duplicados entre páginas por desplazamiento de VTEX.

## `withDetails` (type: `boolean`):

Incluye descripción, especificaciones, promociones, vendedor del marketplace y datos de cuotas. El precio por resultado sigue siendo USD 0.003.

## `includeUnavailable` (type: `boolean`):

Incluye SKU y ofertas de vendedores de Frávega sin stock cuando está habilitado.

## `requestDelayMillis` (type: `integer`):

Espera respetuosa, en milisegundos, entre solicitudes de páginas a VTEX.

## `requestTimeoutSecs` (type: `integer`):

Cantidad máxima de segundos que se esperará por cada solicitud al catálogo.

## `retries` (type: `integer`):

Cantidad máxima de intentos ante un error transitorio del catálogo.

## `failOnNoResults` (type: `boolean`):

Hace fallar la ejecución cuando no hay coincidencias. En caso contrario, el Dataset queda vacío y el estado `no_results` se guarda en `RUN_SUMMARY`.

## Actor input object example

```json
{
  "searchTerms": [
    "cable"
  ],
  "maxItems": 100,
  "startPage": 1,
  "pageSize": 50,
  "sortOrder": "OrderByNameASC",
  "withDetails": true,
  "includeUnavailable": false,
  "requestDelayMillis": 100,
  "requestTimeoutSecs": 45,
  "retries": 3,
  "failOnNoResults": false
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "maxItems": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("latinamericadata/fravega-argentina").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "maxItems": 100 }

# Run the Actor and wait for it to finish
run = client.actor("latinamericadata/fravega-argentina").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "maxItems": 100
}' |
apify call latinamericadata/fravega-argentina --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=latinamericadata/fravega-argentina",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/qCdMWGerzvd6PCXi6/builds/C5k60pfaflS8tB7p9/openapi.json