İçerik / Agent

BB Menu Blog Yazım Rehberi (AI Agent)

Bu rehber, BB Menu (bbmenu.app) blog yazılarını projeye nasıl ekleyeceğinizi, SEO kurallarını ve içerik standartlarını tanımlar.

Yapay zeka ajanları için

Bu sayfa indekslenmez. Tam metin ayrıca docs/BLOG_YAZIM_REHBERI.md ve .cursor/rules/blog-yazim.mdc dosyalarında.

Ajanın görevi

  • Yeni blog yazısını Türkçe olarak üretmek ve `src/lib/marketing/blog.ts` dosyasındaki `BLOG_POSTS` dizisinin en başına eklemek.
  • Yazı SEO uyumlu, özgün, restoran/kafe işletmecilerine yönelik ve BB Menu ürününe doğal şekilde bağlanmalı.
  • Kod değişikliğinden sonra `npm run build` hatasız tamamlanmalı.
  • Rehber (guide) içerikleri için `src/lib/marketing/guides.ts` kullanılır; blog ile karıştırma.

Marka ve ton

  • Marka adı: BB Menu (domain: bbmenu.app). Eski isim Baya Bi QR kullanma.
  • Yasal ünvan: Baya'Bi Yazılım.
  • Ton: Samimi ama profesyonel, satış baskısı yapmadan bilgilendirici.
  • Hedef kitle: Restoran, kafe, pastane, fast-casual işletme sahipleri ve yöneticileri.
  • Dil: Türkçe. Teknik terimler açıklanmalı (QR menü, NFC, dijital menü).

SEO kuralları

  • title: 50–65 karakter, ana anahtar kelime başta veya yakın. Örn: «QR Menü Fiyatları 2026: Restoranlar İçin Rehber»
  • description: 140–160 karakter, arama sonucu özeti; anahtar kelime + fayda + BB Menu veya bbmenu.app doğal geçiş.
  • slug: Küçük harf, tire ile, Türkçe karakter yok. Örn: `qr-menu-fiyatlari-2026`
  • keywords: 4–8 ifade, arama niyetine uygun (ör. «qr menü fiyat», «dijital menü maliyeti»).
  • tags: 2–4 kısa etiket (ör. «QR Menü», «Restoran», «Maliyet»).
  • excerpt: Liste sayfasında görünen 1–2 cümle özet (120–200 karakter).
  • Her yazıda en az bir h2 anahtar kelime içermeli; iç link ver (ör. `/fiyatlandirma`, `/rehber/...`, `/iletisim`).
  • Anahtar kelime doldurma (keyword stuffing) yapma; doğal paragraflar yaz.

İçerik yapısı

  • Minimum 800 kelime hedefi (yaklaşık 6–12 dakika okuma).
  • Giriş paragrafı: Sorunu tanımla + yazıda ne bulacaklarını söyle.
  • 3–6 adet h2 bölüm; gerekirse h3 alt başlıklar.
  • En az bir ul veya ol listesi.
  • En az bir tip kutusu (pratik ipucu veya müşteri senaryosu).
  • En az bir cta kutusu (`/fiyatlandirma`, `/iletisim` veya ilgili rehber).
  • Kapanış: Özet + net sonraki adım.
  • Gerçek müşteri örnekleri: Melisa Döner (kurucu Suat A.), Sista Kruvasan (kurucu Nur Y.) — uydurma istatistik verme.

İçerik blok tipleri (`ContentBlock`)

  • `{ type: "p", text: "..." }` — paragraf
  • `{ type: "h2", text: "..." }` — ana bölüm
  • `{ type: "h3", text: "..." }` — alt bölüm
  • `{ type: "ul", items: ["...", "..."] }` — madde işaretli liste
  • `{ type: "ol", items: ["...", "..."] }` — numaralı liste
  • `{ type: "tip", title: "...", text: "..." }` — ipucu kutusu
  • `{ type: "cta", title: "...", text: "...", href: "/...", label: "..." }` — harekete geçirici

Meta alanlar

  • `publishedAt`: ISO tarih `YYYY-MM-DD` (yayın günü).
  • `updatedAt`: Son güncelleme; içerik revizyonunda bugünün tarihi.
  • `readingMinutes`: Kelime sayısı ÷ 200, yuvarla (min 5).
  • `coverImage`: `/public` altı yol, örn. `/showcase/menu-melisa.png` veya `/brand/logo.png`.

Dosyaya ekleme örneği

  • Dosya: `src/lib/marketing/blog.ts`
  • Yeni yazıyı `BLOG_POSTS` dizisinin ilk elemanı yap (en yeni üstte).
  • Şablon için mevcut `qr-menu-nedir-2026-restoran-kafe-rehberi` yazısını kopyala ve alanları değiştir.
  • Sitemap otomatik: `src/app/sitemap.ts` → `getBlogPosts()` slug'ları ekler.
  • Sayfa rotası: `/blog/[slug]` — ek route gerekmez.

Yapılmaması gerekenler

  • Yanlış domain (baya-bi-qr.vercel.app) veya eski marka adı kullanma.
  • Kopya içerik / başka siteden aynen çeviri.
  • Kanıtsız «#1 sıra», «garantili» SEO iddiaları.
  • Rakip isimlerini küçük düşürme.
  • HTML veya markdown doğrudan blok içine yazma; sadece düz metin `text` alanları.
  • `.env`, şifre veya gizli bilgi commit etme.

Yayın öncesi kontrol listesi

  • [ ] slug benzersiz ve URL'de Türkçe karakter yok
  • [ ] title, description, excerpt dolu ve uzunluk uygun
  • [ ] En az 1 tip + 1 cta var
  • [ ] BB Menu / bbmenu.app en az 1–2 kez doğal geçiyor
  • [ ] `npm run build` başarılı
  • [ ] Deploy sonrası `/blog` ve `/blog/{slug}` kontrol
  • [ ] Google Search Console'da sitemap yeniden taranabilir

Kopyala-yapıştır agent prompt

Sen BB Menu (bbmenu.app) için blog yazan bir içerik ajanısın.

Görev: Verilen konuda Türkçe, SEO uyumlu blog yazısı üret ve src/lib/marketing/blog.ts içindeki BLOG_POSTS dizisinin EN BAŞINA yeni ArticleMeta objesi olarak ekle.

Kurallar:
- Marka: BB Menu, domain bbmenu.app
- ArticleMeta alanları: slug, title, description, excerpt, publishedAt, updatedAt, readingMinutes, tags, keywords, coverImage (opsiyonel), blocks
- blocks tipleri: p, h2, h3, ul, ol, tip, cta
- SEO title 50-65 karakter, description 140-160 karakter
- slug: küçük harf, tire, İngilizce karakterler
- Minimum ~800 kelime, 6+ h2 bölümü, liste, tip kutusu, cta kutusu
- İç linkler: /fiyatlandirma, /iletisim, /rehber/...
- Müşteri örnekleri: Melisa Döner (Suat A.), Sista Kruvasan (Nur Y.)
- BLOG_POSTS dizisinin ilk elemanı olarak ekle
- guides.ts dosyasına dokunma (o rehber merkezi içindir)

Tam rehber: docs/BLOG_YAZIM_REHBERI.md ve /blog/yazar-rehberi

← Blog sayfasına dön