🚀 İŞKUR İlan Scraper - Email Bildirimi

Türkiye İŞKUR (İş ve İşçi Bulma Kurumu) sisteminden otomatik olarak iş ilanlarını çeken ve email ile bildirim gönderen Apify Actor'ü.

✨ Özellikler

• 🔐 Güvenli Giriş: Kendi İŞKUR hesap bilgilerinizle otomatik giriş
• 📧 Email Bildirimleri: Modern HTML formatında email bildirimleri (Yandex, Gmail, Outlook, Yahoo)
• 🔗 Detay Linkleri: Her ilan için direkt İŞKUR detay sayfası linki
• 🔄 Periyodik Çalışma: Apify Scheduler ile otomatik güncellemeler
• 🎯 Filtreleme: İşyeri türü, il, tarih ve özel kelime filtreleri
• 📊 Çoklu İlan Türü: Normal, IUP ve TYP ilanları desteklenir
• 🚫 Kelime Filtresi: İstenmeyen lokasyonları filtrele (örn: KADİRLİ, DÜZCE)

🚀 Hızlı Başlangıç

3 basit adımda başlayın:

1. Email Seçin: Gmail, Yandex veya Outlook
2. Input Doldurun: TC Kimlik, şifre ve email bilgileri
3. Çalıştırın: Manuel veya Scheduler ile otomatik

💡 Gmail "Uygulama Şifreleri" seçeneği görünmüyor mu? Sorun değil! Yandex veya Outlook kullanabilirsiniz (daha kolay).

📋 Gereksinimler

1. İŞKUR Hesabı: TC Kimlik No ve İŞKUR şifresi
2. Email Hesabı: Gmail, Yandex, Outlook veya Yahoo
3. Email Şifresi: Normal şifre veya App Password
4. Apify Hesabı: Actor'ü çalıştırmak için

🔧 Kurulum

1. Email Yapılandırması

Seçenek A: Gmail ile Normal Şifre (Kolay)

Eğer Gmail hesabınızda 2 Adımlı Doğrulama YOKSA:

1. Gmail adresinizi ve normal şifrenizi kullanabilirsiniz
2. Google Hesap Ayarları > Güvenlik'te "Güvenliği düşük uygulamalara izin ver" seçeneğini aktif edin
3. Input'ta gmailUser ve gmailAppPassword alanlarına bilgilerinizi girin

⚠️ Not: Bu yöntem daha az güvenlidir, önerilmez.

Seçenek B: Gmail App Password (Güvenli - Önerilen)

Eğer Gmail hesabınızda 2 Adımlı Doğrulama VARSA ve "Uygulama Şifreleri" seçeneğini görüyorsanız:

1. Google Hesabınıza gidin: https://myaccount.google.com/
2. Güvenlik > 2 Adımlı Doğrulama bölümüne gidin
3. 2 Adımlı Doğrulama'yı aktif edin (henüz aktif değilse)
4. Uygulama Şifreleri (App Passwords) bölümüne gidin
5. "Mail" ve cihazınızı seçin
6. Oluştur butonuna tıklayın
7. Gösterilen 16 haneli şifreyi kopyalayın (boşluklar olmadan)

Seçenek C: Alternatif Email Servisleri

Gmail çalışmazsa başka email servisleri kullanabilirsiniz:

Email Servisi	SMTP Host	Port	2FA Gerekli?	Kolaylık
Yandex ⭐	smtp.yandex.com	587	❌ Hayır	⭐⭐⭐⭐⭐ En Kolay
Outlook	smtp-mail.outlook.com	587	❌ Hayır	⭐⭐⭐⭐ Kolay
Gmail	smtp.gmail.com	587	✅ Evet (önerilen)	⭐⭐⭐ Orta
Yahoo	smtp.mail.yahoo.com	587	✅ Evet	⭐⭐ Zor

Önerilen: Yandex Mail - En kolay kurulum, App Password gerektirmez!

Yandex Mail:

{
  "recipientEmail": "bilgi@serdarsevimli.tr",
  "senderEmail": "gonderici@yandex.com",
  "emailPassword": "yandex-sifreniz",
  "smtpHost": "smtp.yandex.com",
  "smtpPort": 587
}

Outlook/Hotmail:

{
  "recipientEmail": "bilgi@serdarsevimli.tr",
  "senderEmail": "gonderici@outlook.com",
  "emailPassword": "outlook-sifreniz",
  "smtpHost": "smtp-mail.outlook.com",
  "smtpPort": 587
}

Yahoo Mail:

{
  "recipientEmail": "bilgi@serdarsevimli.tr",
  "senderEmail": "gonderici@yahoo.com",
  "emailPassword": "yahoo-app-password",
  "smtpHost": "smtp.mail.yahoo.com",
  "smtpPort": 587
}

2. Apify'da Actor'ü Çalıştırma

1. Apify Console'da bu Actor'ü açın
2. Input sekmesine gidin
3. Gerekli bilgileri doldurun:

Yandex Mail ile (Önerilen):

{
  "tcKimlikNo": "12345678901",
  "sifre": "iskur-sifreniz",
  "recipientEmail": "bilgi@serdarsevimli.tr",
  "senderEmail": "gonderici@yandex.com",
  "emailPassword": "yandex-sifreniz",
  "smtpHost": "smtp.yandex.com",
  "smtpPort": 587,
  "isyeriTuru": "ozel",
  "il": "OSMANİYE",
  "ilanTarihi": "3",
  "ilanTuru": "hepsi",
  "excludedKeywords": ["KADİRLİ", "DÜZCE"]
}

Gmail ile:

{
  "tcKimlikNo": "12345678901",
  "sifre": "iskur-sifreniz",
  "recipientEmail": "bilgi@serdarsevimli.tr",
  "senderEmail": "gonderici@gmail.com",
  "emailPassword": "gmail-app-password",
  "smtpHost": "smtp.gmail.com",
  "smtpPort": 587,
  "il": "OSMANİYE",
  "excludedKeywords": []
}

4. Start butonuna tıklayın

⏰ Periyodik Çalışma (Scheduler) Kurulumu

Actor'ü otomatik olarak periyodik çalıştırmak için Apify Scheduler kullanın:

1. Apify Console'da Schedules > Create Schedule butonuna tıklayın

2. Schedule ayarlarını yapın:

   • Name: "İŞKUR İlan Günlük Kontrol" (veya istediğiniz isim)
   • Actor: Bu Actor'ü seçin
   • Cron Expression:
     • Her gün saat 09:00'da: 0 9 * * *
     • Her gün 09:00 ve 17:00'da: 0 9,17 * * *
     • Pazartesi ve Cuma 17:00'da: 0 17 * * 1,5
     • Her 6 saatte bir: 0 */6 * * *

3. Input: Actor input ayarlarınızı kaydedin

4. Create Schedule ile kaydedin

Cron Expression Örnekleri

Açıklama	Cron Expression
Her gün saat 09:00	0 9 * * *
Her gün 09:00 ve 17:00	0 9,17 * * *
Hafta içi her gün 08:00	0 8 * * 1-5
Her 3 saatte bir	0 */3 * * *
Her Pazartesi 09:00	0 9 * * 1

📊 Input Parametreleri

Zorunlu Parametreler

• tcKimlikNo (string): İŞKUR hesabınızın TC Kimlik Numarası
• sifre (string): İŞKUR hesabınızın şifresi
• recipientEmail (string): İlan bildirimlerinin gönderileceği email adresi
• senderEmail (string): Email gönderecek email adresi (Yandex, Gmail, Outlook vb.)
• emailPassword (string): Email şifresi veya App Password

Opsiyonel Parametreler

• isyeriTuru (string): İşyeri türü - "ozel" veya "kamu" (varsayılan: "ozel")
• il (string): İş aramak istediğiniz il (varsayılan: "OSMANİYE")
• ilanTarihi (string): İlan tarihi filtresi
  • "2": Son 24 Saat
  • "3": Son 1 Hafta (varsayılan)
  • "4": Son 15 Gün
• ilanTuru (string): İlan türü
  • "normal": Normal İş İlanları
  • "iup": IUP İlanları
  • "typ": TYP İlanları
  • "hepsi": Tüm İlan Türleri (varsayılan)
• excludedKeywords (array): Dışlanacak kelimeler listesi (varsayılan: ["KADİRLİ"])
  • Çalışma yeri alanında bu kelimelerden herhangi birini içeren ilanlar filtrelenir
  • Birden fazla kelime eklenebilir: ["KADİRLİ", "DÜZCE", "ANKARA"]
  • Boş bırakılabilir: []
• smtpHost (string): SMTP sunucusu (varsayılan: "smtp.yandex.com")
• smtpPort (integer): SMTP port (varsayılan: 587)
• emailSubjectPrefix (string): Email konu başlığı ön eki (varsayılan: "İŞKUR İlan Bildirimi")

📧 Email Bildirimi Formatı

Actor çalıştığında modern HTML formatında bir email alacaksınız:

• 🎨 Modern ve responsive tasarım
• 📊 İlan özeti ve istatistikler
• 🔗 Her ilan için direkt İŞKUR detay sayfası linki (Normal ilanlar için)
• ℹ️ Filtre bilgileri ve tarih
• 📱 Mobil uyumlu görüntüleme
• 🚫 Kelime filtresine göre otomatik eleme

Email İçeriği

Normal İlanlar için:

• Meslek adı ve ilan numarası
• İşveren bilgileri (ad, tür)
• Çalışma şekli ve periyodu
• Açık pozisyon sayısı
• Çalışma yeri (il/ilçe)
• Son başvuru tarihi ve kalan süre
• Detay URL: İŞKUR sisteminde ilana direkt erişim linki

IUP İlanları için:

• İlan numarası
• İl ve başvuru yapılabilecek ilçeler
• Program nedeni
• Başlangıç ve bitiş tarihleri
• Son başvuru tarihi
• Yüklenici firma bilgisi

TYP İlanları için:

• İlan numarası
• İl ve ilçe bilgisi
• Başlangıç ve bitiş tarihleri
• Uygulama alanı
• Hizmet sağlayıcı firma

🔍 Kullanım Senaryoları

Senaryo 1: Yandex ile Günlük İlan Takibi (Önerilen)

{
  "tcKimlikNo": "12345678901",
  "sifre": "iskur-sifreniz",
  "recipientEmail": "bilgi@serdarsevimli.tr",
  "senderEmail": "gonderici@yandex.com",
  "emailPassword": "yandex-sifreniz",
  "smtpHost": "smtp.yandex.com",
  "smtpPort": 587,
  "ilanTarihi": "2",
  "ilanTuru": "hepsi",
  "excludedKeywords": ["KADİRLİ", "DÜZCE"]
}

Scheduler: Her gün sabah 09:00

Senaryo 2: Yandex Mail ile Haftalık Kamu İlanları

{
  "tcKimlikNo": "12345678901",
  "sifre": "iskur-sifreniz",
  "recipientEmail": "bilgi@serdarsevimli.tr",
  "senderEmail": "gonderici@yandex.com",
  "emailPassword": "yandex-sifreniz",
  "smtpHost": "smtp.yandex.com",
  "smtpPort": 587,
  "isyeriTuru": "kamu",
  "ilanTarihi": "3",
  "ilanTuru": "normal",
  "excludedKeywords": []
}

Scheduler: Her Pazartesi 09:00

Senaryo 3: Outlook ile Özel Sektör İlanları + Çoklu Filtre

{
  "tcKimlikNo": "12345678901",
  "sifre": "iskur-sifreniz",
  "recipientEmail": "bilgi@serdarsevimli.tr",
  "senderEmail": "gonderici@outlook.com",
  "emailPassword": "outlook-sifreniz",
  "smtpHost": "smtp-mail.outlook.com",
  "smtpPort": 587,
  "isyeriTuru": "ozel",
  "il": "ANKARA",
  "ilanTarihi": "3",
  "excludedKeywords": ["POLATLI", "ÇANKARA", "NALLİHAN"]
}

Scheduler: Her gün 09:00 ve 17:00

🛡️ Güvenlik

• TC Kimlik No, şifre ve Email şifreleri güvenli bir şekilde Apify'da saklanır
• Hassas veriler isSecret olarak işaretlenmiştir
• Email şifreleri asla loglanmaz veya gösterilmez
• TC Kimlik No logda maskelenir (örn: 123******90)

🐛 Hata Çözümleme

"Email gönderme hatası"

Çözüm 1: Gmail Güvenlik Ayarları

• 2FA yoksa: Google Hesap > Güvenlik > "Güvenliği düşük uygulamalara izin ver" seçeneğini aktif edin
• 2FA varsa: App Password kullanın

Çözüm 2: Alternatif Email Servisi Kullanın Gmail çalışmıyorsa Yandex, Outlook veya Yahoo kullanın:

{
  "recipientEmail": "bilgi@serdarsevimli.tr",
  "senderEmail": "gonderici@yandex.com",
  "emailPassword": "sifreniz",
  "smtpHost": "smtp.yandex.com",
  "smtpPort": 587
}

Çözüm 3: "Uygulama Şifreleri" Seçeneği Görünmüyorsa

• Önce 2 Adımlı Doğrulama'yı aktif edin, sonra tekrar kontrol edin
• Google Workspace hesabıysa yöneticinizle iletişime geçin
• Alternatif olarak Yandex veya Outlook kullanın (daha kolay)

"Login hatası"

• TC Kimlik No ve şifrenizi kontrol edin
• İŞKUR hesabınızın aktif olduğundan emin olun
• İŞKUR sisteminin çalıştığını kontrol edin

"İlan bulunamadı"

• Filtre kriterlerinizi genişletin
• İlan tarih aralığını artırın
• İşyeri türünü değiştirin

❓ Sık Sorulan Sorular

Gmail'de "Uygulama Şifreleri" seçeneği görünmüyor, ne yapmalıyım?

Çözüm 1: Yandex veya Outlook kullanın (önerilir - daha kolay)

{
  "recipientEmail": "bilgi@serdarsevimli.tr",
  "senderEmail": "gonderici@yandex.com",
  "emailPassword": "normal-sifreniz",
  "smtpHost": "smtp.yandex.com",
  "smtpPort": 587
}

Çözüm 2: Gmail'de 2 Adımlı Doğrulama'yı aktif edin, sonra "Uygulama Şifreleri" seçeneği görünecektir.

Hangi email servisini kullanmalıyım?

• En Kolay: Yandex Mail (App Password gerektirmez)
• Güvenli: Gmail (App Password ile)
• Alternatif: Outlook/Hotmail

Actor'ü ne sıklıkla çalıştırmalıyım?

• Günlük takip: Her gün sabah 09:00 (0 9 * * *)
• Yoğun takip: Günde 2 kez 09:00 ve 17:00 (0 9,17 * * *)
• Haftalık: Her Pazartesi 09:00 (0 9 * * 1)

Email gelmiyorsa ne yapmalıyım?

1. Spam/Gereksiz klasörünü kontrol edin
2. Email şifresinin doğru olduğundan emin olun
3. Apify Actor loglarını kontrol edin
4. Alternatif email servisi deneyin (Yandex önerilir)

Birden fazla il için çalıştırabilir miyim?

Evet! Her il için ayrı bir Schedule oluşturun:

• Schedule 1: OSMANİYE için
• Schedule 2: ANKARA için
• Schedule 3: İSTANBUL için

"Dışlanacak Kelimeler" nasıl çalışır?

Çalışma yeri alanında belirttiğiniz kelimeleri içeren ilanları filtreler:

{
  "excludedKeywords": ["KADİRLİ", "DÜZCE", "POLATLI"]
}

• Büyük/küçük harf duyarsız: "kadirli", "KADİRLİ", "Kadirli" hepsi eşleşir
• Kısmi eşleşme: "POLATLI" yazsanız "POLATLI/MERKEZ" de filtrelenir
• Boş bırakılabilir: [] tüm ilanları gösterir
• Birden fazla: İstediğiniz kadar kelime ekleyebilirsiniz
• Sadece Normal İlanlar: Bu filtre sadece normal iş ilanlarına uygulanır

Örnek Kullanım:

{
  "il": "OSMANİYE",
  "excludedKeywords": ["KADİRLİ"]
}

Osmaniye ilindeki ilanları getirir, ancak çalışma yeri "KADİRLİ" içeren ilanları hariç tutar.

Log Çıktısı:

🚫 Kelime filtresi (KADİRLİ): 45 → 38 ilan

Bu, 45 ilandan 7'sinin filtrelendiğini ve 38 ilanın kaldığını gösterir.

Güvenli mi? Bilgilerim saklanıyor mu?

• ✅ Tüm hassas veriler Apify'da şifreli saklanır
• ✅ Şifreler isSecret olarak işaretlenmiştir
• ✅ Loglar hassas bilgi içermez
• ✅ Sadece sizin erişiminiz var

🔧 Teknik Detaylar

İlan Detay URL'leri

Normal ilanlar için otomatik olarak detay URL'leri oluşturulur:

https://esube.iskur.gov.tr/Istihdam/AcikIsIlanDetay.aspx?uiID={ilanNo}&isyeriTuru={isverenTuru}

• ilanNo: İlan numarası (örn: 00009289510)
• isyeriTuru: İşveren türü (Kamu veya Ozel)

Örnek:

https://esube.iskur.gov.tr/Istihdam/AcikIsIlanDetay.aspx?uiID=00009289510&isyeriTuru=Kamu

Sayfalama ve Veri Toplama

• Normal ilanlar için otomatik sayfa gezinme
• Her sayfada 15 ilan gösterilir
• Maksimum 50 sayfa taranır
• IUP ve TYP ilanları tek sayfada listelenir

Sıralama

Normal ilanlar son başvuru tarihine göre sıralanır (en yakın tarih önce).

📞 Destek

Actor ile ilgili sorularınız için:

• Apify Community
• Apify Documentation

📄 Lisans

ISC

---

Not: Bu Actor, İŞKUR sistemini resmi kullanım şartlarına uygun şekilde kullanmaktadır. Kendi hesap bilgilerinizle giriş yaparak yasalara uygun olarak çalışır.