~/ecommerce/macys-scraper

Macy's Scraper — प्रोडक्ट, प्राइस, SKU और न्यूज़

search, category, trending, और product URL से Macy's प्रोडक्ट डेटा — प्राइस, वेरिएंट, SKU/UPC बारकोड, इमेज, रेटिंग व रिव्यू — साथ ही Macy's Inc. न्यूज़ एक्सट्रैक्ट करें। कोई ब्राउज़र नहीं, Akamai-प्रूफ़।

डिपार्टमेंट स्टोर TypeScriptCrawleeCheerio अमेरिका

Apify पर रन करें

proooxy/macys-scraper — स्पेक

कैटेगरीecommerce / डिपार्टमेंट स्टोर

भाषाTypeScript

स्टैकTypeScript, Crawlee, Cheerio

मार्केट्सअमेरिका

आउटपुटसाफ, RAG-तैयार JSON

मुख्य विशेषताएं

एक ही एक्टर में चार surface — product search, category, trending, और Macy's Inc. न्यूज़

Macy's के अपने मोबाइल व वेबसाइट JSON API इस्तेमाल करके बिना ब्राउज़र के Akamai Bot Manager को मात देता है

हर खरीदने लायक वेरिएंट के लिए color, size, availability, और price के साथ per-SKU UPC बारकोड

इंटीजर cents के रूप में प्राइस, साथ में localized फ़ॉर्मेटेड स्ट्रिंग — कोई floating-point राउंडिंग नहीं

पूरी review इंटेलिजेंस — star हिस्टोग्राम, recommend counts, और सेकेंडरी fit/size रेटिंग

सभी shades और sizes एक ही प्रोडक्ट रिकॉर्ड के अंदर ग्रुप्ड, हर वेरिएंट के लिए अलग row नहीं

सिर्फ़ साफ़ canonical URL — internal API endpoints और client keys कभी आउटपुट में लीक नहीं होते

search, category, trending, और product-detail रिज़ल्ट में एक ही normalized schema

यूज़ केस

SKU लेवल पर डिपार्टमेंट-स्टोर प्राइस और प्रमोशन मॉनिटरिंग
प्रतिस्पर्धी विश्लेषण — Macy's बनाम Nordstrom, Ulta, या ब्रांड DTC प्राइसिंग
per-variant UPC बारकोड के ज़रिए रिटेलर्स के बीच कैटलॉग मैचिंग
Macy's पर बिकने वाले ब्रांड्स के लिए review और rating इंटेलिजेंस
रिटेल न्यूज़ मॉनिटरिंग — Macy's Inc. प्रेस रिलीज़ और अर्निंग्स अनाउंसमेंट

इनपुट पैरामीटर

पैरामीटर	टाइप	आवश्यक	विवरण
`scrapeType`	string	आवश्यक	स्क्रैप करने के लिए surface: search, category, trending, news, या all (डिफ़ॉल्ट: search)।
`query`	string	वैकल्पिक	प्रोडक्ट सर्च के लिए keyword, जैसे women shoes।
`startUrls`	array	वैकल्पिक	Macy's प्रोडक्ट/कैटेगरी URL या Macy's Inc. न्यूज़ URL।
`categoryIds`	array	वैकल्पिक	Macy's category ID (जैसे 5449)। मालूम होने पर category URL को प्राथमिकता दें।
`trendingUrls`	array	वैकल्पिक	Trending, bestseller, या curated listing URL।
`newsUrls`	array	वैकल्पिक	Macy's Inc. न्यूज़ लिस्टिंग या आर्टिकल URL।
`includeProductDetails`	boolean	वैकल्पिक	listing आइटम को पूरी प्रोडक्ट डिटेल से समृद्ध करें — variants, SKUs, galleries (डिफ़ॉल्ट: true)।
`maxPages`	number	वैकल्पिक	प्रति listing/news सोर्स अधिकतम पेजिनेशन डेप्थ।
`maxResults`	number	वैकल्पिक	आउटपुट रिकॉर्ड पर कैप। 0 = कोई कैप नहीं।
`proxy`	object	आवश्यक	Apify Proxy या कस्टम प्रॉक्सी URL। रेजिडेंशियल, country US की सलाह दी जाती है।

आउटपुट का उदाहरण

 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}

प्राइसिंग

Pay-per-event — आपसे सिर्फ़ असल में सेव किए गए आइटम के लिए बिल लिया जाता है:

इवेंट	प्राइस	इसमें क्या शामिल है
स्क्रैप किया गया प्रोडक्ट	$0.006	पूरी डिटेल वाला एक प्रोडक्ट — variants, SKUs/UPCs, prices, images, ratings
स्क्रैप किया गया आर्टिकल	$0.002	Macy’s Inc. का एक न्यूज़ आर्टिकल — title, author, date, body, images

हायर Apify प्लान पर वॉल्यूम डिस्काउंट ऑटोमैटिकली लागू होते हैं (प्रति प्रोडक्ट $0.0045 तक)। लिस्ट प्राइस पर 1,000-प्रोडक्ट क्रॉल की कीमत ~$6.00 है।

टिप्स

रेजिडेंशियल US प्रॉक्सी इस्तेमाल करें। product-detail endpoint कभी-कभी rate-limited होता है; रेजिडेंशियल सेशन रोटेशन साफ़-साफ़ निकल जाता है, जबकि डेटासेंटर IP पर ज़्यादा 403s मिलते हैं।
कॉन्करेंसी मध्यम रखें। maxConcurrency का 2–3 स्वीट स्पॉट है — ज़्यादा वैल्यू थ्रूपुट सुधारे बिना rate-limit hits बढ़ा देती हैं।
bare ID से ज़्यादा category URL को प्राथमिकता दें। URL वह category path कैरी करता है जो API को चाहिए; एक bare ID एक ज़्यादा व्यापक या खाली result set पर रिज़ॉल्व हो सकता है।
जब आपको variants या descriptions नहीं चाहिए, तो तेज़ listing-level sweep (name, brand, listing price, image, rating) के लिए includeProductDetails बंद करें।

सामान्य प्रश्न

यह बिना ब्राउज़र के Akamai को कैसे पार करता है?

यह JS challenge से लड़ता ही नहीं। Listings Macy's के mobile app API से आती हैं और product details वेबसाइट के JSON API से — दोनों अलग इंफ्रास्ट्रक्चर पर चलते हैं जो anonymous read रिक्वेस्ट का जवाब देता है। कोई login नहीं, कोई cookies नहीं, कोई API key नहीं।

प्राइस डॉलर में हैं या cents में?

floating-point राउंडिंग से बचने के लिए इंटीजर cents (5999 = $59.99), साथ में localized फ़ॉर्मेटेड स्ट्रिंग ($59.99) भी।

वेरिएंट और UPC कैसे हैंडल होते हैं?

सभी colors और sizes को एक variants[] array के साथ एक ही प्रोडक्ट रिकॉर्ड में ग्रुप किया जाता है। हर वेरिएंट का अपना UPC बारकोड, color, size, availability, और price होता है — जो Macy's के SKU relationship डेटा से मिलता है, किसी swatch widget से स्क्रैप करके नहीं।

क्या मैं एक ही रन में प्रोडक्ट और न्यूज़ स्क्रैप कर सकता हूं?

हां। scrapeType को all पर सेट करें और query, startUrls, categoryIds, trendingUrls, और newsUrls का कोई भी मिक्स दें।