GitHub Kanalı: Düzeltmeleri Pull Request ile Al
Hazırlayan Ersin DorlakSon güncelleme:
Bu Sayfa Ne Yapar
GitHub kanalı, depodan derlenip yayınlanan özel kodlu sitelerde Otopilot'un SEO düzeltmelerini otopilot/seo-duzeltmeleri adlı tek bir dalda toplar ve hedef dalınıza Pull Request açar; siz birleştirip siteyi yeniden yayınladığınızda düzeltmeler sunucu tarafında, Google'ın indirdiği HTML'de olur. Next.js gibi çatılarda başlık ve meta etiketleri koddan üretildiği için Pixel kalıcı çözüm değildir, her düzeltmeyi elle koda işlemek de zaman alır; bu kanal değişiklikleri sizin onay akışınıza, yani kod incelemesine bağlar.
Kurulum ekranı SEO Onarım sayfasının Kanal & Kurulum görünümünde GitHub kartından açılır. Bağlantı yokken Depoyu bağla bloğunda token oluşturma yönergesi ile Depo (sahip/ad veya adres), Fine-grained token, Hedef dal ve Kural dosyası yolu alanları bulunur. Bağlandıktan sonra blok deponun adını taşır; içinde Açık Pull Request'i gör bağlantısı ya da "Açık PR yok." notu, son senkron zamanı, PR'a giremeyen düzeltme sayısı ve PR'ı şimdi güncelle, Bağlantıyı test et, Bağlantıyı kaldır düğmeleri yer alır.
Arka planda panel her saat (17. dakikada) depoyu eşitler. Önce açık PR'ın durumuna bakar: birleştirilmişse içindeki düzeltmeleri uygulanmış sayar ve doğrulamayı başlatır, birleştirilmeden kapatılmışsa düzeltmeleri yeniden kuyruğa alır. Ardından bu kanala ait düzeltmeleri kural dosyasına (varsayılan .seopanel/rules.json) sayfa yoluna göre yazar, dosya değiştiyse "Otopilot: 12 SEO düzeltmesi" mesajıyla commit atar ve açık PR yoksa "Otopilot: SEO düzeltmeleri" başlıklı yeni PR açar. Yalnız başlık, meta açıklama, canonical, robots meta, Open Graph, şema, yönlendirme, robots.txt ve sitemap kuralları PR'a girer; desteklenmeyen kural içeren düzeltme bütünüyle dışarıda kalır.
Kanal, sitesini Next.js, Nuxt ya da statik site üreticisiyle depodan yayınlayan ekipler içindir. Değişiklikler kod incelemesinden geçer, her PR Site kodu görevleri ekranının Yayın betikleri sekmesinde bir sürüm olarak izlenir ve PR kapatılarak ya da birleştirilmiş commit geri alınarak geri dönülebilir. Sitede Next.js bağlayıcı paketinin pageOverrides, siteFile ve redirectFor yardımcılarının kurulu olması gerekir; kural dosyasını sayfalara bu yardımcılar uygular.
Sık yanlış anlama, PR'ın birleştirilmesiyle işin bittiğidir: panel birleştirmeyi canlıya geçiş sayar ve doğrulamaya başlar; site yeniden yayınlanmadıysa doğrulama düzeltmeyi bulamaz. Bir diğeri kanalın sessizliğidir: GitHub kanalında son başarılı eşitlemeden üç gün geçerse kanal ulaşılamıyor sayılır, diğer sunucu kanallarında bu süre bir gündür.
Anlatılan sayfayı panelde aç(giriş yapınca açılır)
Ön Koşullar
- Planınızda otomatik SEO düzeltme hakkı olmalıdır; hak yoksa GitHub kartı kilitli görünür.
- Sitenin kaynak kodu bir GitHub deposunda olmalı ve sitede Next.js bağlayıcı paketinin pageOverrides, siteFile ve redirectFor yardımcıları kurulu olmalıdır (bkz. Next.js ve PHP Site Bağlayıcı kılavuzu).
- Depoya yazma yetkisi olan bir GitHub hesabıyla fine-grained token oluşturabilmelisiniz: yalnız bu depo; Contents ve Pull requests için Read and write, Metadata için Read.
- Depoyu bağlama, eşitleme, test ve bağlantıyı kaldırma yalnız proje sahibine açıktır.
Adım Adım Kullanım
- Sol menüden SEO Hata Düzenleyici → SEO Onarım sayfasını açın, Kanal & Kurulum görünümünde Geliştirici süzgecini seçip GitHub kartında Yönet düğmesine basın. Kanallar → Web sitem → Önerilen kanal ekranı sitenin altyapısı Next.js, Nuxt, statik ya da tanınmayan bir yapıysa GitHub'ı önerir.
- SEO Onarım ilk kez açılıyorsa Otomatik SEO Hata Düzeltme Kurulumu penceresinde kanal ve modu seçip İleri — Kuruluma git ile devam edin. Başka bir kanal aktifse Teslim kanalını değiştir? penceresinde Devam et deyin; seçim niyet olarak kaydedilir ve depo bağlanınca GitHub aktif kanal olur.
- GitHub'da Settings → Developer settings → Fine-grained tokens yolunu izleyip yeni token oluşturun. Repository access bölümünde yalnız sitenin deposunu seçin; Permissions bölümünde Contents ve Pull requests için Read and write, Metadata için Read verin. Daha geniş izin gerekmez.
- Depo (sahip/ad veya adres) alanına deponun sahip/ad biçimini (ör. ornek-ajans/ornek-site) ya da https://github.com ile başlayan adresini yazın; Fine-grained token alanına token'ı yapıştırın. Token şifreli saklanır ve bağlandıktan sonra alan temizlenir.
- Hedef dal alanına PR'ın açılacağı dalı yazın; varsayılan main'dir, üretim dalınız farklıysa (ör. production) onu girin. Kural dosyası yolu varsayılan olarak .seopanel/rules.json'dur; Next.js bağlayıcısının okuduğu dosya budur, yalnız bağlayıcıyı farklı bir yola ayarladıysanız değiştirin. Yol .json ile bitmelidir.
- Depoyu bağla düğmesine basın. Panel depoyu ve hedef dalı token ile okur, yazma yetkisini kontrol eder; başarılı olunca "Depo bağlandı." bildirimi çıkar ve kart Aktif · Çalışıyor olur.
- Düzeltmeler sekmesinde onaylanmış düzeltmeler varsa PR'ı şimdi güncelle düğmesine basın; saatlik eşitlemeyi beklemeden PR açılır ya da güncellenir. Sonuç "Pull Request açıldı.", "Pull Request güncellendi.", "Değişiklik yok; PR güncel." ya da "Bu kanala gönderilecek düzeltme yok." olarak döner.
- Açık Pull Request'i gör bağlantısıyla PR'ı GitHub'da açın. Değişiklik yalnız kural dosyasındadır; dosyada her sayfa yolu altında düzeltme kimlikleri ve uygulanacak değerler bulunur. Ekibinizle inceleyin, gerekirse PR'a yorum bırakın.
- PR'ı birleştirin ve sitenizi her zamanki yönteminizle yeniden yayınlayın. Panel bir sonraki eşitlemede birleştirmeyi görür, "PR birleştirilmiş; düzeltmeler canlı kabul edildi, doğrulama başlıyor." durumuna geçer ve canlı sayfaları okuyarak düzeltmeleri doğrular.
- PR'daki değişiklikleri istemiyorsanız PR'ı birleştirmeden kapatın. Panel kapanmayı bir sonraki eşitlemede görür, düzeltmeleri yeniden bekleyen duruma alır ve dal hedef dalın son hâlinden yeniden kurularak yeni bir PR hazırlanır; istemediğiniz düzeltmeleri önce Düzeltmeler sekmesinden geri alın.
- Yayın geçmişini Site kodu görevleri ekranının Yayın betikleri sekmesinde izleyin: her PR "GitHub · Sürüm 4 (#18)" satırıyla Açık PR, Birleştirildi, Kapatıldı ya da Yerini yenisi aldı etiketi taşır. Birleştirilmiş bir sürümü Bu sürümü geri al ile geri alırsanız bir sonraki eşitleme bu düzeltmeler olmadan yeni PR hazırlar.
- Kanalı bırakmak için Bağlantıyı kaldır düğmesine basıp onaylayın. Kayıtlı token silinir ve GitHub aktif kanal olmaktan çıkar; açık PR deponuzda kalır, isterseniz GitHub'da kapatın.
Ekrandaki öğeler
- GitHub kanalı (Pull Request) başlığı — altında düzeltmelerin toplandığı dalın adı (otopilot/seo-duzeltmeleri) ve sitede kurulu olması gereken Next.js yardımcılarını belirten not yer alır.
- Depoyu bağla bloğu — bağlantı yokken görünür; fine-grained token oluşturma yönergesini ve dört alanı içerir.
- Depo (sahip/ad veya adres) — örnek biçim sahip/depo; github.com adresi de kabul edilir.
- Fine-grained token — gizli alan; bağlandıktan sonra temizlenir ve ekranda tekrar gösterilmez.
- Hedef dal — PR'ın açılacağı dal; varsayılan main.
- Kural dosyası yolu — düzeltmelerin yazılacağı JSON dosyası; varsayılan .seopanel/rules.json.
- Depo adı başlıklı blok — bağlandıktan sonra görünür; Açık Pull Request'i gör bağlantısı ya da "Açık PR yok." notu bulunur.
- "Son senkron: 17.11.2026 14:17" satırı — panelin depoyla son eşitlendiği zaman.
- PR'a girmeyen düzeltme sayısı — "5 düzeltme bu kanalın desteklemediği kural içerdiği için PR'a girmedi." biçiminde görünür.
- PR'ı şimdi güncelle — saatlik eşitlemeyi beklemeden PR'ı açar, günceller ya da birleştirilmiş PR'ı işler.
- Bağlantıyı test et — token ile depoyu okur; başarılıysa "Depoya erişim var." yazar.
- Bağlantıyı kaldır — onay sonrası token'ı siler, açık PR depoda kalır.
- Sınırlar satırı — PR'a giren kural türlerini ve PR'ın her saat otomatik güncellendiğini belirtir.
Sonuçları nasıl yorumlarsınız
- Açık PR'daki düzeltmeler panelde "Site aldı" durumundadır: siteye gönderildi ama henüz yayında değildir. Birleştirmeden sonra düzeltmeler uygulanmış sayılır ve doğrulama başlar.
- Panel doğrulamayı varsayılan ayarlarda birleştirmeyi gördükten yaklaşık 2 dakika, 1 saat ve 1 gün sonra canlı sayfayı okuyarak yapar. Site bu sürede yeniden yayınlanmazsa doğrulama düzeltmeyi bulamaz; birleştirdikten sonra yayını geciktirmeyin.
- Kart Aktif · Çalışıyor etiketini her başarılı eşitlemede tazeler. Eşitlemeler üç gün boyunca başarısız olursa kart Siteye ulaşmıyor olur ve "Siteye ulaşılamıyor" bildirimi gönderilir; bildirim aynı proje için günde en çok bir kez gelir.
- Yayın betikleri sekmesinde Kapatıldı etiketi PR'ın birleştirilmeden kapandığını, Yerini yenisi aldı ise aynı PR'ın sonraki bir commit'le güncellendiğini gösterir. Birleştirilmiş sürümün satırında "2 geri alındı" görünmesi, o sürümden bazı düzeltmelerin sonradan geri alındığı anlamına gelir.
Örnek senaryo
örnek.com, Next.js ile yazılmış ve kendi sunucusunda next start ile çalışan bir yazılım şirketi sitesi. Geliştirici Next.js bağlayıcı paketini kurmuş, sayfaların generateMetadata fonksiyonlarına pageOverrides yardımcısını eklemiş. Tarama 18 sayfada eksik meta açıklama ve iki eski adreste yönlendirme eksikliği buldu. Ekip, değişikliklerin kod incelemesinden geçmesini istediği için GitHub kartını seçiyor; depoya özel bir fine-grained token oluşturup Depo (sahip/ad veya adres) alanına ornek-yazilim/ornek-site, Hedef dal alanına production yazıyor ve Depoyu bağla diyor.
Düzeltmeleri onayladıktan sonra PR'ı şimdi güncelle düğmesine basıyor; "Pull Request açıldı." mesajı geliyor. Geliştirici PR'da .seopanel/rules.json dosyasındaki 20 düzeltmeyi inceliyor, bir başlığı uygun bulmadığı için panelden o düzeltmeyi geri alıyor; bir sonraki saatlik eşitleme PR'ı güncelliyor. Ekip PR'ı birleştirip siteyi yayınlıyor. Panel bir sonraki eşitlemede birleştirmeyi görüyor, Yayın betikleri sekmesinde sürüm Birleştirildi oluyor ve doğrulama taramaları düzeltmeleri canlı sayfada buldukça Doğrulandı olarak işaretliyor.
İpuçları
- Hedef dalı korumalı (branch protection) tutabilirsiniz; panel yalnız kendi dalına yazar ve PR açar, hedef dala doğrudan commit atmaz.
- Sürekli dağıtım (CI/CD) kullanıyorsanız PR birleşince sitenin otomatik yayınlandığından emin olun; doğrulama yayından sonra başarılı olur.
- Dağıtım sisteminiz PR'lar için önizleme ortamı kuruyorsa birleştirmeden önce önizlemede bir sayfanın kaynağını açıp yeni başlık ve meta etiketlerini kontrol edin.
- Token'a bitiş tarihi verdiyseniz takviminize hatırlatma koyun; süresi dolan token üç gün sonra kanalı ulaşılamıyor durumuna düşürür.
- Görünür metin, görsel ve blog işleri bu kanalla gitmez; bu işler için Kanallar → Takılanlar ve site kodu ekranındaki geliştirici kartlarını kullanın.
- PR'daki bir değişikliği elle düzenlemek yerine düzeltmeyi panelde değiştirin ya da geri alın; panel her eşitlemede dosyayı kendi kayıtlarından yeniden yazar.
Sık yapılan hatalar
- Token'a yalnız Contents iznini verip Pull requests iznini unutmak; dosya dala yazılır ama PR açılamaz.
- PR'ı birleştirip siteyi yayınlamamak; panel düzeltmeleri canlı sayar ama doğrulama canlı sayfada değişikliği bulamaz.
- Sitede pageOverrides, siteFile ve redirectFor yardımcıları kurulmadan kanalı açmak; kural dosyası depoya girer ama sayfalarda hiçbir şey değişmez.
- Kural dosyası yolu alanını bağlayıcının okuduğu yoldan farklı bir yola ayarlamak; PR birleşir, site dosyayı okumaz.
Sık Karşılaşılan Sorunlar
- Depo (sahip/ad), token, dal ve dosya yolunu (.json) kontrol edin.: Alanlardan biri biçime uymuyor: depo sahip/ad ya da github.com adresi olmalı, dal adında boşluk olmamalı, dosya yolu / ile başlamamalı, .. içermemeli ve .json ile bitmelidir. Değerleri düzeltip yeniden bağlayın.
- GitHub token geçersiz.: Token yanlış kopyalanmış, iptal edilmiş ya da süresi dolmuştur; bu durumda kanal hata durumuna geçer. GitHub'da aynı izinlerle yeni bir fine-grained token oluşturup Bağlantıyı kaldır ve Depoyu bağla adımlarıyla yeniden girin.
- Token'ın bu depoya yazma yetkisi yok (Contents + Pull requests: Read and write).: Token depoyu görüyor ama dala yazamıyor ya da PR açamıyor. Token ayarlarında Contents ve Pull requests izinlerini Read and write yapın; kuruluş deposuysa kuruluş yöneticisinin fine-grained token kullanımını onayladığından emin olun.
- Depo veya dal bulunamadı (token bu depoyu görebiliyor mu?).: Depo adı yanlış yazılmış, Hedef dal depoda yok ya da token'ın Repository access listesinde bu depo seçili değil. Depo adını ve dalı GitHub'dakiyle karşılaştırın, token'a depoyu ekleyin.
- Kanal aktif değil; önce GitHub'ı aktif kanal yapın.: Depo bağlı ama SEO Onarım'da aktif kanal başka bir kanal, otomatik düzeltme kapalı ya da mod kapalı. Kanal & Kurulum görünümünde GitHub kartını seçip Teslim kanalını değiştir? penceresini onaylayın; otomatik düzeltmenin açık olduğunu kontrol edin.
- 3 düzeltme bu kanalın desteklemediği kural içerdiği için PR'a girmedi.: Bu düzeltmelerde görsel alt metni, sayfa içeriği ya da blog gibi GitHub kanalının yazamadığı bir kural var; bir düzeltmenin tek kuralı bile desteklenmiyorsa düzeltme bütünüyle dışarıda kalır. Bu işler Kanallar → Takılanlar ve site kodu ekranında ve geliştirici kartlarında listelenir.
- Siteye ulaşmıyor: GitHub kanalında son başarılı eşitleme ya da testten bu yana üç gün geçmiştir; genellikle token'ın süresi dolmuş ya da yetkisi daraltılmıştır. Bağlantıyı test et ile nedeni görün; "Depoya erişim var." yanıtı alınca kanal yeniden aktif olur.
- GitHub'a ulaşılamadı.: Eşitleme sırasında GitHub'a bağlanılamadı ya da istek zaman aşımına uğradı. Geçici bir durumdur; panel bir sonraki saatte yeniden dener, isterseniz biraz sonra PR'ı şimdi güncelle düğmesine basın.
İlgili Kılavuzlar
Bu adımları kendi sitenizde uygulayın
Önce ücretsiz site analiziyle sitenizdeki sorunları görün. Hesabınız varsa rehberde anlatılan sayfayı panelde açın.