Puppeteer Rehberi 2026: Kurulum, Örnekler ve Web Kazıma Kullanımları

Son güncelleme: June 29, 2026
Puppeteer Rehberi 2026: Kurulum, Örnekler ve Web Kazıma Kullanımları

Eğer Puppeteer aradıysan, büyük ihtimalle önce pratik cevabı istiyorsun: Puppeteer, Chrome, Firefox veya Chromium’u Node.js üzerinden kontrol etmeye yarayan bir JavaScript kütüphanesidir. Geliştiriciler bunu tarayıcı içi işlemleri otomatikleştirmek, JavaScript gerektiren sayfalardan veri çekmek, UI testleri çalıştırmak, ekran görüntüsü almak, PDF oluşturmak ve SPA sitelerini taramak için kullanır.

2026’ya özel bu rehber, önce kurulum, örnekler ve veri kazıma kullanım senaryolarıyla başlıyor; ardından başlangıç seviyesinde anlaşılır bir açıklamaya geçiyor. Resmî API ayrıntılarına ihtiyacın varsa pptr.dev sayfasını açık tut. Web sitesi verilerini tabloya aktarmanın kod gerektirmeyen bir yolunu arıyorsan aşağıdaki Thunderbit bölümüne geçebilirsin.

İhtiyaçPuppeteer’ı ne zaman kullanmalısın?Thunderbit’i ne zaman kullanmalısın?
Tarayıcı otomasyonuNode.js scriptleri yazıp sürdürebiliyorsanBir Chrome eklentisi akışı istiyorsan
Web kazımaÖzel mantığa, beklemelere, tıklamalara, ekran görüntülerine veya PDF’lere ihtiyacın varsaAI’nin önerdiği alanlar ve tablo dışa aktarma istiyorsan
TestUI veya regresyon testleri geliştiriyorsanİş verisi, lead, fiyat veya ilan topluyorsan
BakımSeçiciler, yeniden deneme, proxy ve tarayıcı güncellemelerini yönetebiliyorsanDaha az kurulum ve daha az hareketli parça istiyorsan

Basit bir Puppeteer kazıma işlemi genellikle şöyle görünür:

import puppeteer from 'puppeteer';

const browser = await puppeteer.launch({ headless: true });
const page = await browser.newPage();
await page.goto('https://example.com', { waitUntil: 'networkidle2' });
const title = await page.title();
await browser.close();

Şimdi Puppeteer’ın tam olarak ne olduğunu, neden bu kadar popüler olduğunu ve hangi durumlarda kod gerektirmeyen bir aracın daha mantıklı olacağını inceleyelim.

ChatGPT Image Nov 10, 2025, 11_50_03 AM (1).png

Puppeteer Nedir? Tarayıcı Otomasyonunun Temelleri

Temelinde Puppeteer, Google’ın Chrome DevTools ekibi tarafından geliştirilmiş bir Node.js kütüphanesidir. Bunu Chrome ya da Chromium için bir uzaktan kumanda gibi düşünebilirsin. Sen JavaScript kodu yazarsın; Puppeteer da tarayıcıyı açar, butonlara tıklar, formları doldurur, verileri çeker, ekran görüntüleri alır ve hatta PDF üretir — üstelik bunların hepsini otomatik olarak yapar.

Puppeteer’ı öne çıkaran şey nedir? Varsayılan olarak “headless” çalışır; yani tarayıcı arka planda açılır, görünür bir pencere oluşmaz. (Artık ekranını işgal eden tarayıcı pop-up’ları yok!) Ancak istersen hata ayıklama ya da demo için “headed” modda da çalıştırabilirsin.

Resmî tanım:

“Puppeteer is a Node.js library which provides a high-level API to control Chrome or Chromium over the DevTools Protocol.”
Puppeteer Docs

Sade dille: Puppeteer, web’i senin gibi kullanabilen bir robot gibidir — sadece daha hızlı, daha tutarlı ve Pazartesi günlerinden şikâyet etmeden.

Headless ve Headed Tarayıcı Kullanımı

  • Headless mod: Tarayıcı görünmeden arka planda çalışır — hız, kaynak tasarrufu ve sunucu/bulut ortamlarında kullanım için idealdir.
  • Headed mod: Tarayıcı ekranında açılır, böylece neler olduğunu izleyebilirsin. Hata ayıklamak ya da otomasyon becerilerini patronuna göstermek için mükemmeldir.

Neden Puppeteer’a Önem Vermelisiniz? Temel Kullanım Alanları ve İş Değeri

Peki Puppeteer işletmeler için neden bu kadar önemli? Çünkü tekrar eden web işlerini otomatik iş akışlarına dönüştürüyor. Şirketler bugün bunu şu amaçlarla kullanıyor:

  • Web kazıma: Dinamik sitelerden ürün fiyatları, stok seviyeleri veya iletişim bilgileri toplama — giriş gerektiren ya da menüler arasında tıklama isteyen siteler dahil.
  • Otomatik test: Web uygulamalarında gerçek kullanıcı davranışlarını taklit ederek UI testleri çalıştırma ve hataları müşteriler görmeden yakalama.
  • Form gönderimi: Toplu veri girişi, kayıt işlemleri veya anket gönderimlerini otomatikleştirme.
  • Rapor üretimi: Gösterge panellerinin, analiz sayfalarının veya pazarlama raporlarının PDF’lerini ya da ekran görüntülerini zamanlanmış şekilde alma — tamamen manuel çaba olmadan.
  • Rakip takibi: Rakip sitelerdeki fiyat düşüşleri ve yeni ürün lansmanları gibi değişiklikleri izleme.

Bunu hızlı bir tabloyla özetleyelim:

Kullanım Alanıİş Faydası
Lead Oluşturma (Web Kazıma)Daha hızlı ve daha büyük lead listeleri — artık kopyala-yapıştır maratonları yok
Rekabetçi Fiyat TakibiGerçek zamanlı piyasa içgörüleri, daha akıllı fiyatlandırma stratejileri
Otomatik Form GönderimiTekrarlayan veri girişini ortadan kaldırır, hataları azaltır
UI Regresyon TestiHataları erken yakalar, yazılım kalitesini artırır
Rapor ve Ekran Görüntüsü ÜretimiTutarlı ve otomatik raporlama — gecenin bir yarısı ekran görüntüsü alma işi biter
Envanter ve İçerik TakibiStok değişiklikleri veya rakip hareketleri için proaktif uyarılar

Gerçek dünya örneği:
Bir geliştirici, her pazartesi dört panoya giriş yapıp satış rakamlarını kopyalamak ve raporlar için ekran görüntüsü almak için 90 dakika harcıyormuş. Puppeteer ile bu süreci tamamen otomatikleştirmiş — haftalık bir eziyeti, uyurken çalışan beş dakikalık bir script’e dönüştürmüş (Medium). ChatGPT Image Nov 10, 2025, 11_57_13 AM (1).png

Puppeteer Nasıl Çalışır? Adım Adım Genel Bakış

Tarayıcı otomasyonuna yeniysen, Puppeteer’ın işleyişi şaşırtıcı derecede basittir. Adım adım şöyle çalışır:

  1. Tarayıcıyı başlatın: Puppeteer, arka planda bir Chrome veya Chromium tarayıcısı açar.
  2. Yeni bir sayfa açın: Tıpkı manuel yaptığınız gibi yeni bir sekme oluşturur.
  3. Bir URL’ye gidin: Script, tarayıcıya nereye gideceğini söyler (örneğin, “https://example.com adresini aç”).
  4. Sayfayla etkileşime geçin: Puppeteer; butonlara tıklar, form doldurur, kaydırır ya da üzerine gelir — bir kullanıcının yapabileceği her şeyi yapabilir.
  5. Veri çekin veya kontroller yapın: Script metin, sayı, görsel alır ya da ekran görüntüsü üretir.
  6. Tarayıcıyı kapatın: İş bittiğinde Puppeteer her şeyi kapatır ve kaynakları serbest bırakır.

Bu, web talimatlarını harfiyen uygulayan, yorulmayan ve ışık hızında çalışan bir asistan gibi.

Puppeteer ve Geleneksel Otomasyon Araçları: Onu Farklı Kılan Nedir?

Puppeteer’dan önce tarayıcı otomasyonu çoğunlukla Selenium gibi araçlarla yapılırdı. Selenium güçlüdür ve pek çok tarayıcıyı ile dili destekler; ancak özellikle modern ve JavaScript ağırlıklı sitelerde daha hantal hissedilebilir.

Puppeteer’ın konumu şöyle:

ÖzellikPuppeteerSelenium
Dil/APIJavaScript/Node.js, modern async APIBirçok dil, ancak genellikle daha uzun yazım
Tarayıcı desteğiChrome/Chromium (şimdi bazı Firefox desteği)Chrome, Firefox, Safari, Edge vb.
Headless modVarsayılan, kullanımı çok kolayDesteklenir, ancak kurulum daha zor olabilir
Hız ve kararlılıkHızlı, Chrome otomasyonu için stabilBazen daha yavaş, zaman zaman hataya açık
KurulumBasit (npm install puppeteer)Tarayıcı sürücüleri ve daha fazla yapılandırma gerekir
En uygun kullanım alanıJS ağırlıklı siteler, kazıma, Chrome otomasyonuÇapraz tarayıcı testleri, eski iş akışları

Bu neden önemli?
Modern e-ticaret sitelerini kazıyorsan, panoları otomatikleştiriyorsan veya React ya da Vue ile geliştirilmiş uygulamalarda test çalıştırıyorsan, Puppeteer’ın Chrome ile doğrudan entegrasyonu işleri daha hızlı ve daha güvenilir hale getirir. Selenium hâlâ çoklu tarayıcı testi için harikadır; ancak çoğu iş otomasyonu senaryosunda tercih edilen araç Puppeteer’dır.

Headless Tarayıcı Nedir?

Headless tarayıcılar, yüzü olmayan tarayıcılardır — pencere yok, grafik yok, sadece ham hız. Peki neden headless mod kullanılır?

  • Hız: Grafik render etmesi gerekmez, bu yüzden işler daha çabuk tamamlanır.
  • Verimlilik: Daha az bellek ve CPU kullanır — bulutta çok sayıda otomasyon çalıştırmak için idealdir.
  • Kararlılık: Scriptlerini bozabilecek pop-up’lar veya pencere odak sorunları olmaz.
  • Otomasyon hatları için ideal: Testleri veya kazıyıcıları sunucularda, CI/CD süreçlerinde ya da monitörü olmayan eski laptop’larda bile çalıştırabilirsin.

Örneğin bir pazarlama ekibi, her sabah 100 açılış sayfasının ekran görüntülerini almak için Puppeteer’ı headless modda kullanabilir — kimsenin izlemesine gerek kalmaz ve sonuçlar kimse giriş yapmadan önce hazır olur (BrowserStack).

JavaScript Ekosisteminde Puppeteer: Geliştiriciler İçin Güçlü Bir Araç

Puppeteer, modern JavaScript yığınına kusursuz şekilde oturur. Geliştiricilerin onu sevmesinin nedenleri:

  • Sadece Node.js kodudur — diğer scriptlerle, API’lerle veya veritabanlarıyla kolayca entegre edilir.
  • Sürüm kontrolüne alınabilir, zamanlanabilir ve Node.js’in çalıştığı her yerde çalıştırılabilir.
  • Esnektir: veri kazıyabilir, iş akışlarını otomatikleştirebilir, PDF üretebilir veya uçtan uca testler çalıştırabilir.

İş örneği:
Bir e-ticaret analiz şirketi, her gün düzinelerce perakendeci sitesinden ürün fiyatlarını çekmek için Puppeteer kullanıyor. Bu veriler panolarına akıyor ve müşterilere, bu sitelerin API sunmadığı durumlarda bile güncel rekabet içgörüleri sağlıyor (mfi.engineering).

Geliştirici olmayanlar da fayda sağlar:
Birçok SaaS aracı ve şirket içi pano, arka planda Puppeteer kullanır. LinkedIn verisi çekmek, fiyat izlemek veya raporları otomatikleştirmek için bir araç kullanıyorsan, kodu hiç görmesen bile büyük ihtimalle işin ağır kısmını Puppeteer yapıyordur.

Puppeteer Kullanırken Karşılaşılabilecek Zorluklar ve Dikkat Edilmesi Gerekenler

Puppeteer güçlüdür, ancak her zaman tak-çalıştır değildir — özellikle geliştirici değilsen. Dikkat etmen gereken birkaç nokta var:

  • Kurulum: Node.js kurulu olmalı ve temel komut satırı becerilerine ihtiyaç duyarsın.
  • Kod gerekir: Puppeteer scriptleri JavaScript ile yazılır. Kod konusunda rahat değilsen öğrenme eğrisi olabilir.
  • Bakım: Siteler değişir. Bir web sitesi tasarımını güncellerse scriptin bozulabilir ve düzeltme gerektirebilir.
  • Bot engelleri: Bazı siteler otomasyon araçlarını engeller. CAPTCHA’lar, gecikmeler veya dönen proxy’lerle uğraşmak zorlaşabilir.
  • Hata ayıklama: Bir şey ters giderse hata mesajlarını okuman, kodu ince ayar yapman ve gerekirse tarayıcıyı headed modda çalıştırarak ne olduğunu görmen gerekir.

Ama endişelenme — harika kaynaklar var:

Başlangıç seviyesindeysen, haber sitesinden başlık çekmek veya giriş sürecini otomatikleştirmek gibi küçük projelerle başla. Temelleri kısa sürede kaparsın.

Thunderbit ve Puppeteer: Gelişmiş Otomasyonu Herkes İçin Erişilebilir Hale Getirmek

Herhangi bir web sitesinden AI ile veri çekin Get Started Free

İşte burada heyecanlanıyorum — çünkü Thunderbit’te çözmeyi hedeflediğimiz sorun tam olarak bu. Thunderbit, AI destekli bir web kazıma Chrome Eklentisidir ve Puppeteer benzeri otomasyonu sadece geliştiricilere değil, herkese sunar.

Thunderbit sana nasıl yardımcı olur?

  • Kod gerekmez: Sadece Thunderbit Chrome Eklentisi yükle, bir site aç ve AI’nin hangi verilerin çıkarılacağını önermesine izin ver.
  • AI alan önerileri: “AI Suggest Fields” butonuna tıkla; Thunderbit sayfayı okur, “Ürün Adı”, “Fiyat” veya “E-posta” gibi sütunları önerir ve her şeyi senin için kurar.
  • Alt sayfa ve sayfalama kazıma: Thunderbit, alt sayfalara otomatik tıklayabilir (örneğin ürün detayları) ve çok sayfalı listeleri işleyebilir — döngü ya da kod gerekmez.
  • Anında dışa aktarma: Verilerini tek tıkla Google Sheets, Excel, Notion veya Airtable’a gönder.
  • Zamanlanmış kazıma: Kazımaları günlük, haftalık ya da ihtiyaç duyduğun herhangi bir sıklıkta çalışacak şekilde ayarla.
  • Veri zenginleştirme: Dahili AI araçlarıyla verileri kazırken özetle, kategorilere ayır veya çevir.

Puppeteer yerine Thunderbit’i ne zaman kullanmalısın?

  • Geliştirici değilsen ya da hızlıca sonuç almak istiyorsan.
  • Satış, pazarlama veya araştırma için veri toplaman gerekiyor ancak kod yazmak ve bakım yapmak istemiyorsan.
  • Verileri JSON veya CSV dosyalarıyla uğraşmadan doğrudan iş araçlarına aktarmak istiyorsan.
  • Web sitesi değişikliklerinin scriptlerini bozmasıyla uğraşmak istemiyorsan — Thunderbit’in AI’si otomatik uyum sağlar.

Kod Gerektirmeyen Web Kazıma için Thunderbit’i Deneyin

Adım adım: Puppeteer tarzı bir görev için Thunderbit kullanımı

  1. Thunderbit Chrome Eklentisi yükle.
  2. Hedef sitene git (örneğin bir e-ticaret ürün listesi).
  3. Thunderbit simgesine tıkla, ardından “AI Suggest Fields” seçeneğini kullan.
  4. Önerilen sütunları incele ve gerekirse düzenle.
  5. “Scrape” butonuna tıkla. Thunderbit veriyi toplar, gerekirse alt sayfaları da takip eder.
  6. Sonuçları Google Sheets, Notion veya Excel’e aktar — analiz veya paylaşım için hazır hale gelsin.

Çoğu iş kullanıcısı için bu, Puppeteer scriptleri yazıp hata ayıklamaya kıyasla büyük bir zaman tasarrufu sağlar. İleride ölçek büyütmek veya daha fazla özelleştirmek istersen, özel bir Puppeteer çözümü için her zaman bir geliştiriciye geçiş yapabilirsin.

Puppeteer ile Başlamak: Kaynaklar ve Sonraki Adımlar

Başlamaya hazır mısın? İşte yol haritan:

Kod yazmadan tarayıcı otomasyonunu denemek istiyorsan, Thunderbit’in ücretsiz planı harika bir başlangıç noktasıdır.

Sonuç: İş Otomasyonunda Puppeteer’ın Gücünü Açığa Çıkarma

Veri Kazıma Nedir ve 2025’te Nasıl Yapılır? Get Started Free

Puppeteer, tarayıcı otomasyonunda tam bir güç merkezi — web görevlerini otomatikleştirmeni, veri çekmeni ve siteleri hassasiyetle, hızlı şekilde test etmeni sağlar. Geliştiriciler için vazgeçilmez bir araç haline geldi; ancak Thunderbit gibi araçlar sayesinde artık sunduğu faydalar herkesin erişebileceği durumda.

İster ilk script’ini yazmaya hazır bir geliştirici ol, ister JavaScript öğrenmeden veriyi bir tabloya aktarmak isteyen bir iş kullanıcısı, tarayıcı otomasyonunu benimsemek için hiç bugünden daha iyi bir zaman olmamıştı. Web fırsatlarla dolu — neden tekrar eden işleri bir robota bırakmayasın?

Thunderbit AI ile Veri Çekin

SSS

1. Puppeteer basitçe nedir?
Puppeteer, Chrome veya Chromium tarayıcılarını kodla kontrol etmeni sağlayan bir araçtır. Tıklama, form doldurma, veri çekme ve ekran görüntüsü alma gibi web görevlerini manuel işlem yapmadan otomatikleştirebilirsin.

2. Puppeteer’da headless ve headed mod arasındaki fark nedir?
Headless mod tarayıcıyı arka planda çalıştırır (pencere açılmaz), bu da onu daha hızlı ve verimli hale getirir. Headed mod ise görünür bir tarayıcı penceresi açar; bu da hata ayıklamak veya otomasyonu izlemek için kullanışlıdır.

3. Puppeteer, Selenium ile nasıl karşılaştırılır?
Puppeteer, Chrome/Chromium’a odaklanır ve JavaScript kullanır; bu da onu modern web uygulamalarında daha hızlı ve daha kararlı hale getirir. Selenium daha fazla tarayıcı ve dili destekler, ancak kurulumu daha yavaş ve daha karmaşık olabilir.

4. Puppeteer kullanmak için kod bilmeli miyim?
Evet, Puppeteer scriptleri JavaScript ile yazılır. Kod yazmak sana uygun değilse, benzer sonuçlar için Thunderbit gibi kodsuz bir araç kullanmayı düşünebilirsin.

5. Puppeteer öğrenmek için başlangıç dostu kaynaklar nelerdir?
Resmî dokümanlarla başla, YouTube eğitimlerine göz at ve kodsuz alternatifler ile web otomasyonu ipuçları için Thunderbit Blog içeriklerini incele.

Web iş akışlarını otomatikleştirmeye hazır mısın? Geliştiriciysen Puppeteer’ı dene — ya da kodsuz, AI destekli bir deneyim için Thunderbit’i indir. Gelecekteki sen ve kahven sana teşekkür edecek.

AI Web Kazıyıcıyı Deneyin Get Started Free

Shuai Guan
Shuai Guan
Thunderbit CEO’su | AI Veri Otomasyonu Uzmanı Shuai Guan, Thunderbit’in CEO’su ve University of Michigan Mühendislik mezunudur. Teknoloji ve SaaS mimarisi alanındaki yaklaşık on yıllık deneyiminden güç alarak, karmaşık yapay zeka modellerini pratik, kod yazmadan kullanılabilen veri çıkarma araçlarına dönüştürme konusunda uzmanlaşmıştır. Bu blogda, daha akıllı ve veriye dayalı iş akışları kurmanıza yardımcı olmak için web kazıma ve otomasyon stratejileri üzerine filtresiz, sahada sınanmış içgörüler paylaşıyor. Veri iş akışlarını optimize etmediği zamanlarda ise aynı detay odaklı yaklaşımını fotoğrafçılık tutkusuna da yansıtıyor.
Topics
Puppeteer
İçindekiler

Sadece sorarak bir web sayfasını çek

Ne istediğini düz İngilizceyle söyle. Hatta daha iyisi, hiçbir şey söyleme.

Thunderbit’i dene ücretsiz
Yapay Zeka ile Veri Çıkar
Verileri Google Sheets, Airtable veya Notion’a kolayca aktar
Chrome Store Rating
PRODUCT HUNT#1 Product of the Week