🚀 YÖK Akademik

📌 Proje Hakkında

YÖK Akademik, Yükseköğretim Kurulu (YÖK) Akademik Arama platformunda (akademik.yok.gov.tr) yer alan tüm akademisyen kadrolarını, makaleleri (SCI/SSCI/TR Dizin/Quartile Q1-Q4), bildirileri, kitapları, patentleri, TÜBİTAK/BAP projelerini, yönetilen tezleri, dersleri ve dış indeks bilgilerini (ORCID, Scopus ID, WoS ID) doğrudan YÖK Akademik sunucusuna bağlanarak filtreleyip Excel (.xlsx), CSV, JSON ve SQLite formatlarında dışa aktarabilen yeni nesil bir veri kazıma ve araştırma motorudur.

Bu repo; Claude Desktop, Cursor, Windsurf, LangChain, CrewAI, AutoGen ve özel LLM botlarının doğrudan bağlanıp arka planda serbest doğal dil komutlarıyla veri çekebileceği resmi Model Context Protocol (MCP) sunucusu ve yüksek seviyeli Python kütüphanesi olarak tasarlanmıştır.

✨ Öne Çıkan Özellikler

• 🤖 Yapay Zeka & MCP Entegrasyonu: Claude Desktop, Cursor ve LLM Agent'ları için tak-çalıştır standart JSON-RPC Model Context Protocol (MCP) sunucusu.
• 🐍 Tek Satır Python AI API: LangChain, CrewAI ve Python botlarında YokAkademik().search() ve get_profile() ile sıfır konfigürasyon.
• 🏛️ 207 Üniversite & Canlı Dinamik Birim Keşfi: Statik listelere bağımlı kalmadan, üniversite bünyesindeki tüm güncel fakülte, MYO ve anabilim dallarını YÖK'ten anlık sorgulama.
• 📊 Tüm Eser ve Faaliyet Sekmeleri: Kadro & Künye, ORCID/Scopus/WoS ID, Makaleler, Bildiriler, Kitaplar, TÜBİTAK/BAP Projeleri, Yönetilen Tezler, Patentler.
• 💾 Çoklu Dışa Aktarma: Tek komutla Excel (.xlsx), CSV (.csv), JSON (.json) ve SQLite (.db) çıktıları.
• ⚡ Said Sürücü Standartlarında Dual-Engine: HTTP/2 tabanlı hızlı HTTPX istemcisi ve gerektiğinde dinamik JavaScript sayfaları için Playwright Chromium desteği.

📦 Kurulum

# 1. Depoyu klonlayın
git clone https://github.com/rasitnarcicek/yok-akademik.git
cd yok-akademik

# 2. Bağımlılıkları yükleyin
pip install -r requirements.txt

⚡ Kullanım Yolları

🤖 1. Yapay Zeka (AI Agent & MCP Sunucusu)

Claude Desktop, Cursor veya Windsurf'e aracı bağlamak için claude_desktop_config.json dosyasına ekleyin:

{
  "mcpServers": {
    "yok-akademik": {
      "command": "python",
      "args": ["C:\\...\\yok_akademik\\main.py", "mcp"]
    }
  }
}

Claude veya Cursor'a doğrudan doğal dille talimat verin:

"Boğaziçi ve ODTÜ bilgisayar mühendisliğindeki doçentlerin yapay zeka alanındaki makalelerini çek ve Excel olarak kaydet."

Detaylı AI entegrasyon kılavuzu için AI_INTEGRATION.md dosyasına bakınız.

🐍 2. Python AI Kütüphanesi (YokAkademik)

from yok_akademik import YokAkademik

yok = YokAkademik()

# Canlı akademisyen arama
results = yok.search("Yapay Zeka", universities=["Boğaziçi Üniversitesi"], titles=["Prof. Dr."], limit=50)

# Tekil profilin tüm yayın ve projelerini çekme
profile = yok.get_profile("100123")

# Excel ve JSON olarak dışa aktarma
yok.export(results, formats=["xlsx", "json"], prefix="YapayZeka_Prof")

💻 3. Komut Satırı (CLI) & JSON Modu

# Canlı arama yapıp Excel tablosu oluşturma
python main.py search "Boğaziçi Bilgisayar" --format xlsx --limit 200

# Yapay zeka ve otomasyonlar için saf JSON çıktısı alma
python main.py search "Fizik Prof. Dr." --json

# Tekil profilin tüm sekmelerini çekme
python main.py profile "100123" --format xlsx

📄 Lisans

Bu proje MIT Lisansı ile lisanslanmıştır. Detaylar için LICENSE dosyasına bakınız.
Geliştirici: Mehmet Raşit Narçiçek