KAP bildirim takip botu: Telegram uyarıları (senaryo)

Bu sayfa gerçek bir müşteri projesini değil, Fincode'un bu tür bir projede izlediği yaklaşımı gösteren örnek bir senaryoyu anlatır. Teknik ayrıntılar resmi kaynaklara dayanır; kapsam, süre ve fiyat her projede ayrıca belirlenir.

Proje özeti
Kim için	BIST şirketlerini izleyen bir analist ekibi (örnek senaryo)
Hizmet	Algoritmik işlem altyapısı: izleme ve bildirim
Platformlar	KAP verisi (lisanslı veri akışı), Telegram Bot API, e-posta
Teknolojiler	Python, PostgreSQL, mesaj kuyruğu, Telegram Bot API
Teslim	Bildirim botu, sınıflandırma kuralları, izleme paneli, kaynak kod ve dokümantasyon

İhtiyaç

Bu senaryoda BIST şirketlerini izleyen bir analist ekibi, izleme listesindeki şirketlerin bildirimlerini KAP'ın internet sitesini gün boyu açık tutarak takip eder. Finansal rapor dönemlerinde aynı anda çok sayıda bildirim gelir, seans dışında yayımlananlar ise gözden kaçabilir. Hedef, listedeki bir şirket bildirim yaptığında türüne göre etiketlenmiş, kısa özetli ve orijinal bildirime bağlantılı bir mesajın Telegram'a veya e-postaya hızla düşmesidir.

KAP, 6362 sayılı Sermaye Piyasası Kanunu'nda mevzuat uyarınca kamuya açıklanması gereken bilgilerin elektronik imzalı olarak iletildiği ve kamuya duyurulduğu elektronik sistem olarak tanımlanır; işletmecisi Merkezi Kayıt Kuruluşu'dur (MKK). Bot bildirimi okumanın yerine geçmez, yatırım tavsiyesi vermez ve alım satım emri üretmez. Bir bildirimin nasıl okunacağı KAP bildirimleri nasıl okunur yazısında anlatılıyor.

KAP verisine erişim

KAP'ın resmî yayın sitesi kap.org.tr'dir. KAP'ın yayımladığı site kılavuzu bildirimlerin ekranda listelenmesini, detaylı sorguyu ve en fazla 150 bildirimin Word veya Excel olarak toplu indirilmesini anlatır. Programla erişim için MKK'nın API Portalı, Ekim 2026 itibarıyla veri yayın kuruluşlarına yönelik resmî bir REST API belgeler: KAP Veri Yayın Servisleri. Bu API bildirim listesi, bildirim detayı, ek indirme ve erişime kapatılmış bildirimler gibi servisler sunar; canlı ortamda her çağrı, MKK'nın kullanıcıya ilettiği API anahtarıyla alınan ve 24 saat geçerli bir token gerektirir.

Borsa İstanbul'un veri yayın ürünleri arasında ise MKK kaynaklı KAP verileri bulunur: KAP üzerinden kamuya açıklanan finansal raporlar, özel durum açıklamaları ve diğer bildirimler. Borsa İstanbul verileri lisanslı veri dağıtım kuruluşları üzerinden eşanlı, gecikmeli ve gün sonu olarak yayımlanır. Bu nedenle senaryoda veri kaynağı, müşterinin lisansladığı bir veri dağıtım kuruluşunun akışıdır. Sitenin otomatik taranması tasarıma dahil edilmez; farklı bir erişim yolu düşünülürse koşulları önce MKK ve veri sağlayıcıyla netleştirilir. Mesajların kaç kişiye ve hangi kanaldan iletileceği de lisans kapsamıyla birlikte belirlenir.

Çözüm mimarisi

Alıcı: Veri akışına bağlanır, her bildirimi ham hâliyle ve alınma zamanıyla kaydeder. Bağlantı koptuğunda yeniden bağlanır; sağlayıcı destekliyorsa kopukluk süresi için geriye dönük sorgu yapar.
Tekilleştirme: KAP'taki tekil bildirim numarası anahtar olarak kullanılır; aynı numara ikinci kez geldiğinde yeni mesaj üretilmez. KAP site kılavuzu bir bildirimin İngilizcesi de olduğunu ayrı bir işaretle gösterir; bot iki dili tek kayıt altında birleştirir.
Düzeltmeler: KAP Yönergesi'ne göre, yönergede sayılan istisnalar dışında yayımlanan bildirimler sistemden silinmez; düzeltme öncekine atıf yapan ikinci bir bildirimle yapılır. Bot düzeltmeyi yeni bir kayıt olarak alır ve ilk mesaja yanıt olarak “Düzeltme” etiketiyle gönderir.
Sınıflandırma: Önce KAP'ın kendi alanları kullanılır: bildirim tipi (özel durum açıklaması, finansal rapor, hak kullanımı, düzenleyici kurum bildirimi, diğer) ve konu başlığı. Ekibin istediği etiketler (finansal tablo, kâr payı, sermaye artırımı, önemli olay) bu alanlardan kural tablosuyla üretilir. Kurala uymayan bildirim “sınıflandırılamadı” etiketiyle yine gönderilir ve kural tablosu güncellenir.
Özet: Kısa özet yalnızca bildirim metnine dayanır, “otomatik özet” olarak işaretlenir ve her mesajda orijinal bildirimin bağlantısı bulunur. Tutar ve tarihler metinden birebir alınır; metinde doğrulanamayan bir özet yerine yalnızca başlık ve bağlantı gönderilir.
Dağıtım: Telegram Bot API ve e-posta. Kategoriler bir forum grubunda ayrı konulara yönlendirilebilir; düşük öncelikli türler sessiz bildirimle gönderilir.

Hak kullanımı mesajlarına bir tarih notu eklenir: Borsa İstanbul'un teorik fiyat prosedürüne göre özsermaye hâllerinin başlama tarihi açısından KAP'ta iş günlerinde 16:30'dan sonra (yarım günlerde 12:00'den sonra) veya tatil günlerinde yayımlanan bildirimler takip eden iş günü yayımlanmış sayılır. Kâr payı takviminin izlenmesi temettü takvimi yazısında ele alınıyor.

Telegram teslimi ve hız sınırları

Telegram'ın bot SSS'sine göre tek bir sohbette saniyede birden fazla mesaj gönderilmemesi önerilir, bir grupta botlar dakikada 20'den fazla mesaj gönderemez ve toplu bildirimlerde sınır saniyede yaklaşık 30 mesajdır. Bot API'de mesaj metni varlık ayrıştırmasından sonra 1–4096 karakterdir; sınır aşıldığında dönen retry_after alanı isteğin kaç saniye sonra tekrarlanabileceğini bildirir. Tasarım bu kurallara göre kurulur:

Mesajlar önce kalıcı bir giden kutusu tablosuna yazılır; gönderimi ayrı bir işçi, sohbet bazında hız sınırına uyarak yapar.
Gönderim sonucu ve Telegram mesaj kimliği kaydedilir; yeniden başlatmada gönderilmiş mesaj tekrar gönderilmez, düzeltmeler bu kimliğe yanıt olarak bağlanır.
Yoğun dönemlerde aynı şirketin art arda gelen bildirimleri tek mesajda toplanabilir.
KAP'ta bildirim ekleri yalnızca PDF olabilir; bot eki kopyalamaz, bildirimin bağlantısını gönderir.
İzleme listesine şirket ekleme ve çıkarma komutları webhook veya getUpdates ile alınır. Bot API'ye göre bu iki yöntem birlikte kullanılamaz ve alınmayan güncellemeler en fazla 24 saat saklanır; webhook kullanılırsa secret_token başlığıyla isteğin Telegram'dan geldiği doğrulanır.

İzleme ve güvenilirlik

Uçtan uca gecikme ölçülür: bildirimin KAP'taki yayım zamanı, botun alma zamanı ve Telegram'a teslim zamanı ayrı ayrı kaydedilir.
Veri akışından beklenenden uzun süre bildirim gelmezse nöbetçi kişiye uyarı gider; finansal rapor dönemlerinde KAP'ın “Beklenen Bildirimler” ekranı eksik bildirim kontrolünde referans alınır.
Günlük mutabakatta, izleme listesindeki şirketler için KAP sitesinin Excel indirme özelliğiyle elle alınan günlük bildirim listesi ile gönderilen mesajlar karşılaştırılır; eksik veya çift kayıt fark listesine düşer.
Telegram bot anahtarı ve veri sağlayıcı kimlik bilgileri gizli anahtar deposunda tutulur; erişimler kayıt altına alınır.

Teslim edilenler

Veri akışı alıcısı ve ham kayıt deposu
Tekilleştirme ve düzeltme eşleştirme modülü
Kural tabanlı sınıflandırma tablosu ve düzenleme ekranı
Özet modülü ve doğrulama kuralları
Telegram ve e-posta dağıtım servisi, izleme listesi yönetimi
İzleme paneli, uyarılar, işletim dokümanı ve kaynak kod

Başarı nasıl ölçülür?

Uçtan uca gecikme, proje başında veri kaynağının kendi gecikmesi dikkate alınarak belirlenen hedefle karşılaştırılır.
Günlük mutabakatta izleme listesindeki her bildirim için tek bir mesaj bulunur; eksik veya çift mesaj kalmaz.
Örnek bir bildirim kümesinde otomatik etiketler ekibin elle verdiği etiketlerle karşılaştırılır; uyuşmayanlar kural tablosuna geri beslenir.
Özetlerdeki her tutar ve tarih bildirim metninde birebir bulunur.

Yapay zeka destekli metin analizinin sınırları yapay zeka ile borsa analizi yazısında tartışılıyor.

Sık sorulan sorular

KAP'ın herkese açık bir API'si veya RSS beslemesi var mı?

Ekim 2026 itibarıyla KAP'ın mevzuat ve kılavuzlar sayfasında RSS beslemesi tanımı yer almaz. API olarak ise MKK'nın API Portalı, veri yayın kuruluşlarına yönelik resmî bir REST API'yi (“KAP Veri Yayın Servisleri”) belgeler; canlı ortama erişim, MKK'nın ilettiği API anahtarıyla alınan token ile sağlanır. KAP verileri ayrıca Borsa İstanbul'un veri yayın ürünleri arasında yer alır ve lisanslı veri dağıtım kuruluşları üzerinden alınır.

Aynı bildirim neden iki kez gelmez?

Her bildirim KAP'taki tekil numarasıyla kaydedilir ve aynı numara tekrar geldiğinde mesaj üretilmez. Düzeltme bildirimleri yeni bir numarayla geldiği için ilk mesaja yanıt olarak gönderilir.

Yoğun dönemlerde mesajlar neden sıraya girer?

Telegram bir grupta botların dakikada 20'den fazla mesaj göndermesine izin vermez. Bot mesajları sırayla ve bu sınıra uyarak gönderir, gerekirse aynı şirketin bildirimlerini tek mesajda toplar.

Bot yatırım önerisi verir mi?

Hayır. Bot bildirimi sınıflandırır, kısaca özetler ve orijinal metne bağlantı verir; alım satım kararı veya emri üretmez.

Kaynaklar

Benzer bir proje mi planlıyorsunuz?

Kullanılan platformu, kapsamı ve takvimi kısa formla iletin; ön değerlendirmenin ardından yazılı teklif sunulur. Fincode bir yazılım geliştirme şirketidir; yatırım danışmanlığı, portföy yönetimi veya kripto varlık hizmet sağlayıcılığı yapmaz.

Hizmeti inceleyin Proje formunu doldurun