FSC Sertifika Liste Aracı (fsc-certificate-tool)

FSC'nin resmî arama sitesinden (search.fsc.org) güncel sertifika listesini tarayıcı olmadan çeken küçük bir Python aracı. Verilen ülkedeki geçerli FSC sertifikalarını firma adı, lisans no, sertifika kodu, rol ve ülke bilgisiyle CSV/Excel'e döker.

Özellikler

• 🔎 Filtreli liste — ülke, durum (Valid/Expired), sertifika tipi, ürün kategorisi, belgelendirme kuruluşu
• 📦 Tam çekme (fetch_all) — API tek sorguda en çok ~500 kayıt verdiği için, sonucu belgelendirme kuruluşuna göre bölüp birleştirir
• 📊 CSV / Excel çıktısı
• 🔑 Otomatik token yönetimi — siteden XSRF token + çerez alır (doğrudan API çağrısının "Forbidden" vermesini önler)

Kurulum

pip install -r requirements.txt   # requests, openpyxl

Kullanım

import fsc_cek as f

# Filtreli liste (ör. Türkiye, geçerli sertifikalar)
rows, total = f.fetch_list(country=['TURKEY'], status=['Valid'])

# Tam liste (kuruluş-bazlı bölme ile)
rows = f.fetch_all(country=['TURKEY'], status=['Valid'])

# Kaydet
f.to_csv(rows, 'fsc.csv')
f.to_excel(rows, 'fsc.xlsx')

Komut satırından

python3 fsc_cek.py

Türkiye'deki tüm geçerli FSC kayıtlarını çeker ve tarih damgalı dosyalara yazar: fsc_liste_TR_YYYY-AA-GG.csv ve fsc_liste_TR_YYYY-AA-GG.xlsx.

Çıktı Alanları

Organization, License, CertificateCode, Role, Country

Nasıl Çalışır

1. /en/search/ adresine GET → çerez + XSRF-TOKEN
2. POST /api/v1/Certification/Search → liste (sayfa başı en çok ~500; farklı sıralamalarla tamamlanır)
3. fetch_all sonucu belgelendirme kuruluşuna göre bölerek tüm kayıtlara ulaşır

Sınırlamalar & Nazik Kullanım

• Bu araç toplu liste/keşif içindir. Tekil ve resmî sertifika doğrulama için FSC'nin kendi API'si (api.fsc.org) kullanılabilir (abonelik gerektirir).
• API tek sorguda ~500 kayıt sınırı koyar; fetch_all bunu kuruluş-bazlı bölerek aşar.
• Çok sayıda hızlı istek geçici hız-sınırına (HTTP 403) yol açabilir. Araç artan beklemeyle yeniden dener; yine de istekler arasında makul boşluk bırakın.

Yasal / Etik Not

Bu araç FSC'nin herkese açık arama sayfasındaki veriyi kullanır. Çekilen verilerde firma adı gibi bilgiler bulunabilir; verileri ilgili mevzuata (KVKK/GDPR) ve FSC'nin kullanım koşullarına uygun şekilde kullanmak kullanıcının sorumluluğundadır. Resmî bir FSC ürünü değildir.

Lisans

MIT — ayrıntı için LICENSE dosyasına bakın.