AI SEO WordPress — Yapay Zeka Destekli WordPress SEO Blog Üretim Sistemi

MCP (Model Context Protocol) tabanlı, blog içeriği üretiminden yayınlamaya kadar tüm süreci otomatikleştiren WordPress SEO otomasyon sistemi. (Repo/klasör adı: wp-seo-mcp)

---

👤 Öğrenci Bilgileri

Ad Soyad	Furkan Yeşlirmak
Öğrenci No	24010509041
Ders	CPP214

---

🎯 Projenin Amacı ve Kısa Açıklaması

Küçük işletmeler ve dijital ajanslar için düzenli, SEO uyumlu blog içeriği üretmek ciddi bir zaman ve maliyet yüküdür. Bu proje, bir MCP sunucusu olarak çalışarak içerik üretiminden yayınlamaya kadar tüm akışı otomatikleştirir.

Kullanıcı, Claude'a bir konu (veya anahtar kelime) verir; sistem GPT-4o ile SEO uyumlu blog yazısını üretir, DALL-E 3 ile yazıya uygun öne çıkan görseli oluşturur, Gmail üzerinden onay maili gönderir ve onaylanan içeriği WordPress REST API ile siteye yayınlar. Tüm süreç Claude arayüzünden tek bir komutla yönetilebilir.

---

🧰 Kullanılan Teknolojiler / Kütüphaneler

• Node.js 18+ — çalışma zamanı (ES Modules)
• @modelcontextprotocol/sdk — MCP sunucu altyapısı (Claude entegrasyonu)
• OpenAI (openai) — GPT-4o ile blog içeriği, DALL-E 3 ile görsel üretimi
• WordPress REST API — içeriğin otomatik yayınlanması
• Nodemailer — Gmail üzerinden onay maili gönderimi
• Express — onay butonları için HTTP sunucusu (approval-server.js)
• node-fetch — HTTP istekleri

---

📁 Proje Klasör Yapısı

wp-seo-mcp/
├── src/
│   ├── index.js          ← MCP Server (ana giriş noktası, tool tanımları)
│   └── config.js         ← Yapılandırma (API anahtarları, .env okuma)
├── tools/
│   ├── generateBlog.js   ← GPT-4o ile SEO blog üretimi
│   ├── generateImage.js  ← DALL-E 3 ile görsel üretimi
│   ├── wordpress.js      ← WordPress REST API yayınlama
│   ├── approval.js       ← Gmail onay sistemi (mail + token)
│   ├── seoAnalyze.js     ← İçerik SEO analizi
│   └── listPosts.js      ← Bekleyen / taslak yazıları listeleme
├── approval-server.js    ← Onay butonları için HTTP sunucusu
├── .env.example          ← Örnek ortam değişkenleri
├── .gitignore
├── package.json
└── README.md             ← Bu dosya

---

🧩 Mevcut MCP Araçları

Araç	Açıklama
generate_blog_post	GPT-4o ile SEO uyumlu blog yazısı üretir
generate_image	DALL-E 3 ile öne çıkan görsel üretir
analyze_seo	İçeriğin SEO analizini ve puanını verir
send_approval_email	Kullanıcıya onay maili gönderir
check_approval_status	Onay durumunu sorgular
publish_to_wordpress	İçeriği WordPress'e yayınlar / taslak kaydeder
list_pending_posts	Bekleyen yazıları listeler

---

🛠️ Kurulum Adımları

1. Projeyi Klonla ve Bağımlılıkları Yükle

git clone https://github.com/RouxFurkan/wp-seo-mcp
cd wp-seo-mcp
npm install

2. Ortam Değişkenlerini Ayarla

cp .env.example .env
# .env içindeki değerleri doldurun

WP_SITE_URL=https://siteniz.com
WP_USERNAME=admin
WP_APP_PASSWORD=xxxx xxxx xxxx xxxx xxxx xxxx
OPENAI_API_KEY=sk-...
GMAIL_USER=ornek@gmail.com
GMAIL_APP_PASSWORD=xxxx xxxx xxxx xxxx
APPROVAL_BASE_URL=https://siteniz.com
APPROVAL_PORT=3001

3. WordPress Application Password

WP Admin → Users → Profile → Application Passwords → "wp-seo-mcp" adıyla oluştur, çıkan şifreyi WP_APP_PASSWORD'e yaz. REST API testi: https://siteniz.com/wp-json/wp/v2/posts

4. Gmail App Password

Gmail → Hesap → Güvenlik → 2 Adımlı Doğrulama açık → Uygulama Şifreleri → 16 haneli şifreyi GMAIL_APP_PASSWORD'e yaz.

---

▶️ Çalıştırma / Kullanım Talimatları

MCP Sunucusu

node src/index.js

Onay Sunucusu (ayrı terminal)

node approval-server.js
# veya arka planda:
pm2 start approval-server.js --name wp-approval

Claude Desktop Bağlantısı

%APPDATA%\Claude\claude_desktop_config.json içine ekleyin:

{
  "mcpServers": {
    "wp-seo-mcp": {
      "command": "node",
      "args": ["C:/path/to/wp-seo-mcp/src/index.js"],
      "env": {
        "WP_SITE_URL": "https://siteniz.com",
        "WP_USERNAME": "admin",
        "WP_APP_PASSWORD": "xxxx xxxx xxxx xxxx",
        "OPENAI_API_KEY": "sk-...",
        "GMAIL_USER": "ornek@gmail.com",
        "GMAIL_APP_PASSWORD": "xxxx xxxx xxxx xxxx",
        "APPROVAL_BASE_URL": "https://siteniz.com",
        "APPROVAL_PORT": "3001"
      }
    }
  }
}

Örnek Kullanım Akışı

Claude'a şu komut verilir:

"car wrap renk değişimi hakkında Türkçe bir blog yaz,
SEO analizi yap, görsel oluştur ve onay maili gönder"

Sistem sırasıyla: generate_blog_post → analyze_seo → generate_image → send_approval_email → (mailden onay) → publish_to_wordpress adımlarını otomatik yürütür.

---

🖼️ Ekran Görüntüleri

Ekran görüntüleri repodaki docs/screenshots/ klasöründe yer almaktadır.

• 01-claude-command.png — Claude'a verilen komut ve araç çağrıları
• 02-approval-email.png — Gmail'e gelen onay maili
• 03-wordpress-post.png — WordPress'te yayınlanan yazı ve öne çıkan görsel

---

🔗 GitHub Proje Bağlantısı

https://github.com/RouxFurkan/wp-seo-mcp

---

📚 Kaynakça / Yararlanılan Bağlantılar

• Model Context Protocol — https://modelcontextprotocol.io/
• OpenAI API (GPT-4o, DALL-E 3) — https://platform.openai.com/docs/
• WordPress REST API Handbook — https://developer.wordpress.org/rest-api/
• Nodemailer — https://nodemailer.com/
• Express — https://expressjs.com/

---

Not: Bu proje eğitim amaçlı geliştirilmiştir. API anahtarları ve şifreler .env dosyasında tutulur ve repoya dahil edilmez (.gitignore).