~/ecommerce/woocommerce-scraper

Scraper WooCommerce — Produk, Harga, Stok & Ulasan

Scrape produk, variasi, kategori, dan ulasan pelanggan dari toko WooCommerce mana pun. Cukup berikan domain dan Actor menemukan katalognya — bahkan saat JSON API toko dimatikan.

umum TypeScriptCheerio Global

run di Apify

proooxy/woocommerce-scraper — spec

kategoriecommerce / umum

bahasaTypeScript

stackTypeScript, Cheerio

pasarGlobal

outputJSON bersih, siap-RAG

fitur utama

Cukup domain saja — Actor menemukan katalognya sendiri

Tetap berjalan di toko yang JSON API-nya dimatikan atau diblokir firewall

Setiap variasi produk variabel, lengkap dengan SKU, harga, dan status stok masing-masing

Ulasan pelanggan sebagai record terpisah berisi rating, penulis, dan tanggal

Harga dalam satuan mata uang terkecil berikut format asli toko, sehingga perhitungan tidak salah membulatkan

Batas per toko, agar satu katalog besar tidak menggusur yang lain pada run multi-toko

Pencarian kata kunci di setiap toko dalam run, bukan sekadar penjelajahan katalog penuh

Konkurensi konservatif secara bawaan — sebagian besar toko WooCommerce adalah WordPress kecil yang di-hosting sendiri

use case

Pemantauan harga dan ragam produk pada peritel WooCommerce independen
Membangun katalog dari ekor panjang toko kecil yang tak tercakup marketplace mana pun
Riset kompetitif ketika pesaing memakai WordPress alih-alih Shopify
Penambangan ulasan untuk persepsi produk dan sebaran rating
Memasok data produk ke situs perbandingan, marketplace, dan agen belanja
Pelacakan stok dan ketersediaan untuk pemeriksaan distribusi dan reseller

parameter input

Parameter	Tipe	Wajib	Deskripsi
`domains`	array	opsional	Domain polos, satu per baris — cara paling sederhana menunjuk sebuah toko
`startUrls`	array	opsional	URL WooCommerce apa pun: akar toko, halaman kategori, halaman tag, atau satu produk
`maxProducts`	integer	opsional	Berapa banyak record produk yang disimpan selama seluruh run
`maxProductsPerStore`	integer	opsional	Batas untuk tiap toko, agar satu katalog besar tidak menghabiskan seluruh anggaran
`includeVariations`	boolean	opsional	Ambil semua variasi produk variabel, lengkap dengan SKU, harga, dan stok
`includeReviews`	boolean	opsional	Simpan ulasan pelanggan sebagai record terpisah dengan rating, penulis, dan tanggal
`query`	string	opsional	Kata kunci pencarian yang diterapkan ke setiap akar toko atau domain dalam run
`allowHtmlFallback`	boolean	opsional	Izinkan peralihan HTML untuk toko yang JSON API-nya dimatikan atau diblokir
`proxy`	object	opsional	Konfigurasi proxy; scraper hanya meningkatkannya bila sebuah toko memerlukannya

Contoh Keluaran

 1{
 2  "source": {
 3    "id": "1251",
 4    "canonicalUrl": "https://www.shoprootscience.com/shop/sample-kit",
 5    "retailer": "shoprootscience.com",
 6    "language": "en",
 7    "currency": "USD"
 8  },
 9  "title": "Sample Kit",
10  "brand": "",
11  "categories": ["Samples"],
12  "price": {
13    "current": 2000,
14    "currentFormatted": "$20.00",
15    "previous": 2000,
16    "stockStatus": "InStock",
17    "stockCount": 0
18  },
19  "stats": { "rating": 4.75, "reviewCount": 4 },
20  "options": [
21    { "type": "Sample 1", "values": [
22      { "id": "Bare Facial Serum", "name": "Bare Facial Serum" },
23      { "id": "Youth Facial Serum", "name": "Youth Facial Serum" }
24    ] }
25  ],
26  "variants": [
27    { "sku": "SK-BARE", "price": { "current": 2000, "currentFormatted": "$20.00", "stockStatus": "InStock" } }
28  ]
29}

Tips

Mulai dengan satu domain dan batas kecil. Seratus produk sudah cukup untuk melihat sumber data mana yang dibuka toko itu dan seberapa lengkap record-nya. Setel maxProductsPerStore pada run multi-toko. Tanpa itu, katalog besar pertama menghabiskan anggaran sebelum toko lain tersentuh. Aktifkan ulasan secara sadar. Ulasan adalah record dan biaya tersendiri, dan sebagian besar pekerjaan pemantauan harga tidak memerlukannya. Biarkan peralihan HTML tetap aktif. Itulah yang membuat toko terkunci tetap bisa diambil; batas per run menjaga biayanya.

faq

Bagaimana jika JSON API toko dimatikan?

Itulah kasus umum yang menjadi tujuan Actor ini. Actor mendeteksi situasinya dan tetap mengambil katalog, jadi toko yang tertutup pun mengembalikan produk.

Bagaimana memastikan situs itu benar-benar WooCommerce?

Arahkan Actor ke domainnya dan biarkan ia memutuskan — deteksi adalah bagian dari run.

Apakah variasi menjadi record terpisah?

Tidak. Satu record adalah satu produk, dengan variasinya bersarang di variants, masing-masing membawa SKU, harga, dan status stok sendiri. Hanya ulasan, bila diaktifkan, yang menjadi record terpisah.