eksisozluk-scraper 1.1.0

Ekşi Sözlük Scraper - AI-friendly output üreten terminal tabanlı scraper

eksisozluk-scraper

Terminal tabanlı Ekşi Sözlük scraper'ı. Çıktısı AI-friendly formatlarda: JSON (varsayılan), CSV ve Markdown.

Cursor (yapay zeka) ile yazılmıştır.

Özellikler

• ✅ Terminal tabanlı CLI arayüzü
• ✅ Tab completion desteği (bash/zsh/fish)
• ✅ Çoklu çıktı formatı desteği (JSON, CSV, Markdown)
• ✅ Format otomatik tespiti (dosya uzantısından)
• ✅ Başlık bazlı tüm entry scraping
• ✅ Zaman aralığına göre filtreleme (gün/hafta/ay/yıl)
• ✅ Spesifik entry'den itibaren scraping
• ✅ Rate limiting
• ✅ Hata durumunda otomatik retry mekanizması

Kurulum

Pip ile Kurulum (Önerilen)

PyPI'den kurulum:

pip install eksisozluk-scraper

Python paketi olarak kurulum yapmak için:

# GitHub'dan direkt kurulum
pip install git+https://github.com/erenseymen/eksisozluk-scraper.git

Diğer Paket Formatları

Alternatif metod: Python Script Olarak Çalıştırma

Python scriptini doğrudan çalıştırabilirsiniz:

# Repoyu klonla
git clone https://github.com/erenseymen/eksisozluk-scraper.git
cd eksisozluk-scraper

# Bağımlılıkları kur
pip3 install -r requirements.txt

# Scripti çalıştır
python3 eksisozluk_scraper.py "başlık adı"

Kullanım

Temel Kullanım

# Başlıktaki tüm entry'leri scrape et
eksisozluk-scraper "başlık adı"

Zaman Filtreleme

# Son 1 günlük entry'ler
eksisozluk-scraper "başlık adı" --days 1

# Son 2 haftalık entry'ler
eksisozluk-scraper "başlık adı" --weeks 2

# Son 1 aylık entry'ler
eksisozluk-scraper "başlık adı" --months 1

# Son 1 yıllık entry'ler
eksisozluk-scraper "başlık adı" --years 1

Maksimum Entry Sayısı

# Maksimum 100 entry scrape et
eksisozluk-scraper "başlık adı" --max-entries 100

Belirli Entry'den İtibaren Scrape Etme

eksisozluk-scraper "https://eksisozluk.com/entry/entry-id"

Çıktıyı Dosyaya Kaydetme

Scraper, çıktı formatını dosya uzantısından otomatik olarak tespit eder:

# JSON formatı (varsayılan)
eksisozluk-scraper "başlık adı" --output sonuclar.json

# CSV formatı
eksisozluk-scraper "başlık adı" --output sonuclar.csv

# Markdown formatı
eksisozluk-scraper "başlık adı" --output sonuclar.md
# veya
eksisozluk-scraper "başlık adı" --output sonuclar.markdown

Gelişmiş Parametreler

# Request'ler arası bekleme süresi (varsayılan: 1.5 saniye)
eksisozluk-scraper "başlık adı" --delay 2.0

# Maksimum retry sayısı (varsayılan: 3)
eksisozluk-scraper "başlık adı" --max-retries 5

# Retry arası bekleme (varsayılan: 5.0 saniye)
eksisozluk-scraper "başlık adı" --retry-delay 10.0

# Referans edilen entry'leri fetch etme (varsayılan: True)
eksisozluk-scraper "başlık adı" --no-bkz

Notlar

• Scraper, Ekşi Sözlük'e aşırı yük bindirmemek için her request arasında varsayılan 1.5 saniye bekler.
• Hata durumlarında otomatik olarak belirli aralıklarla tekrar dener.