# Naldo Argentina Scraper - Precios, Cuotas y Stock (`latinamericadata/naldo-argentina`) Actor

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

- **URL**: https://apify.com/latinamericadata/naldo-argentina.md
- **Developed by:** [Latin America Data](https://apify.com/latinamericadata) (community)
- **Categories:** E-commerce, Automation, Jobs
- **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

## Naldo Argentina Scraper - Precios, Cuotas y Stock

Extraé electrodomésticos, tecnología y productos para el hogar de Naldo Argentina y obtené precios, cuotas, stock, SKU, EAN, marcas, vendedores e imágenes. 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 Naldo Argentina API o un scraper Naldo, este Actor permite consultar televisores, celulares, informática, climatización, cocina, línea blanca, herramientas y artículos para el hogar. Sirve tanto para búsquedas puntuales como para monitorear precios, financiación y disponibilidad del catálogo argentino.

### Para qué sirve este Actor

Este Actor automatiza la consulta del catálogo público de Naldo Argentina. Podés buscar productos o marcas por palabra clave con `searchTerms`, recorrer rutas de categoría con `categories`, controlar el volumen y solicitar detalles comerciales y técnicos.

Naldo puede publicar más de un vendedor para un mismo SKU. El Actor elige la oferta disponible de menor precio y conserva su `seller_id` y nombre para mantener el resultado auditable. La paginación usa un orden determinístico y deduplicación, y cada fila incluye `source_url`, `request_url` y `scraped_at`.

### 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 y línea blanca.
- Analizar la mejor oferta disponible cuando un SKU tiene varios vendedores.
- Detectar cambios de precio o disponibilidad mediante ejecuciones programadas.
- Alimentar catálogos, tableros, alertas, agentes de IA e inteligencia competitiva.
- Integrar datos de Naldo Argentina mediante 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 y vendedor elegido.
- Cantidad de cuotas y valor de cuota cuando la fuente los informa.
- Promociones, descripción, imagen y URL pública del producto.
- URL exacta de la consulta y fecha de extracción.
- El Dataset contiene solo filas `success`; `no_results`, `blocked` y `failed` quedan en `RUN_SUMMARY` y logs.

### Ejemplo de entrada

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

### Resultado de ejemplo

```json
{
  "status": "success",
  "country": "AR",
  "source": "Naldo Argentina",
  "input_type": "search",
  "input_value": "smart",
  "page": 1,
  "product_id": "43712",
  "sku_id": "44001",
  "ean": "7790000000000",
  "product_name": "Smart TV LED 32 pulgadas",
  "brand": "Marca de ejemplo",
  "category": "TV, Audio y Video/Televisores",
  "price": 299999,
  "list_price": 349999,
  "currency": "ARS",
  "available": true,
  "installment_count": 12,
  "seller": "Naldo",
  "source_url": "https://www.naldo.com.ar/smart-tv-led-32/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 rutas y URLs 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` | Rutas o URLs completas de categorías públicas de Naldo. |
| `maxItems` | Máximo opcional de SKU con su mejor oferta disponible. |
| `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 sin stock cuando no existe una oferta disponible. |
| `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. Para recorrer Televisores, por ejemplo, podés ingresar `/tv-audio-y-video/televisores` o su URL completa.

### Precios

El Actor usa **Pay per event + usage** con una tarifa plana. Apify muestra el máximo de cargo antes de ejecutar y el Actor reduce `maxItems` para respetarlo.

| Concepto | Cuándo se cobra | Precio |
|---|---|---:|
| `result` | Por cada producto/SKU guardado en el Dataset predeterminado mediante `apify-default-dataset-item`. Es el evento principal. | USD 0.003 por resultado (USD 3.00 cada 1.000) |
| Actor start | Al iniciar la ejecución; Apify lo gestiona con `apify-actor-start` y bonifica los primeros 5 segundos de uso. | USD 0.00005 |

`withDetails` agrega campos, pero no cambia el precio por resultado. Las ejecuciones sin productos dejan el Dataset vacío: `no_results`, `blocked` y `failed` se registran únicamente en `RUN_SUMMARY` y logs, por lo que no generan un evento `result`. El cargo de inicio y el uso de plataforma de Apify quedan 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.

Ejemplo con cURL:

```bash
curl "https://api.apify.com/v2/acts/USUARIO~naldo-argentina/runs?token=APIFY_TOKEN" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"searchTerms":["notebook"],"maxItems":25,"withDetails":true}'
```

### Preguntas frecuentes

#### ¿Necesita usuario o contraseña de Naldo 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 SKU antes de guardarlo y facturarlo.

#### ¿Cómo se elige el vendedor?

Para cada SKU, el Actor selecciona la oferta disponible de menor precio. El Dataset conserva el ID y nombre del vendedor elegido, por lo que siempre podés revisar el origen comercial de la oferta.

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

El Dataset queda vacío y `RUN_SUMMARY` registra `no_results`. No se cobra un evento `result`, salvo que actives `failOnNoResults`, caso en el que la ejecución falla.

### Fuente, límites y uso responsable

El Actor consulta endpoints públicos del catálogo VTEX de Naldo Argentina. La disponibilidad, el precio, las cuotas, los vendedores y las promociones pueden variar por fecha, ubicación, medio de pago o cambios del comercio. Verificá el producto en `source_url` antes de tomar decisiones comerciales.

Usá límites razonables, una espera respetuosa y ejecuciones programadas acordes con tu necesidad. El Actor no elude autenticación, no realiza compras y no extrae datos personales.

### Independencia

Este Actor es una herramienta independiente. No está afiliado, patrocinado ni respaldado por Naldo Argentina ni por VTEX. Naldo y sus marcas relacionadas 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`):

Rutas de categoría o URLs completas del catálogo público de Naldo, opcionales.

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

Cantidad máxima opcional de SKU con su mejor oferta disponible de Naldo 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 de Naldo sin stock cuando no existe una oferta disponible.

## `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": [
    "smart"
  ],
  "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/naldo-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/naldo-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/naldo-argentina --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

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