~/ecommerce/macys-scraper

Scraper de Macy's — Productos, precios, SKUs y noticias

Extrae datos de producto de Macy's — precios, variantes, códigos de barras SKU/UPC, imágenes, valoraciones y reseñas — además de noticias de Macy's Inc., desde URLs de búsqueda, categoría, tendencias y producto. Sin navegador, a prueba de Akamai.

grandes almacenes TypeScriptCrawleeCheerio Estados Unidos

ejecutar en Apify

proooxy/macys-scraper — spec

categoríaecommerce / grandes almacenes

lenguajeTypeScript

stackTypeScript, Crawlee, Cheerio

mercadosEstados Unidos

salidaJSON limpio y listo para RAG

características clave

Cuatro superficies en un solo actor — búsqueda de producto, categoría, tendencias y noticias de Macy's Inc.

Vence a Akamai Bot Manager sin necesidad de navegador, usando las propias APIs JSON móvil y web de Macy's

Códigos de barras UPC por SKU con color, talla, disponibilidad y precio para cada variante comprable

Precios como enteros en céntimos más cadenas con formato localizado — sin redondeo de coma flotante

Inteligencia de reseñas completa — histograma de estrellas, recuentos de recomendación y valoraciones secundarias de ajuste/talla

Todos los tonos y tallas agrupados bajo un único registro de producto, no una fila por variante

Solo URLs canónicas limpias — los endpoints internos de la API y las claves de cliente nunca se filtran en la salida

Un único esquema normalizado en los resultados de búsqueda, categoría, tendencias y detalle de producto

casos de uso

Seguimiento de precios y promociones de grandes almacenes a nivel de SKU
Análisis competitivo — precios de Macy's frente a Nordstrom, Ulta o DTC de marca
Emparejamiento de catálogo entre retailers mediante códigos de barras UPC por variante
Inteligencia de reseñas y valoraciones para marcas vendidas en Macy's
Monitorización de noticias retail — comunicados de prensa y resultados financieros de Macy's Inc.

parámetros de entrada

Parámetro	Tipo	Obligatorio	Descripción
`scrapeType`	string	obligatorio	Superficie a extraer: search, category, trending, news o all (por defecto: search).
`query`	string	opcional	Palabra clave para la búsqueda de producto, por ejemplo women shoes.
`startUrls`	array	opcional	URLs de producto/categoría de Macy's o URLs de noticias de Macy's Inc.
`categoryIds`	array	opcional	IDs de categoría de Macy's (por ejemplo 5449). Se prefieren las URLs de categoría cuando se conocen.
`trendingUrls`	array	opcional	URLs de listados de tendencias, más vendidos o curados.
`newsUrls`	array	opcional	URLs de listado de noticias o artículos de Macy's Inc.
`includeProductDetails`	boolean	opcional	Enriquece los elementos del listado con el detalle completo de producto — variantes, SKUs, galerías (por defecto: true).
`maxPages`	number	opcional	Profundidad máxima de paginación por fuente de listado/noticias.
`maxResults`	number	opcional	Límite de registros de salida. 0 = sin límite.
`proxy`	object	obligatorio	Apify Proxy o URLs de proxy personalizadas. Se recomienda residencial, país US.

Ejemplo de salida

 1{
 2  "type": "product",
 3  "source": {
 4    "id": "12345678",
 5    "canonicalUrl": "https://www.macys.com/shop/product/calvin-klein-womens-sheath-dress?ID=12345678",
 6    "retailer": "macys",
 7    "currency": "USD"
 8  },
 9  "title": "Women's Sleeveless Sheath Dress",
10  "brand": "Calvin Klein",
11  "categories": ["Women", "Dresses", "Work Dresses"],
12  "price": {
13    "sale": 5999,
14    "list": 9800,
15    "currentFormatted": "$59.99",
16    "stockStatus": "InStock"
17  },
18  "stats": { "rating": 4.6, "reviewCount": 9, "ratingPercentage": 92 },
19  "options": [
20    { "type": "Color", "values": [{ "id": "1", "name": "Black" }] },
21    { "type": "Size", "values": [{ "id": "10", "name": "M" }, { "id": "12", "name": "L" }] }
22  ],
23  "variants": [
24    {
25      "id": "987654",
26      "sku": "192837465012",
27      "options": ["Black", "M"],
28      "price": { "stockStatus": "InStock" },
29      "extraInfo": { "upc": "192837465012" }
30    }
31  ],
32  "medias": [{ "type": "Image", "url": "https://slimages.macysassets.com/is/image/MCY/products/.../main.jpg" }]
33}

Precios

Pago por evento — solo se te factura por los elementos realmente guardados:

Evento	Precio	Qué incluye
Producto extraído	$0.006	Un producto con detalle completo — variantes, SKUs/UPCs, precios, imágenes, valoraciones
Artículo extraído	$0.002	Un artículo de noticias de Macy’s Inc. — título, autor, fecha, cuerpo, imágenes

Los descuentos por volumen se aplican automáticamente en los planes superiores de Apify (hasta $0.0045 por producto). Un rastreo de 1,000 productos cuesta ~$6.00 a precio de lista.

Consejos

Usa proxies residenciales de EE. UU. El endpoint de detalle de producto tiene limitación de tasa intermitente; la rotación de sesión residencial pasa sin problemas, mientras que las IPs de centro de datos ven más 403.
Mantén una concurrencia moderada. Un maxConcurrency de 2–3 es el punto óptimo — valores más altos aumentan los bloqueos por límite de tasa sin mejorar el rendimiento.
Prefiere URLs de categoría antes que IDs sueltos. La URL lleva la ruta de categoría que la API espera; un ID suelto puede resolver a un conjunto de resultados más amplio o vacío.
Desactiva includeProductDetails para un barrido rápido a nivel de listado (nombre, marca, precio de listado, imagen, valoración) cuando no necesites variantes ni descripciones.

faq

¿Cómo evade Akamai sin usar un navegador?

No se enfrenta en absoluto al desafío de JS. Los listados provienen de la API de la app móvil de Macy's y el detalle de producto de la API JSON del sitio web — ambas corren sobre una infraestructura separada que responde a solicitudes de lectura anónimas. Sin login, sin cookies, sin clave API.

¿Los precios están en dólares o en céntimos?

Enteros en céntimos (5999 = $59.99) para evitar el redondeo de coma flotante, junto con cadenas con formato localizado ($59.99).

¿Cómo se gestionan las variantes y los UPC?

Todos los colores y tallas se agrupan bajo un único registro de producto con un array variants[]. Cada variante lleva su propio código de barras UPC, color, talla, disponibilidad y precio — recuperados de los datos de relación de SKU de Macy's, no extraídos de un widget de muestras de color.

¿Puedo extraer productos y noticias en una sola ejecución?

Sí. Establece scrapeType en all y proporciona cualquier combinación de query, startUrls, categoryIds, trendingUrls y newsUrls.