🔍 Upwork İlan Analiz Asistanı

Upwork iş ilanlarını Gemini AI ile otomatik analiz eden profesyonel Chrome eklentisi

🌟 Overview

Upwork İlan Analiz Asistanı, Upwork üzerinde yayınlanan iş ilanlarını Gemini AI teknolojisi ile otomatik olarak analiz eden, freelancerların hangi ilanlara teklif vermeleri gerektiğini belirlemelerine yardımcı olan profesyonel bir Chrome eklentisidir.

Bu eklenti, Upwork'ta başarılı olmak isteyen freelancerlar için zaman kazandıran ve karar verme sürecini kolaylaştıran bir araçtır.

✨ Özellikler

• 🤖 AI Destekli Analiz: Gemini 2.0 Flash ile güçlü iş ilanı analizi
• 🇹🇷 Türkçe Destek: Tamamen Türkçe arayüz ve analiz sonuçları
• ⚡ Otomatik Tarama: Upwork sayfalarında otomatik ilan tespit ve analiz
• 📊 Detaylı Raporlar: Her ilan için kapsamlı analiz ve öneriler
• 🎯 Akıllı Filtreleme: Kişiselleştirilmiş ilan filtreleme kriterleri
• 💾 Veri Saklama: Analiz geçmişi ve istatistik takibi
• 🔔 Bildirimler: Önemli ilanlar için anlık bildirimler
• ⚙️ Gelişmiş Ayarlar: Detaylı konfigürasyon seçenekleri

📋 Analiz Kriterleri

Her ilan için aşağıdaki kriterlerde detaylı analiz:

1. 📝 Proje Nedir: İş tanımının detaylı açıklaması
2. 🛠️ Nasıl Yapılır: Proje gerçekleştirme adımları
3. 💡 Teklif Verilmeli Mi: Uygunluk değerlendirmesi (EVET/HAYIR/KARARSIZ)
4. ⚠️ Dikkat Edilecekler: Risk ve fırsat analizi
5. 💰 Talep Edilecekler: Bütçe ve şart önerileri

🚀 Kurulum

Gereksinimler

• Google Chrome tarayıcısı (v88+)
• Gemini AI API anahtarı (ücretsiz)
• Upwork hesabı

Adım 1: Eklentiyi Yükle

1. Bu repoyu klonlayın veya ZIP olarak indirin:

   git clone https://github.com/gkhantyln/chUpworkAI.git
   cd chUpworkAI

2. Chrome'da Extensions sayfasını açın:

   • chrome://extensions/ adresine gidin
   • Sağ üst köşeden "Developer mode" seçeneğini aktifleştirin

3. "Load unpacked" butonuna tıklayıp proje klasörünü seçin

Adım 2: Eklenti İkonlarını Oluştur

1. assets/icon-generator.html dosyasını tarayıcıda açın
2. "Generate All Icons" butonuna tıklayın
3. İndirilen ikonları assets/icons/ klasörüne yerleştirin

Adım 3: API Anahtarını Ayarla

1. Eklenti ikonuna tıklayıp "Ayarlar" butonuna basın
2. Google AI Studio'dan ücretsiz API anahtarı alın
3. API anahtarını "Gemini API Anahtarı" alanına yapıştırın
4. "Ayarları Kaydet" butonuna tıklayın

📖 Kullanım

Temel Kullanım

1. Upwork'e Git: https://www.upwork.com/nx/find-work sayfasını açın
2. Analizi Başlat: Eklenti popup'ında "Analizi Başlat" butonuna tıklayın
3. Sonuçları İncele: Analiz tamamlandığında sonuçları "İlanlar" ve "Son Analiz" sekmelerinde görüntüleyin

Gelişmiş Ayarlar

🤖 Yapay Zeka Ayarları

• API Anahtarı: Gemini AI API anahtarınız
• Analiz Dili: Türkçe/İngilizce seçimi
• Analiz Derinliği: Hızlı/Detaylı/Kapsamlı seçenekleri

🔍 Analiz Ayarları

• Maksimum İlan Sayısı: Bir seferde analiz edilecek ilan limiti (1-50)
• Analizler Arası Bekleme: API rate limiting için gecikme süresi
• Otomatik Başlatma: Sayfa yüklendiğinde otomatik analiz

🎯 Filtre Ayarları

• Minimum/Maksimum Bütçe: Bütçe aralığı filtreleme
• Tercih Edilen Beceriler: Belirli becerileri önceliklendirme
• Müşteri Filtreleri: Doğrulanmış müşteriler, ödeme geçmişi

🔔 Bildirim Ayarları

• Masaüstü Bildirimleri: Önemli ilanlar için anlık bildirim
• Ses Uyarıları: Sesli uyarı seçenekleri
• Bildirim Eşiği: Hangi skorun üzerindeki ilanlar için bildirim

🛠️ Teknik Detaylar

Dosya Yapısı

chUpworkAI/
├── manifest.json              # Eklenti yapılandırması
├── popup/                     # Ana arayüz
│   ├── popup.html            
│   ├── popup.js              
│   └── popup.css             
├── content/                   # Sayfa etkileşimi
│   ├── content.js            
│   ├── upwork-scraper.js     
│   └── content.css           
├── background/                # Arka plan işlemleri
│   └── service-worker.js     
├── options/                   # Ayarlar sayfası
│   ├── options.html          
│   ├── options.js            
│   └── options.css           
├── storage/                   # Veri yönetimi
│   └── storage-manager.js    
├── ai/                        # AI entegrasyonu
│   └── gemini-api.js         
├── utils/                     # Yardımcı araçlar
│   └── error-handler.js      
└── assets/                    # Görsel varlıklar
    ├── icons/                
    ├── icon-generator.html   
    └── generate-icons.js     

Kullanılan Teknolojiler

• Chrome Extensions Manifest V3: Modern eklenti standardı
• Gemini 2.0 Flash API: Google'ın son AI modeli
• JavaScript ES2022: Modern JavaScript özellikleri
• CSS Grid & Flexbox: Responsive tasarım
• Chrome Storage API: Güvenli veri saklama
• Service Workers: Arka plan işlemleri

API Kullanımı

Eklenti Google Gemini API'sini kullanır:

• Model: gemini-2.0-flash-exp
• Rate Limiting: İstekler arası otomatik gecikme
• Retry Logic: Hata durumunda otomatik yeniden deneme
• Error Handling: Kapsamlı hata yönetimi

🔧 Geliştirme

Geliştirme Ortamı Kurulumu

1. Projeyi klonlayın:

   git clone https://github.com/gkhantyln/chUpworkAI.git
   cd chUpworkAI

2. Geliştirme modunu aktif edin:

   • Chrome Extensions sayfasında "Developer mode" açın
   • Eklentiyi "Load unpacked" ile yükleyin

3. Debug modunu aktifleştirin:

   • Ayarlar > Gelişmiş > Debug modu ✓

Test Etme

1. Manuel Test:

   • Upwork test sayfasında eklentiyi çalıştırın
   • Console loglarını kontrol edin
   • Farklı ilan türleriyle test edin

2. API Test:

   • Ayarlar sayfasında "API Test Et" butonunu kullanın
   • Farklı API anahtarlarıyla test edin

3. Hata Takibi:

   • Developer Tools > Console
   • Chrome Extensions > Errors
   • Eklenti ayarlarında hata logları

Katkıda Bulunma

1. Fork yapın
2. Yeni branch oluşturun (git checkout -b feature/amazing-feature)
3. Değişikliklerinizi commit edin (git commit -m 'Add amazing feature')
4. Branch'inizi push edin (git push origin feature/amazing-feature)
5. Pull Request oluşturun

📊 Performans

• Analiz Hızı: İlan başına ortalama 3-5 saniye
• Bellek Kullanımı: ~10-15MB ortalama
• API Maliyeti: Günde 100 ilan için ~$0.01
• Veri Depolama: Yerel Chrome storage (~5MB limit)

🔒 Gizlilik ve Güvenlik

• ✅ API anahtarları güvenli şekilde saklanır
• ✅ Kişisel veriler yerel olarak tutulur
• ✅ Upwork şifreleri hiç erişilmez
• ✅ Anonim kullanım istatistikleri (isteğe bağlı)
• ✅ Açık kaynak ve şeffaf kod

❓ Sık Sorulan Sorular

Q: Eklenti ücretsiz mi?

A: Evet, eklenti tamamen ücretsizdir. Sadece Gemini API kullanımı için Google'dan küçük bir ücret alınır (aylık $5 kredi ücretsiz).

Q: Upwork'ün ToS'una aykırı mı?

A: Eklenti sadece herkese açık bilgileri okur ve analiz eder. Hiçbir veri çalmaz veya otomatik başvuru yapmaz.

Q: API anahtarım güvenli mi?

A: API anahtarınız sadece kendi bilgisayarınızda saklanır ve hiçbir sunucuya gönderilmez.

Q: Hangi dillerde çalışır?

A: Şu anda Türkçe ve İngilizce desteklenmektedir. Daha fazla dil desteği gelecek güncellemelerde eklenecek.

Q: Mobil cihazlarda çalışır mı?

A: Hayır, bu bir Chrome eklentisidir ve sadece masaüstü Chrome tarayıcısında çalışır.

🐛 Bilinen Sorunlar

• Bazı dinamik yüklenen ilanlar atlanabilir
• Çok yüksek ilan sayılarında performans düşüşü
• Upwork sayfa değişikliklerinde scraper güncellemesi gerekebilir

🗺️ Roadmap

v1.1.0 (Yakında)

• Batch analiz iyileştirmeleri
• Daha detaylı filtre seçenekleri
• Export/import özelliği
• Analytics dashboard

v1.2.0 (Gelecek)

• Freelancer.com desteği
• Telegram bot entegrasyonu
• ML-based job scoring
• Browser sync

v2.0.0 (Uzun vadeli)

• SaaS platform
• Team collaboration
• API for third-party integrations
• Mobile app

📞 Destek

• Email: tylngkhn@outlook.com
• Issues: GitHub Issues

📜 Lisans

Bu proje MIT Lisansı altında lisanslanmıştır.

🙏 Teşekkürler

• Google Gemini AI - Güçlü AI analiz altyapısı
• Upwork - Platform sağladığı için
• Tüm beta testerler ve katkıda bulunanlar

---

⭐ Bu projeyi beğendiyseniz star vermeyi unutmayın!

Made with ❤️ for Upwork freelancers in Turkey