~/ecommerce/woocommerce-scraper

Scraper WooCommerce — produits, prix, stock et avis

Extrayez produits, variations, catégories et avis clients de n’importe quelle boutique WooCommerce. Donnez-lui un domaine et il trouve le catalogue, même quand la boutique a désactivé son API JSON.

général TypeScriptCheerio Monde

exécuter sur Apify

proooxy/woocommerce-scraper — specs

catégorieecommerce / général

langageTypeScript

stackTypeScript, Cheerio

marchésMonde

sortieJSON propre, prêt pour le RAG

fonctionnalités clés

Un domaine suffit — l’Actor trouve le catalogue tout seul

Fonctionne même sur les boutiques dont l’API JSON est désactivée ou bloquée par un pare-feu

Toutes les variations des produits variables, chacune avec sa référence, son prix et son état de stock

Avis clients en enregistrements distincts, avec note, auteur et date

Prix en unité monétaire minimale, accompagnés du format d'affichage de la boutique : aucun arrondi erroné

Plafonds par boutique, pour qu'un gros catalogue n'étouffe pas les autres dans une exécution multi-boutiques

Recherche par mot-clé sur chaque boutique de l'exécution, pas seulement un parcours complet du catalogue

Concurrence prudente par défaut — la plupart des boutiques WooCommerce sont de petits WordPress auto-hébergés

cas d’usage

Veille tarifaire et d'assortiment chez des marchands WooCommerce indépendants
Constitution d'un catalogue à partir de la longue traîne de petites boutiques absentes des places de marché
Recherche concurrentielle quand le concurrent tourne sous WordPress plutôt que Shopify
Analyse des avis pour la perception produit et la distribution des notes
Alimentation de comparateurs, places de marché et agents d'achat
Suivi du stock et de la disponibilité pour les contrôles distribution et revendeurs

paramètres d’entrée

Paramètre	Type	Requis	Description
`domains`	array	optionnel	Domaines nus, un par ligne — la façon la plus simple de désigner une boutique
`startUrls`	array	optionnel	Toute URL WooCommerce : racine de la boutique, catégorie, page de tag ou produit unique
`maxProducts`	integer	optionnel	Nombre d'enregistrements produits à enregistrer sur l'ensemble de l'exécution
`maxProductsPerStore`	integer	optionnel	Plafond par boutique, pour qu'un gros catalogue ne consomme pas tout le budget
`includeVariations`	boolean	optionnel	Récupérer chaque variation des produits variables, avec référence, prix et stock
`includeReviews`	boolean	optionnel	Enregistrer les avis clients comme enregistrements distincts (note, auteur, date)
`query`	string	optionnel	Terme de recherche appliqué à chaque racine de boutique ou domaine de l'exécution
`allowHtmlFallback`	boolean	optionnel	Autoriser la bascule HTML pour les boutiques dont l'API JSON est désactivée ou filtrée
`proxy`	object	optionnel	Configuration du proxy ; le scraper n'escalade que lorsqu'une boutique l'exige

Exemple de sortie

 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}

Conseils

Commencez par un domaine et un petit plafond. Cent produits suffisent à voir quelle source la boutique expose et à quel point les enregistrements sont complets. Fixez maxProductsPerStore en multi-boutiques. Sans cela, le premier gros catalogue absorbe le budget avant que les autres soient touchées. Activez les avis sciemment. Ce sont des enregistrements et des coûts distincts, rarement nécessaires en veille tarifaire. Laissez la bascule HTML active. C’est elle qui rend exploitables les boutiques verrouillées ; le plafond par exécution en borne le coût.

faq

Et si l'API JSON de la boutique est coupée ?

C’est le cas courant pour lequel cet Actor est conçu. Il détecte la situation et récupère quand même le catalogue : une boutique verrouillée renvoie aussi ses produits.

Comment savoir si un site est vraiment sous WooCommerce ?

Donnez le domaine à l’Actor et laissez-le décider — la détection fait partie de l’exécution.

Les variations sont-elles des enregistrements séparés ?

Non. Un enregistrement correspond à un produit, ses variations étant imbriquées dans variants avec référence, prix et état de stock propres. Seuls les avis, s'ils sont activés, forment des enregistrements distincts.