# Easy (`scraperschile/easy`) Actor Scraper rapido de Easy Chile para extraer productos, precios Normal, Oferta, CencoPay/Cencosud, stock, vendedores, categorias, imagenes y URLs desde easy.cl. Usa el backend JSON VTEX para monitoreo de precios, retail intelligence y analisis ecommerce. - **URL**: https://apify.com/scraperschile/easy.md - **Developed by:** [Scrapers Chile](https://apify.com/scraperschile) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 ## Easy Scraper - Productos, precios y stock de Easy.cl Extrae productos publicos desde [Easy.cl](https://www.easy.cl/) a partir de un termino de busqueda. El Actor recorre la paginacion disponible, deduplica productos y entrega un dataset listo para monitoreo de precios, retail intelligence, analisis de ecommerce y comparacion del mercado chileno. ### Que hace este Actor - Busca productos en Easy Chile por termino, por ejemplo `Martillo`, `taladro`, `pintura blanca`, `ceramica` o `jardin`. - Usa HTTP directo contra el backend JSON VTEX de Easy: `https://easycl.vtexcommercestable.com.br/api/catalog_system/pub/products/search`. - Evita scraping visual pesado. Playwright se uso solo para investigar el flujo real del sitio y confirmar que el sitio visible se alimenta de datos estructurados. - Recorre paginas con `_from` y `_to`, detecta el total reportado por el header `resources` y respeta `maxItems`, `maxPages`, `pageSize` y `concurrency`. - Guarda filas normalizadas en el dataset y un resumen completo en `OUTPUT`. ### Datos que extrae Cada fila representa un producto encontrado en Easy: - Termino buscado y fecha de extraccion. - ID de producto, SKU/itemId, EAN y referencias originales. - Nombre, marca, categoria, IDs de categoria y URL publica. - Vendedor, ID vendedor e indicador marketplace. - Disponibilidad, cantidad disponible e imagen principal. - Rating y conteo de resenas cuando el backend los entregue. - Pagina, posicion global y posicion dentro de la pagina. - `raw_offer` y `raw_product` para trazabilidad completa. ### Columnas de precio El Actor no usa columnas genericas como `price`, `normal_price` o `card_price`. Las columnas se nombran segun los precios reales observados en Easy.cl y en su backend: | Campo | Significado | | --- | --- | | `easy_precio_normal` | Precio Normal de Easy. Corresponde al precio base o al precio tachado cuando existe una oferta. | | `easy_precio_oferta` | Precio Oferta cuando Easy entrega un precio menor al Precio Normal. | | `easy_precio_cencopay` | Precio condicionado a CencoPay cuando el backend lo marca con ajuste `CENCOPAY`. | | `easy_precio_cencosud` | Precio condicionado a Cencosud/CAT cuando el backend lo marca con ajuste `CAT`, `CENCO` o equivalente. | | `precio_principal` | Campo auxiliar para analisis rapido: menor precio disponible entre los precios reportados para el producto. | | `discount_percentage` | Descuento calculado entre `easy_precio_normal` y `precio_principal` cuando ambos existen. | | `promocion`, `badge_precio`, `texto_descuento`, `condicion_precio` | Textos promocionales y condiciones comerciales detectadas desde el backend. | Los bloques originales de precio quedan disponibles dentro de `raw_offer` y `raw_product`. ### Input ```json { "term": "Martillo", "maxItems": 100, "maxPages": 3, "pageSize": 50, "sort": "recommended", "concurrency": 4, "failOnNoResults": false } ```` #### Parametros principales - `term`: termino de busqueda requerido. - `maxItems`: maximo de productos a guardar. Recomendado para pruebas y control de costos. - `pageSize`: productos por solicitud. El backend de Easy permite hasta 50. - `maxPages`: limite opcional de paginas. - `sort`: `recommended`, `price_asc`, `price_desc`, `name_asc`, `newest` o `top_sales`. - `concurrency`: paginas consultadas en paralelo despues de la primera. - `failOnNoResults`: si debe fallar cuando no hay resultados. ### Output de ejemplo ```json { "search_term": "Martillo", "product_id": "96869", "sku": "1346694", "name": "Martillo soldador Hela", "brand": "Hela", "currency": "CLP", "easy_precio_normal": 11990, "easy_precio_oferta": null, "easy_precio_cencopay": null, "easy_precio_cencosud": null, "precio_principal": 11990, "is_available": true, "availability": "available", "category": "Herramientas > Herramientas Manuales > Martillos y Mazas", "seller_name": "Easy.cl", "is_marketplace": false, "url": "https://www.easy.cl/martillo-soldador-hela-1346694/p", "page": 1, "position": 1 } ``` El registro `OUTPUT` incluye: - `status`: `ok`, `no_results`, `blocked` o `error`. - `search_term`, `total_results_reported`, `total_products_scraped` y `pages_scraped`. - Limites aplicados: `maxItems`, `maxPages`, `pageSize` y `concurrency`. - Paginas consultadas, warnings, errores y productos agregados. ### Casos de uso - Monitoreo de precios de Easy Chile. - Comparacion de precios entre Easy, Sodimac, Mercado Libre, Falabella u otros retailers. - Alertas de cambios de precio, descuentos y disponibilidad. - Analisis de categorias de herramientas, construccion, hogar, jardin, muebles y decoracion. - Retail intelligence, ecommerce analytics, catalogos, BI y estudios de mercado chileno. - Seguimiento de precios CencoPay, Cencosud/CAT, Precio Oferta y Precio Normal. ### Buenas practicas - Para pruebas rapidas usa `maxItems` entre 20 y 100. - Para ejecuciones completas deja `maxPages` vacio y usa `pageSize: 50`. - Si el sitio responde lento, baja `concurrency` a 1 o 2. - Guarda `raw_product` si necesitas auditar cambios de contrato, sellers o precios. ### Limitaciones conocidas - Easy puede cambiar su contrato VTEX, nombres de promociones o reglas comerciales. Si eso ocurre, el Actor devuelve errores claros y conserva el contexto en `OUTPUT`. - Los precios CencoPay/Cencosud dependen de ajustes promocionales entregados por el backend. Si el backend no entrega esos ajustes, los campos quedan en `null`. - Algunos campos como rating o resenas solo se completan si Easy los incluye en la respuesta. - La disponibilidad corresponde a la disponibilidad publica reportada por el backend al momento de la extraccion. ### Keywords Easy scraper, Easy Chile scraper, Easy.cl API, Easy productos, Easy precios, Easy stock, Easy Chile precios, scraper retail Chile, ecommerce Chile, monitoreo de precios, price monitoring Chile, retail intelligence Chile, Apify Easy, herramientas Easy, construccion Easy, CencoPay, Cencosud, Precio Oferta, Precio Normal. # Actor input Schema ## `term` (type: `string`): Producto, marca o texto a buscar en Easy.cl. Ejemplos reales: Martillo, taladro, pintura blanca, ceramica, jardin. ## `maxItems` (type: `integer`): Limite opcional de productos a guardar. Util para pruebas rapidas, presupuestos controlados, smoke tests o monitoreos acotados. ## `pageSize` (type: `integer`): Tamano de pagina solicitado al backend VTEX de Easy. El contrato actual permite hasta 50 productos por solicitud. ## `maxPages` (type: `integer`): Limite opcional de paginas a recorrer. Si se omite, el Actor recorre toda la paginacion disponible o hasta alcanzar maxItems. ## `sort` (type: `string`): Ordenamiento compatible con el backend publico de Easy. ## `concurrency` (type: `integer`): Cantidad de paginas JSON procesadas en paralelo. Baja este valor si Easy responde lento o limita solicitudes. ## `retries` (type: `integer`): Cantidad de reintentos por pagina si Easy demora, corta o rechaza una solicitud temporalmente. ## `timeoutSecs` (type: `integer`): Tiempo maximo en segundos para consultar el endpoint JSON de Easy. ## `failOnNoResults` (type: `boolean`): Si esta activo, la ejecucion falla cuando Easy no devuelve productos. Si esta apagado, guarda OUTPUT con estado no\_results y dataset vacio. ## Actor input object example ```json { "term": "Martillo", "maxItems": 100, "pageSize": 50, "sort": "recommended", "concurrency": 4, "retries": 3, "timeoutSecs": 30, "failOnNoResults": false } ``` # Actor output Schema ## `results` (type: `string`): Items del dataset con nombre, marca, precios Easy, descuento, disponibilidad, categoria, vendedor, URL e imagen. ## `summary` (type: `string`): Registro OUTPUT con estado, paginas recorridas, limites aplicados, warnings, errores y productos crudos agregados. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "term": "Martillo", "maxItems": 100, "pageSize": 50, "concurrency": 4 }; // Run the Actor and wait for it to finish const run = await client.actor("scraperschile/easy").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "term": "Martillo", "maxItems": 100, "pageSize": 50, "concurrency": 4, } # Run the Actor and wait for it to finish run = client.actor("scraperschile/easy").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 '{ "term": "Martillo", "maxItems": 100, "pageSize": 50, "concurrency": 4 }' | apify call scraperschile/easy --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scraperschile/easy", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Easy", "description": "Scraper rapido de Easy Chile para extraer productos, precios Normal, Oferta, CencoPay/Cencosud, stock, vendedores, categorias, imagenes y URLs desde easy.cl. Usa el backend JSON VTEX para monitoreo de precios, retail intelligence y analisis ecommerce.", "version": "0.1", "x-build-id": "XgA8q4Drf8pMf315B" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scraperschile~easy/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scraperschile-easy", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/scraperschile~easy/runs": { "post": { "operationId": "runs-sync-scraperschile-easy", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/scraperschile~easy/run-sync": { "post": { "operationId": "run-sync-scraperschile-easy", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "term" ], "properties": { "term": { "title": "Termino de busqueda", "type": "string", "description": "Producto, marca o texto a buscar en Easy.cl. Ejemplos reales: Martillo, taladro, pintura blanca, ceramica, jardin." }, "maxItems": { "title": "Maximo de productos", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Limite opcional de productos a guardar. Util para pruebas rapidas, presupuestos controlados, smoke tests o monitoreos acotados.", "default": 100 }, "pageSize": { "title": "Productos por pagina", "minimum": 1, "maximum": 50, "type": "integer", "description": "Tamano de pagina solicitado al backend VTEX de Easy. El contrato actual permite hasta 50 productos por solicitud.", "default": 50 }, "maxPages": { "title": "Maximo de paginas", "minimum": 1, "maximum": 500, "type": "integer", "description": "Limite opcional de paginas a recorrer. Si se omite, el Actor recorre toda la paginacion disponible o hasta alcanzar maxItems." }, "sort": { "title": "Ordenamiento", "enum": [ "recommended", "price_asc", "price_desc", "name_asc", "newest", "top_sales" ], "type": "string", "description": "Ordenamiento compatible con el backend publico de Easy.", "default": "recommended" }, "concurrency": { "title": "Concurrencia", "minimum": 1, "maximum": 10, "type": "integer", "description": "Cantidad de paginas JSON procesadas en paralelo. Baja este valor si Easy responde lento o limita solicitudes.", "default": 4 }, "retries": { "title": "Reintentos", "minimum": 1, "maximum": 8, "type": "integer", "description": "Cantidad de reintentos por pagina si Easy demora, corta o rechaza una solicitud temporalmente.", "default": 3 }, "timeoutSecs": { "title": "Timeout por solicitud", "minimum": 5, "maximum": 120, "type": "integer", "description": "Tiempo maximo en segundos para consultar el endpoint JSON de Easy.", "default": 30 }, "failOnNoResults": { "title": "Fallar si no hay resultados", "type": "boolean", "description": "Si esta activo, la ejecucion falla cuando Easy no devuelve productos. Si esta apagado, guarda OUTPUT con estado no_results y dataset vacio.", "default": false } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```