---
name: kap_nlp_extractor
description: "Kamu Aydınlatma Platformu (KAP) üzerinden Türkçe kurumsal duyuruları çeker ve duygu (sentiment) ile lot/fiyat gibi finansal metrikleri çıkartır."
---

# KAP NLP Extractor Skill

Bu yetenek, Kamu Aydınlatma Platformu (KAP) duyurularından anlamsal ve nicel veriler çekerek finansal analiz motorlarına girdi hazırlar.

## Yetenek İşlevleri

1. **Duyuru Çekme (`KAPScraper`):**
   - Canlı API (`https://www.kap.org.tr/tr/api/disclosures`) bağlantısı ile güncel duyuruları çeker.
   - Bağlantı kesintilerinde simüle edilmiş zengin Türkçe kurumsal bildirim akışına (Geri Alım, İçsel İşlem, Bilanço) geri çekilir (Fallback).

2. **NLP Duygu ve Öznitelik Çıkarımı (`TurkishFinBERTProcessor`):**
   - Türkçe finansal metinlerde ince ayar yapılmış **FinBERT** (`savasy/bert-base-turkish-sentiment`) ile asimetrik duygu analizi koşturarak sentiment puanı üretir ($[-1.0, 1.0]$).
   - Lot adetleri, ortalama işlem fiyatları ve yüzde değişim verilerini karmaşık Türkçe yazım kuralları altından hatasız parse eder.
   - Kurumsal hareketin tipine ve duygu yoğunluğuna bağlı olarak **Portföy Güven Katkısı** hesaplar.

## Ajanlar İçin Kullanım Talimatı

KAP haberlerinden gelen veriyi işlemek ve veri tabanına yazmak için `parser.py` modülü içindeki `KAPScraper` ve `TurkishFinBERTProcessor` sınıfları instantiate edilmelidir:

```python
from skills.kap_nlp_extractor.parser import KAPScraper, TurkishFinBERTProcessor

# 1. Scraper ve Processor başlat
scraper = KAPScraper(use_live_api=False)
processor = TurkishFinBERTProcessor()

# 2. Duyuruları çek ve işle
raw_disclosures = scraper.fetch_disclosures()
for disclosure in raw_disclosures:
    processed_data = processor.parse_announcement(disclosure)
    print(processed_data)
```