MSBlock — Tam Kapsamlı Reklam Engelleyici

Full-featured MV3 ad blocker for Chrome/Brave/Edge/Opera. Blocks YouTube ads without ever breaking video playback, and escapes "ad blocker detected" walls. 216k+ network rules, cosmetic filtering, scriptlets, element picker. Zero telemetry, zero remote code. English docs: see code comments; UI is Turkish.

Chrome, Brave, Edge ve Opera'da çalışan; YouTube reklamlarını video oynatmayı bozmadan engelleyen; internetteki reklamları, izleyicileri ve zararlı alan adlarını kaynağından kesen Manifest V3 tarayıcı eklentisi.

Tüm işlem cihazınızda gerçekleşir. MSBlock hiçbir veri toplamaz, hiçbir sunucuya bilgi göndermez, uzaktan kod çalıştırmaz.

superadblocktest.com: %82 (engelleyicisiz %6)	adblock-tester.com: 100/100
YouTube: reklamsız, kesintisiz oynatma	TRT 1 canlı: anti-adblock duvarı atlatıldı, yayın akıyor

Neden MSBlock?

	MSBlock	uBlock Origin Lite	AdBlock Plus	DNS engelleyici (Pi-hole vb.)
Chrome MV3'te tam çalışır	✅	✅	✅	—
Ağ kuralı sayısı	216.181	~50-100k (varsayılan az)	daha az	listeye bağlı
Kozmetik filtreleme (boş kutu kalmaz)	✅ 22.9k seçici	kısıtlı	✅	❌ yapamaz
Scriptlet / anti-adblock savunması	✅ 10.468 alan	kısıtlı	❌	❌
Öğe seçici (tıkla-gizle)	✅	❌	✅	❌
Kendi filtrelerini yazma	✅ ağ + kozmetik	❌	✅	alan bazlı
YouTube reklam engelleme	✅ 3 katman	kısmi	kısmi	❌ (video kırar!)
Anti-adblock duvarı atlatma	✅ 3 katman (mock SDK + scriptlet + duvar sökücü)	❌	❌	❌
Video oynatma garantisi	✅ derleyici seviyesinde	—	—	❌ googlevideo riski
"Kabul edilebilir reklam" istisnası	❌ yok	yok	⚠️ varsayılan AÇIK	yok
Veri toplama / telemetri	❌ sıfır	sıfır	⚠️	sıfır
Türkçe reklam listesi + arayüz	✅ dahili	❌	❌	manuel
Zararlı yazılım koruması (URLHaus)	✅	❌	❌	listeye bağlı

Fark yaratan iki tasarım kararı:

1. Video asla kırılmaz. DNS/hosts tabanlı çözümler googlevideo.com sunucularını engelleyip videoların kendisini bozar. MSBlock derleyicisi bu sınıf kuralları derleme anında reddeder ve test paketi her derlemede "hiçbir kural video URL'siyle eşleşemez" garantisini doğrular.
2. Skor için site kırılmaz. Çerez onay platformları, A/B test araçları gibi "engellenirse site bozulur" alanlar bilinçli olarak engellenmez — uBlock Origin felsefesi: reklamı engelle, web'i kırma.

---

Özellikler

• 216.000+ ağ kuralı — EasyList, EasyPrivacy, uBlock Origin filtreleri (ads + privacy + badware + unbreak + quick-fixes), AdGuard DNS filtresi, anti-adblock circumvention listeleri (abp-filters-anti-cv + AdGuard antiadblock), Peter Lowe, URLHaus zararlı yazılım listesi ve Türk reklam listesinden derlenir
• Anti-adblock atlatma (3 katman) — "reklam engelleyici tespit edildi" duvarları yüzünden açılmayan video ve siteler açılır:
  1. Sahte IMA/GPT SDK yönlendirmesi — Google IMA/GPT reklam SDK'ları engellenmek yerine zararsız taklitlerine yönlendirilir; oynatıcı SDK'yı "yüklendi" görür, reklam ister, "reklam yok" yanıtı alır, içeriği oynatır. tabii.com ve TRT canlı yayın bu yöntemle sorunsuz açılır.
  2. Scriptlet motoru — abort-current-inline-script, set-constant, override-property-read, no-setTimeout-if, no-setInterval-if, prevent-eval-if, nowebrtc scriptlet'leri; 10.000+ alanda anti-adblock tespit betiklerini etkisizleştirir
  3. Genel duvar sökücü — listede olmayan siteler için: tüm ekranı kaplayan "reklam engelleyici" uyarı katmanını kaldırır, kaydırmayı geri açar, duraklatılan videoyu devam ettirir (yalnızca gerçek adblock duvarlarında; giriş/çerez/paywall modallarına dokunmaz)
• Kozmetik filtreleme — 13.700+ genel seçici (kayıtlı stil dosyası) ve 12.200+ alana özel seçici; USER origin CSS ile enjekte edilir, sayfa bunu ne görebilir ne kaldırabilir
• Scriptlet motoru — uBlock Origin scriptlet'lerinin derlenmiş alt kümesi; 10.468 alanda çalışır, alan adına göre 48 pakete bölünmüştür (sayfa yalnızca kendi paketini yükler). Tamamı paketle gelir, uzaktan kod yok
• YouTube: üç katmanlı koruma
  1. Ağ katmanı: yalnızca reklam uçları (/api/stats/ads, /pagead/ …) engellenir — googlevideo.com video sunucularına asla dokunulmaz
  2. Veri katmanı: JSON.parse / Response.json kancaları oynatıcı yanıtından adPlacements, adSlots, playerAds alanlarını temizler
  3. Oynatıcı katmanı: yine de sızan reklam (ör. sunucu taraflı eklenen) anında atlanır — önce "Atla" düğmesi, yoksa sustur + hızlandır + sonuna yakın sar. Reklam olduğu görünür reklam arayüzüyle doğrulanmadan içerik videosuna dokunulmaz; anti-adblock uyarı pencereleri otomatik kapatılır
• Öğe seçici — sayfadaki herhangi bir öğeyi tıklayıp kalıcı olarak gizle (kendi filtrelerine yazılır)
• Site bazlı izin listesi — tek tuşla bu sitede engellemeyi kapat (Alt+Şift+B kısayolu)
• Kendi filtrelerin — ABP/uBO söz dizimiyle ağ ve kozmetik filtre yaz
• Rozet sayacı — sekmede engellenen istek sayısı
• Hızlı düzeltmeler — uBO quick-fixes listesi (yalnızca resmî adresten, isteğe bağlı, günlük) dinamik kurallara işlenir; içerik yalnızca veri olarak ayrıştırılır

Performans

MSBlock, sayfa başına yalnızca o sayfanın ihtiyacı olan veriyi yükler:

	v1.1.0	v1.2.0
Sayfa başına scriptlet verisi	1,49 MB (her sayfa, her çerçeve)	~30 KB (yalnızca eşleşen alan kümesi)
Genel kozmetik CSS	227 KB metin, her çerçeve için servis worker üzerinden enjekte	Kayıtlı dosya — Chrome bir kez ayrıştırır, document_start'ta uygular
Servis worker açılışı	38 MB kural JSON'u ayrıştırılıyordu	Derleme zamanı stats.json (ayrıştırma yok)
JSON kancası	İki ayrı JSON.parse sarmalayıcısı	Tek zincir + erken çıkış (reklam anahtarı yoksa dokunmaz)
YouTube oynatıcı bekçisi	250 ms'de bir DOM taraması	Olay tabanlı + 1 sn güvenlik ağı
Zamanlayıcı filtresi	Her setTimeout çağrısında toString()	WeakMap önbelleği

Ayrıca oynatıcı bekçisinde bir hata giderildi: yalnızca ad-showing sınıfına bakıp reklam sanılan durumlarda içerik videosu sona sarılıyor ve 16× hıza alınıyordu — bu, reklam gösterilen gerçek kullanımda saniyelerce yeniden tamponlama demekti. Artık ekranda görünür reklam arayüzü de aranıyor (test/e2e/test-watcher-safety.mjs bunu doğruluyor).

imasdk.googleapis.com/pal/sdkloader/pal.js (PAL) artık engellenmiyor, sahte sürüme yönlendiriliyor: oynatıcılar bu kütüphaneyi bekler, engellenirse oynatma sabit bir süre gecikir.

Kurulum (geliştirici modu)

1. Tarayıcıda chrome://extensions (Brave: brave://extensions, Edge: edge://extensions, Opera: opera://extensions) aç
2. Sağ üstten Geliştirici modunu aç
3. Paketlenmemiş öğe yükle → bu klasörü (MSBlock) seç

Brave kullanıyorsan: Brave'in kendi Shields'ı da reklam engeller. İkisini birlikte çalıştırmak gereksiz çift iş yaratır ve bazı sitelerde çakışabilir. MSBlock'u tek başına denemek için adres çubuğundaki aslan simgesinden Shields'ı kapatabilirsin.

Firefox notu: Firefox MV3'te arka plan "event page" kullanır. manifest.json içindeki background bölümüne "scripts": ["src/background.js"] ekleyip browser_specific_settings.gecko.id tanımlamak gerekir; DNR kural setleri Firefox 113+ ile uyumludur.

Mimari

build/fetch-lists.mjs   → listeleri resmî kaynaklardan indirir (SHA-256 kayıtlı)
build/compile.mjs       → ABP söz dizimi → DNR JSON + kozmetik indeks + scriptlet config
src/lib/abp-parser.mjs  → paylaşılan ayrıştırıcı (derleyici + kullanıcı filtreleri)
src/background.js       → kozmetik enjeksiyon, izin listesi, dinamik kurallar, mesajlaşma
src/content/cosmetic.js → her karede kozmetik CSS talebi (document_start)
src/content/yt-main.js  → YouTube MAIN-world JSON temizliği
src/content/youtube.js  → oynatıcı bekçisi: reklam atlama + anti-adblock kapatma
src/content/scriptlets-main.js → scriptlet motoru (yalnızca paketli config)
rulesets/scriptlets/     → alan adına göre bölünmüş scriptlet paketleri (48 kova)
src/content/antiadblock.js → genel anti-adblock duvar sökücü (emniyet katmanı)
src/redirect/google-ima.js → sahte Google IMA SDK (reklam duvarlarını atlatır)
src/redirect/gpt.js       → sahte Google Publisher Tag
src/redirect/pal.js       → sahte PAL (nonce kütüphanesi; engellenirse oynatma gecikir)
rulesets/               → derlenmiş kural setleri (9 DNR + kozmetik + scriptlet)

Anti-adblock atlatma nasıl çalışır?

tabii.com / TRT canlı yayın gibi siteler Google IMA reklam SDK'sının (imasdk.googleapis.com/.../ima3.js) yüklenip yüklenmediğini kontrol eder; engellenirse "reklam engelleyici tespit edildi" der ve videoyu duraklatır. MSBlock bu SDK'yı engellemek yerine zararsız bir taklidine yönlendirir (web_accessible_resources + DNR redirect). Oynatıcı SDK'yı yüklenmiş görür → reklam ister → taklit "reklam yok / hata" der → oynatıcı içeriğe geçer. Video dağıtımına (m3u8 manifest, CDN) hiç dokunulmaz, sadece reklam mantığı devre dışı kalır. Liste tabanlı scriptlet'ler ve genel duvar sökücü, IMA kullanmayan diğer siteleri kapsar.

Neden videolar kırılmıyor?

YouTube, reklamları da videoları da aynı CDN'den (googlevideo.com) dağıtır. Hosts tabanlı listeler bazen r3---sn-*.googlevideo.com gibi sunucuları engeller — sonuç: reklam değil, videonun kendisi kırılır. MSBlock derleyicisi bu tür kuralları derleme anında reddeder (isPlaybackBreaking), test paketi de hiçbir derlenmiş kuralın googlevideo/videoplayback ile eşleşemeyeceğini her derlemede doğrular. Reklamlar ağ yerine veri ve oynatıcı katmanında kesilir.

Yeniden derleme

npm run build     # listeleri indir + derle
npm test          # birim + kapsam testleri (30 test)
node test/e2e/run.mjs --runs 5   # gerçek tarayıcıda uçtan uca test

Güvenlik

• İzinler asgari: declarativeNetRequest, storage, scripting, tabs, alarms
• eval yok, uzak kod yok, WebAssembly yok; scriptlet'ler paketli ve beyaz listeli
• Kozmetik seçiciler enjeksiyondan önce sözdizimsel olarak doğrulanır ({ } ; \ ve url() reddedilir)
• Kullanıcı filtreleri ve quick-fixes içeriği yalnızca veri olarak ayrıştırılır; redirect, csp gibi kod-etkili seçenekler dinamik kurallarda reddedilir
• Mesajlaşmada alan adı, içerikten değil sender.url'den alınır (sahte mesaj koruması)
• Hiçbir telemetri, hiçbir dış istek (yalnızca isteğe bağlı quick-fixes güncellemesi, sabit HTTPS adres)

Test sonuçları (gerçek tarayıcı, 5 tur)

Test	Engelleyicisiz	MSBlock
superadblocktest.com	%6	%82
obfusgated.com ad-block-test	%14	%85
adblock-tester.com	43/100	100/100
canyoublockit.com extreme	reklamlar yüklendi	tüm bölmeler boş
YouTube (monetize video)	reklam yedi, video gecikti	reklamsız, kesintisiz
TRT 1 canlı / tabii.com	"reklam engelleyici tespit edildi" duvarı	duvar yok, yayın akıyor

Ayrıntı, tur-tur tutarlılık tablosu ve "kalan %15 neden bilinçli engellenmiyor" analizi: TEST-RESULTS.md. Ham JSON + ekran görüntüleri: test/e2e/results/.