Inleiding: Het productbeschrijving probleem
Je webshop heeft 200 producten. Misschien 500. Of 2.000. De meeste hebben een generieke beschrijving van de fabrikant — of helemaal niets. Daardoor mis je organisch verkeer, converteren bezoekers slechter en kom je niet door de AI-gegenereerde zoekresultaten.
Claude lost dit probleem op. In combinatie met n8n en de WooCommerce REST API automatiseer je het genereren van SEO-geoptimaliseerde productbeschrijvingen in jouw tone of voice. Eenmalig instellen, daarna volledig automatisch.
Stap 1: WooCommerce REST API instellen
De WooCommerce REST API geeft je volledige toegang tot je productcatalogus. Activeer hem via WooCommerce → Instellingen → Geavanceerd → REST API. Klik op 'Sleutel toevoegen'.
Geef de sleutel een naam (bijv. 'n8n integratie'), stel de rechten in op 'Lezen/Schrijven' en klik op 'API sleutel genereren'. Noteer de Consumer Key en Consumer Secret — je ziet ze maar één keer.
# WooCommerce API verbinding testen curl -u 'consumer_key:consumer_secret' \ 'https://jouwshop.nl/wp-json/wc/v3/products?per_page=5' # Response: JSON array met productdata
Stap 2: n8n trigger voor nieuwe producten
Installeer n8n via npm of gebruik n8n.cloud. Maak een nieuw workflow aan en voeg een WooCommerce Trigger node toe. Stel deze in op het event 'product.created' — zo wordt de workflow automatisch gestart wanneer je een nieuw product aanmaakt.
Configureer de WooCommerce credentials in n8n met je Consumer Key en Consumer Secret. Test de trigger door een testproduct aan te maken in WooCommerce. Je ziet de productdata verschijnen in n8n's data inspector.
# n8n WooCommerce trigger configuratie { 'resource': 'product', 'event': 'created', 'credentials': { 'consumerKey': '{{ $env.WC_CONSUMER_KEY }}', 'consumerSecret': '{{ $env.WC_CONSUMER_SECRET }}', 'url': 'https://jouwshop.nl' } }
Stap 3: Claude prompt engineering voor productbeschrijvingen
De kwaliteit van de beschrijvingen staat of valt met je prompt. Hier is een bewezen prompt template voor productbeschrijvingen:
# Claude prompt voor productbeschrijving system_prompt = """ Jij bent een e-commerce copywriter voor [Jouw Webshop]. Ons merk is [beschrijf tone of voice: bijv. 'professioneel maar toegankelijk, direct, geen jargon']. Schrijf altijd in het Nederlands. Focus op voordelen voor de klant, niet alleen kenmerken. Gebruik actieve schrijfstijl. """ user_prompt = f""" Schrijf een productbeschrijving voor: Productnaam: {product_naam} SKU: {sku} Categorie: {categorie} Kenmerken: {kenmerken} Prijs: {prijs} Vereisten: - 150-250 woorden - Begin met een pakkende openingszin - Noem 3-5 concrete voordelen - Sluit af met een call-to-action - Gebruik 2-3 relevante zoekwoorden voor SEO """
Stap 4: SEO-optimalisatie
Een goede productbeschrijving is ook SEO-klaar. Vraag Claude niet alleen om een beschrijving maar ook om een SEO titel (max 60 tekens), een meta description (max 155 tekens) en 5-7 focus keywords.
Voeg deze elementen toe aan je Claude request en verwerk ze in afzonderlijke WooCommerce velden. Gebruik de Yoast SEO WooCommerce plugin om de meta title en description in te vullen via de REST API.
# SEO velden via WooCommerce API updaten (met Yoast) { 'meta_data': [ {'key': '_yoast_wpseo_title', 'value': seo_titel}, {'key': '_yoast_wpseo_metadesc', 'value': meta_description}, {'key': '_yoast_wpseo_focuskw', 'value': focus_keyword} ] }
Stap 5: Terugschrijven naar WooCommerce
Na het genereren schrijf je de beschrijving terug via de WooCommerce REST API. Voeg een HTTP Request node toe in n8n met een PATCH request naar het product endpoint.
# WooCommerce product updaten via API PATCH /wp-json/wc/v3/products/{product_id} Content-Type: application/json Authorization: Basic {base64(consumer_key:consumer_secret)} { 'description': claude_beschrijving, 'short_description': claude_korte_beschrijving, 'meta_data': seo_velden }
Test de write-back door een product te controleren in je WooCommerce admin. De beschrijving wordt overschreven door de Claude-gegenereerde tekst. Controleer ook de korte beschrijving (wordt gebruikt in productoverzichten) en de SEO velden.
Stap 6: Batch-verwerking van bestaande producten
Nieuwe producten worden automatisch verwerkt via de trigger. Maar wat met je bestaande catalogus? Maak een aparte n8n workflow voor batch-verwerking.
Voeg een Schedule Trigger toe (bijv. dagelijks om 03:00) gecombineerd met een WooCommerce node die alle producten ophaalt zonder beschrijving (description is leeg of korter dan 50 tekens). Verwerk ze in batches van 10 om de Claude API en WooCommerce niet te overbelasten.
# Batch verwerking met rate limiting import time producten_zonder_beschrijving = wc.get_products(filters={'description_empty': True}) for batch in chunks(producten_zonder_beschrijving, 10): for product in batch: beschrijving = claude.genereer_beschrijving(product) wc.update_product(product.id, {'description': beschrijving}) time.sleep(2) # Rate limiting: 2 seconden tussen calls time.sleep(30) # Pauze tussen batches
Stap 7: Kwaliteitscheck voor publicatie
Volledig blind vertrouwen op AI is niet verstandig. Bouw een review stap in voor nieuwe beschrijvingen. In plaats van direct publiceren, sla de Claude output op als concept (draft status in WooCommerce).
Stuur via n8n een Slack of e-mail notificatie naar je team met een link naar het product concept. Geef een goedkeuringsperiode van 24 uur — als niemand reageert, wordt het automatisch gepubliceerd. Als iemand afkeurt, gaat het in een review wachtrij.
Na de eerste 4 weken kun je de kwaliteit evalueren. Als de beschrijvingen consistent goed zijn, schakel je de review stap uit en publiceer je direct.
Stap 8: Live zetten en monitoren
Schakel je workflow in en monitor de eerste 24 uur nauwlettend. Bekijk elk gegenereerd product in WooCommerce. Controleer op eventuele problemen: te lange beschrijvingen, ontbrekende informatie, tone of voice afwijkingen.
Stel alerts in via n8n voor mislukte runs (API errors, Claude errors, WooCommerce write-back fouten). Bewaar de Claude logs voor analyse en continue verbetering van je prompts.
Troubleshooting
**Probleem: Claude genereert te generieke beschrijvingen** Verijk je prompt met meer context over je merk en doelgroep. Geef 2-3 voorbeelden van goede beschrijvingen als few-shot examples in de system prompt. Claude leert van voorbeelden.
**Probleem: WooCommerce API rate limiting** WooCommerce heeft standaard een limiet van 200 requests per minuut. Voeg een wacht van 500ms in tussen requests. Gebruik bij grootschalige batch-verwerking de WooCommerce bulk update API die meerdere producten in één call verwerkt.
**Probleem: n8n workflow stopt bij grote catalogi** Split grote catalogi op in meerdere workflows. Gebruik n8n's 'Split In Batches' node om te verwerken in groepen van 25 producten. Verwerk 's nachts wanneer de server minder belast is.
Resultaat: Een levende productcatalogus
Na implementatie heb je een zelfvoorzienend systeem: elk nieuw product krijgt automatisch een professionele, SEO-geoptimaliseerde beschrijving in jouw tone of voice. Je bestaande catalogus is binnen één nacht volledig beschreven.
Webshops die dit systeem implementeren zien gemiddeld 15-25% stijging in organisch verkeer binnen 60 dagen, en 8-12% hogere conversieratio door betere productbeschrijvingen. De setup kost je eenmalig 60 minuten — de besparing loopt op tot honderden uren per jaar.
