~/ecommerce/macys-scraper

Macy's Scraper — Produtos, Preços, SKUs e Notícias

Extraia dados de produtos da Macy's — preços, variantes, códigos de barras SKU/UPC, imagens, avaliações e reviews — além de notícias da Macy's Inc., a partir de URLs de busca, categoria, trending e produto. Sem navegador, à prova de Akamai.

loja de departamento TypeScriptCrawleeCheerio Estados Unidos

executar no Apify

proooxy/macys-scraper — especificações

categoriaecommerce / loja de departamento

linguagemTypeScript

stackTypeScript, Crawlee, Cheerio

mercadosEstados Unidos

saídaJSON limpo e pronto para RAG

principais recursos

Quatro superfícies em um único ator — busca de produtos, categoria, trending e notícias da Macy's Inc.

Supera o Akamai Bot Manager sem usar navegador, aproveitando as próprias APIs JSON do app mobile e do site da Macy's

Códigos de barras UPC por SKU, com cor, tamanho, disponibilidade e preço para cada variante disponível para compra

Preços como inteiros em centavos, além de strings formatadas localizadas — sem arredondamento de ponto flutuante

Inteligência completa de reviews — histograma de estrelas, contagens de recomendação e avaliações secundárias de caimento/tamanho

Todas as tonalidades e tamanhos agrupados em um único registro de produto, não uma linha por variante

Somente URLs canônicas limpas — endpoints internos de API e chaves de cliente nunca vazam para a saída

Um único esquema normalizado para resultados de busca, categoria, trending e detalhe de produto

casos de uso

Monitoramento de preços e promoções de lojas de departamento em nível de SKU
Análise competitiva — Macy's vs. Nordstrom, Ulta ou precificação DTC de marcas
Correspondência de catálogo entre varejistas via códigos de barras UPC por variante
Inteligência de reviews e avaliações para marcas vendidas na Macy's
Monitoramento de notícias de varejo — press releases e anúncios de resultados da Macy's Inc.

parâmetros de entrada

Parâmetro	Tipo	Obrigatório	Descrição
`scrapeType`	string	obrigatório	Superfície a raspar: search, category, trending, news ou all (padrão: search).
`query`	string	opcional	Palavra-chave para busca de produtos, ex.: women shoes.
`startUrls`	array	opcional	URLs de produto/categoria da Macy's ou URLs de notícias da Macy's Inc.
`categoryIds`	array	opcional	IDs de categoria da Macy's (ex.: 5449). URLs de categoria são preferíveis quando conhecidas.
`trendingUrls`	array	opcional	URLs de listagens trending, mais vendidos ou curadas.
`newsUrls`	array	opcional	URLs de listagem de notícias ou artigos da Macy's Inc.
`includeProductDetails`	boolean	opcional	Enriquece os itens da listagem com detalhes completos do produto — variantes, SKUs, galerias (padrão: true).
`maxPages`	number	opcional	Profundidade máxima de paginação por fonte de listagem/notícia.
`maxResults`	number	opcional	Limite de registros de saída. 0 = sem limite.
`proxy`	object	obrigatório	Apify Proxy ou URLs de proxy personalizadas. Residencial, país US recomendado.

Exemplo de Saída

 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}

Preços

Pagamento por evento — você paga apenas pelos itens realmente salvos:

Evento	Preço	O que cobre
Produto raspado	$0.006	Um produto com detalhe completo — variantes, SKUs/UPCs, preços, imagens, avaliações
Artigo raspado	$0.002	Um artigo de notícia da Macy’s Inc. — título, autor, data, corpo, imagens

Descontos por volume se aplicam automaticamente em planos Apify superiores (até $0.0045 por produto). Um rastreamento de 1,000 produtos é ~$6.00 no preço de tabela.

Dicas

Use proxies residenciais dos EUA. O endpoint de detalhe de produto tem rate limit intermitente; a rotação de sessão residencial passa limpo, enquanto IPs de datacenter recebem mais 403s.
Mantenha a concorrência moderada. maxConcurrency de 2–3 é o ponto ideal — valores mais altos aumentam os bloqueios de rate limit sem melhorar o throughput.
Prefira URLs de categoria em vez de IDs isolados. A URL carrega o caminho de categoria que a API espera; um ID isolado pode resolver para um conjunto de resultados mais amplo ou vazio.
Desative includeProductDetails para uma varredura rápida em nível de listagem (nome, marca, preço de listagem, imagem, avaliação) quando você não precisar de variantes ou descrições.

faq

Como ele supera o Akamai sem usar navegador?

Ele simplesmente não enfrenta o desafio de JS. As listagens vêm da API do aplicativo mobile da Macy's, e os detalhes de produto vêm da API JSON do site — ambas rodam em infraestrutura separada que responde a requisições de leitura anônimas. Sem login, sem cookies, sem chave de API.

Os preços estão em dólares ou centavos?

Inteiros em centavos (5999 = $59.99) para evitar arredondamento de ponto flutuante, acompanhados de strings formatadas localizadas ($59.99).

Como variantes e UPCs são tratados?

Todas as cores e tamanhos são agrupados em um único registro de produto, com um array variants[]. Cada variante carrega seu próprio código de barras UPC, cor, tamanho, disponibilidade e preço — recuperados dos dados de relacionamento de SKU da Macy's, não extraídos de um widget de amostras visual.

Posso raspar produtos e notícias em uma única execução?

Sim. Defina scrapeType como all e forneça qualquer combinação de query, startUrls, categoryIds, trendingUrls e newsUrls.