WooCommerce için Ölçekte AI Ürün Açıklamaları

🇬🇧 English: Read this in English →

500’den fazla WooCommerce ürünü için tek tek açıklama yazmak, açık konuşayım, insanı bitiren bir iş. Her ürünün ana özelliklerini anlatan, müşterinin derdine dokunan ve SEO’ya uygun, birbirinin kopyası olmayan bir metne ihtiyacı var. AI bu işi ortadan kaldırmaz — sana bunu kimse söylemesin — ama haftalar süren yazma angaryasını, günler süren düzenleme işine indirir. Fark burada: yazmaktan değil, düzenlemekten çok daha az yorulursun.

İş Akışı

Süreç “butona bas, yayınla” değil. Yapılandırılmış bir pipeline; ve pipeline’ın her adımında insanın nerede durduğunu bilmen, işin kalitesini belirliyor:

Ürün Verisi (CSV/ERP) → AI Üretimi → İnsan İncelemesi → Toplu Yükleme → QA

Adım 1: Ürün Verilerinizi Hazırlayın

AI ancak verdiğin veri kadar iyidir — çöp girer, çöp çıkar, bu kural değişmedi. Her ürün için şunları topla:

• Ürün adı ve SKU
• Kategori ve alt kategori
• Temel özellikler (boyutlar, ağırlık, malzeme, renk)
• Hedef kitle
• Benzersiz satış noktaları
• Rakip karşılaştırma noktaları (isteğe bağlı)

Bunu yapılandırılmış bir CSV olarak dışa aktar:

sku,name,category,material,dimensions,weight,features,target_audience
WD-001,"Walnut Dining Table",Furniture,Solid Walnut,"180x90x76cm",45kg,"Extendable to 240cm; seats 6-8; oil finish",Homeowners with mid-century modern taste

Adım 2: Prompt Şablonunuzu Oluşturun

Prompt her şeydir. Genel bir “ürün açıklaması yaz” promptu, genel çıktı üretir — ve genel çıktı, mağazanın en sıkıcı rakibiyle aynı sese sahip olmandır. Ton, uzunluk, yapı ve SEO gereksinimleri konusunda net ol.

You are a product copywriter for a premium furniture ecommerce store.

Write a product description for:
Product: {name}
Category: {category}
Material: {material}
Dimensions: {dimensions}
Key Features: {features}
Target Audience: {target_audience}

Requirements:
Length: 150-200 words
Tone: Warm but professional, not salesy
Structure: Opening hook (1 sentence), key benefits (2-3 sentences), specifications paragraph, care/maintenance note
Include the primary keyword "{name}" in the first sentence
Do not use the words "stunning", "exquisite", "elevate", or "transform"
Do not start with "Introducing" or "Meet the"
Write in second person ("you", "your")

Yasaklı kelimeler listesi bu işin gizli kahramanı, bence promptun en değerli satırı. Bu liste olmadan her AI açıklaması “Introducing the stunning…” ile başlar ve beş yüz ürünün hepsi aynı ağızdan çıkmış gibi olur. Kendi markanın “asla kullanmayız” kelimelerini oturup çıkar; bu liste, bir editöryal üslup kılavuzunun ta kendisi ve zamanla en çok işine yarayan varlık o olacak.

Adım 3: Ölçekte Üretin

CSV’ni AI API’si üzerinden toplu işle:

const Anthropic = require('@anthropic-ai/sdk');
const fs = require('fs');
const csv = require('csv-parser');

const client = new Anthropic();

async function generateDescription(product) {
const prompt = buildPrompt(product); // Your template

const response = await client.messages.create({
model: 'claude-sonnet-4-20250514',
max_tokens: 500,
messages: [{ role: 'user', content: prompt }],
system: 'You are a product copywriter. Return ONLY the product description, no preamble.'
});

return response.content[0].text;
}

async function processCSV(inputFile, outputFile) {
const products = [];

// Read CSV
await new Promise((resolve) => {
fs.createReadStream(inputFile)
.pipe(csv())
.on('data', (row) => products.push(row))
.on('end', resolve);
});

// Process in batches of 10
const results = [];
for (let i = 0; i < products.length; i += 10) {
const batch = products.slice(i, i + 10);
const descriptions = await Promise.all(
batch.map(p => generateDescription(p))
);

batch.forEach((product, idx) => {
results.push({
...product,
description: descriptions[idx]
});
});

console.log(Processed ${Math.min(i + 10, products.length)}/${products.length});

// Rate limiting
await new Promise(r => setTimeout(r, 1000));
}

// Write output
// ... save to CSV or directly update WooCommerce
}

Adım 4: İnsan İncelemesi

AI açıklamalarını sakın otomatik yayınlama. Bir inceleme iş akışı kur:

• Bir elektronik tabloya çıktı al şu sütunlarla: SKU, Ürün Adı, AI Açıklaması, Durum (Onaylandı/Düzenle/Reddet)
• Kategoriye göre inceleyici ata — ürünleri gerçekten bilen birini
• Doğruluk için düzenle — AI, üründe olmayan bir özelliği rahatça uydurabilir
• Kopyaları kontrol et — AI, benzer ürünler için birbirine çok benzeyen açıklamalar üretebilir

İnceleme genellikle açıklama başına 1-2 dakika sürer, sıfırdan yazma ise 10-15 dakika. Bu %80-85 zaman tasarrufu demektir.

Adım 5: Toplu Yükleme

WooCommerce’in yerleşik CSV içe aktarıcısını veya REST API batch endpoint’ini kullanın:

// Batch update via WooCommerce API
const batchSize = 100;
for (let i = 0; i < approved.length; i += batchSize) {
const batch = approved.slice(i, i + batchSize);
await wooApi.post('products/batch', {
update: batch.map(p => ({
id: p.woocommerce_id,
description: p.description
}))
});
}

Kalite Kontrol Kontrol Listesi

Yayınlamadan önce her açıklamayı bu listeden geçir:

• [ ] Gerçeklere uygun (özellikler gerçek ürünle eşleşiyor)
• [ ] Yasaklı/aşırı kullanılan kelimeler yok
• [ ] Doğru uzunluk (çok kısa değil, şişirilmemiş)
• [ ] Ana anahtar kelime doğal olarak görünüyor
• [ ] Benzersiz (aynı kategorideki diğer ürünlere çok benzemiyor)
• [ ] Marka için uygun ton
• [ ] AI halüsinasyonları yok (üründe olmayan özellikler)

Maliyet Tahmini

500 ürünlük bir katalog için:

Bunu, açıklama başına $10-20’den geleneksel metin yazımıyla karşılaştır: 500 ürün için $5,000-$10,000. Rakamlar tartışmayı bitiriyor gibi görünse de, gerçek hikâye maliyette değil — asıl mesele bir sonraki bölümde.

Asıl risk hız değil, sessiz tekrar

Açık konuşayım, bu işi ölçekte yaparken beni ucuzluk değil, kalitenin sessizce erimesi kaygılandırır. AI beş yüz açıklamayı üretebilir, ama aynı kategorideki elli sandalyeye birbirinin yüzde seksenine benzeyen elli metin yazma eğilimi de vardır. Google bunu “ince içerik” ve “kalıp içerik” olarak okur; sen zaman kazandığını sanırken sıralamada yavaşça aşağı kayarsın. O yüzden inceleme adımında en çok baktığım şey doğruluk değil, benzerlik. İki ürün açıklaması yan yana konduğunda ayırt edilemiyorsa, ikisi de değersizdir.

İkinci sessiz risk halüsinasyon. AI, “meşe” yazdığın yerde “ahşap kaplama”, “6 kişilik” dediğin yerde “8 kişilik” uydurabilir — ve bu yanlış, bir ürün sayfasında sadece kötü metin değil, tüketici hakları açısından yanıltıcı beyandır. Bir müşteri o özelliğe güvenip satın alır, iade eder, güvenini kaybeder. Ben olsam teknik özellikleri asla AI’nin serbest metnine bırakmaz, CSV’deki yapılandırılmış alandan birebir çekerdim. Yaratıcı cümleyi AI yazsın, sayıyı veri yazsın.

Sonuç

AI ürün açıklaması üretimi, WooCommerce mağazaları için AI’ın en pratik, en yüksek ROI’lu uygulamalarından biri. Anahtar şu: AI’yi insan yargısının yerine koyan değil, ilk taslağı üreten bir çırak olarak gör. Prompt şablonuna zaman yatır, yapılandırılmış bir inceleme akışı kur ve yayınlamadan önce her zaman gerçek doğruluğu doğrula. %80+’lık zaman tasarrufu gerçek ve tekrarlanabilir — yeter ki dizgini elinden bırakma.