Skip to content
Back to search

borsa-mcp

MCP Server for Turkish & American Stock Exchange and Fund Data

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/saidsurucu--borsa-mcp/badge.svg)](/listings/saidsurucu--borsa-mcp)

HTML

<a href="/listings/saidsurucu--borsa-mcp"><img src="/api/listings/saidsurucu--borsa-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 586 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Borsa MCP: Türk Finans Piyasaları için MCP Sunucusu
  2. [![Star History Chart](https://api.star-history.com/svg?repos=saidsurucu/borsa-mcp&type=Date)](https://www.star-history.com/#saidsurucu/borsa-mcp&Date)
  3. Borsa İstanbul (BIST) ve ABD (US) hisseleri, TEFAS fonları, kripto paralar ve döviz/emtia verilerine LLM'ler üzerinden erişim sağlayan [FastMCP](https://gofastmcp.com/) sunucusu. KAP, Yahoo Finance, BtcTurk, Coinbase, borsapy ve TCMB gibi kaynaklardan **26 birleşik araç** ile kapsamlı finansal analiz.
  4. ![ornek](./ornek.jpeg)
  5. ![fon ornek](./fon-ornek.png)
  6. ---
  7. ## ⚠️ Önemli Uyarılar
  8. - **LLM'ler halüsinasyon yapabilir** - Verileri mutlaka doğrulayın
  9. - **Yatırım tavsiyesi değildir** - Profesyonel danışmanlık alın
  10. - **Eğitim amaçlıdır** - Sorumluluk size aittir
  11. ---
  12. ## 📢 Sunucu Taşındı
  13. **Borsa MCP sunucusu artık https://borsa.surucu.dev/mcp adresinde.**
  14. Eski adresi (`borsamcp.fastmcp.app`) kullanıyorsanız, yapılandırmanızı yukarıdaki yeni adresle güncelleyin. Eski adres bir süre daha ayakta kalacak ancak yalnızca bu taşınma bilgisini döndürüyor, piyasa verisi sunmuyor.
  15. Açık kaynak projelerime sponsor olduğu için [@arctcloud](https://x.com/arctcloud) — **Arct Cloud**'a teşekkürler. Diğer MCP sunucularımı da vakit buldukça taşıyacağım.
  16. Siz de **SAID35** koduyla %35 indirimli kullanabilirsiniz: https://arct.cloud/?ref=x-promo-4exe09
  17. ---
  18. ## 🚀 5 Dakikada Başla (Remote MCP)
  19. **✅ Kurulum Gerektirmez! Hemen Kullan!**
  20. 🔗 **Remote MCP Adresi:** https://borsa.surucu.dev/mcp
  21. ### Claude Desktop ile Kullanım (Ücretli abonelik gerekir)
  22. 1. **Claude Desktop**'ı açın
  23. 2. **Settings** → **Connectors** → **Add Custom Connector**
  24. 3. Bilgileri girin:
  25. - **Name:** `Borsa MCP`
  26. - **URL:** `https://borsa.surucu.dev/mcp`
  27. 4. **Add** butonuna tıklayın
  28. 5. Hemen kullanmaya başlayın! 🎉
  29. ### Google Antigravity ile Kullanım
  30. 1. Agent session açın ve editörün yan panelindeki "…" dropdown menüsüne tıklayın
  31. 2. **MCP Servers** seçeneğini seçin - MCP Store açılacak
  32. 3. Üstteki **Manage MCP Servers** butonuna tıklayın
  33. 4. **View raw config** seçeneğine tıklayın
  34. 5. `mcp_config.json` dosyasına aşağıdaki yapılandırmayı ekleyin:
  35. ```json
  36. {
  37. "mcpServers": {
  38. "borsa-mcp": {
  39. "serverUrl": "https://borsa.surucu.dev/mcp",
  40. "headers": {
  41. "Content-Type": "application/json"
  42. }
  43. }
  44. }
  45. }
  46. ```
  47. 💡 **İpucu:** Remote MCP sayesinde Python, uv veya herhangi bir kurulum yapmadan doğrudan Google Antigravity üzerinden Türk finans piyasalarına erişebilirsiniz!
  48. **Örnek Sorular:**
  49. ```
  50. GARAN hissesinin son 1 aylık performansını analiz et
  51. XU100 endeksinin bugünkü durumunu göster
  52. Bitcoin'in TRY fiyatını kontrol et
  53. ```
  54. ---
  55. ## 🎯 Temel Özellikler
  56. **28 Birleşik Araç ile Kapsamlı Finansal Analiz (v0.9.0):**
  57. * 📈 **Hisse Senetleri (BIST + US):** 758 BIST + tüm NYSE/NASDAQ şirketleri, tek araçla `market` parametresi ile
  58. * 🔍 **Teknik Tarama:** BIST teknik scanner (RSI, MACD, Supertrend, T3) + US screener (23 preset)
  59. * 🆕 **TCMB EVDS:** 145 kategori, on binlerce makro seri — faiz, döviz, ödemeler dengesi, enflasyon (`get_evds_data`, ücretsiz API key)
  60. * 🆕 **Makro Veriler:** TCMB enflasyon verileri ve hesaplama araçları (`get_macro_data`)
  61. * 🎯 **Pivot Points:** 3 direnç & 3 destek seviyesi hesaplama (klasik pivot formülü)
  62. * 📊 **Endeksler:** BIST + US endeksleri tek araçla (`get_index_data`)
  63. * 💡 **Değer Yatırımı:** Buffett analizi ve finansal sağlık araçları (ROE, ROIC, Altman Z-Score)
  64. * 💰 **TEFAS Fonları:** 836+ fon, performans, portföy, karşılaştırma (`compare_mode`)
  65. * ₿ **Kripto Paralar:** BtcTurk + Coinbase birleşik (`get_crypto_market`)
  66. * 💱 **Döviz & Emtia:** 65 para birimi, altın, petrol (borsapy entegrasyonu)
  67. * 📅 **Ekonomik Takvim:** TR, US, EU, DE, GB, JP, CN (7 ülke)
  68. * ☪️ **Katılım Finans:** Katılım finans uygunluk bilgisi (`include_islamic` parametresi)
  69. * 📰 **KAP Haberleri:** Liste + detay (`news_id` parametresi ile)
  70. * 📋 **Yardım Araçları:** `get_screener_help`, `get_scanner_help`, `get_regulations`
  71. * ⚡ **LLM Optimizasyonu:** İngilizce açıklamalar, domain-spesifik araç seçimi
  72. * 🚀 **FastMCP 2.14:** Response Caching + Background Tasks
  73. ## 📑 İçindekiler
  74. | Bölüm | Açıklama |
  75. |-------|----------|
  76. | [🚀 5 Dakikada Başla](#-5-dakikada-başla-remote-mcp) | Kurulum gerektirmez - Remote MCP |
  77. | [🎯 Temel Özellikler](#-temel-özellikler) | 26 birleşik araç ile kapsamlı finansal analiz |
  78. | [💻 Gelişmiş Kurulum](#-gelişmiş-kurulum-isteğe-bağlı) | 5ire, Claude Desktop local kurulum |
  79. | [🛠️ Kullanılabilir Araçlar](#️-kullanılabilir-araçlar-mcp-tools) | BIST, US, Kripto, Döviz, Fon araçları |
  80. | [🔍 Veri Kaynakları](#-veri-kaynakları--kapsam) | KAP, Yahoo Finance, BtcTurk, Coinbase, TCMB |
  81. | [📊 Örnek Kullanım](#-örnek-kullanım) | Pratik sorgular ve analiz örnekleri |
  82. ---
  83. ## 💻 Gelişmiş Kurulum (İsteğe Bağlı)
  84. **Not:** Remote MCP kullanıyorsanız bu adımları atlayabilirsiniz!
  85. ### 5ire ve Diğer MCP İstemcileri için Local Kurulum
  86. Bu bölüm, Borsa MCP'yi 5ire gibi diğer MCP istemcileriyle local olarak kullanmak isteyenler içindir.
  87. * **Python Kurulumu:** Sisteminizde Python 3.11 veya üzeri kurulu olmalıdır. Kurulum sırasında "**Add Python to PATH**" (Python'ı PATH'e ekle) seçeneğini işaretlemeyi unutmayın. [Buradan](https://www.python.org/downloads/) indirebilirsiniz.
  88. * **Git Kurulumu (Windows):** Bilgisayarınıza [git](https://git-scm.com/downloads/win) yazılımını indirip kurun. "Git for Windows/x64 Setup" seçeneğini indirmelisiniz.
  89. * **`uv` Kurulumu:**
  90. * **Windows Kullanıcıları (PowerShell):** Bir CMD ekranı açın ve bu kodu çalıştırın: `powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"`
  91. * **Mac/Linux Kullanıcıları (Terminal):** Bir Terminal ekranı açın ve bu kodu çalıştırın: `curl -LsSf https://astral.sh/uv/install.sh | sh`
  92. * **Microsoft Visual C++ Redistributable (Windows):** Bazı Python paketlerinin doğru çalışması için gereklidir. [Buradan](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170) indirip kurun.
  93. * İşletim sisteminize uygun [5ire](https://5ire.app) MCP istemcisini indirip kurun.
  94. * 5ire'ı açın. **Workspace -> Providers** menüsünden kullanmak istediğiniz LLM servisinin API anahtarını girin.
  95. * **Tools** menüsüne girin. **+Local** veya **New** yazan butona basın.
  96. * **Tool Key:** `borsamcp`
  97. * **Name:** `Borsa MCP`
  98. * **Command:**
  99. ```
  100. uvx --from git+https://github.com/saidsurucu/borsa-mcp borsa-mcp
  101. ```
  102. * **Save** butonuna basarak kaydedin.
  103. * Şimdi **Tools** altında **Borsa MCP**'yi görüyor olmalısınız. Üstüne geldiğinizde sağda çıkan butona tıklayıp etkinleştirin (yeşil ışık yanmalı).
  104. * Artık Borsa MCP ile konuşabilirsiniz.
  105. ### Claude Desktop için Local Kurulum
  106. **Not:** Remote MCP daha kolay bir seçenektir. Sadece local kurulum yapmak istiyorsanız bu adımları izleyin.
  107. 1. **Ön Gereksinimler:** Python, `uv`, (Windows için) Microsoft Visual C++ Redistributable'ın sisteminizde kurulu olduğundan emin olun. Detaylı bilgi için yukarıdaki "5ire için Kurulum" bölümündeki ilgili adımlara bakabilirsiniz.
  108. 2. Claude Desktop **Settings -> Developer -> Edit Config**.
  109. 3. Açılan `claude_desktop_config.json` dosyasına `mcpServers` altına ekleyin. UYARI: // ile başlayan yorum satırını silmelisiniz:
  110. ```json
  111. {
  112. "mcpServers": {
  113. // ... (varsa diğer sunucularınız) ...
  114. "Borsa MCP": {
  115. "command": "uvx",
  116. "args": [
  117. "--from", "git+https://github.com/saidsurucu/borsa-mcp",
  118. "borsa-mcp"
  119. ]
  120. }
  121. }
  122. }
  123. ```
  124. 4. Claude Desktop'ı kapatıp yeniden başlatın.
  125. ---
  126. ## 🛠️ Kullanılabilir Araçlar (MCP Tools)
  127. Bu FastMCP sunucusu LLM modelleri için **26 birleşik araç** sunar. Tüm araçlar `market` parametresi ile BIST ve US piyasalarını destekler.
  128. ### Hisse Senedi Araçları (15 araç - BIST + US)
  129. | Araç | Açıklama | Multi-ticker |
  130. |------|----------|--------------|
  131. | `search_symbol` | Hisse, endeks, fon, kripto sembol arama | - |
  132. | `get_profile` | Şirket profili (sektör, açıklama, finansallar) + `include_islamic` | - |
  133. | `get_quick_info` | Hızlı metrikler (P/E, P/B, ROE, 52h aralık) | ✅ |
  134. | `get_historical_data` | OHLCV fiyat verileri (tarih aralığı desteği) | - |
  135. | `get_technical_analysis` | RSI, MACD, Bollinger Bantları, hareketli ortalamalar | - |
  136. | `get_pivot_points` | Destek/direnç seviyeleri (S1-S3, R1-R3) | - |
  137. | `get_analyst_data` | Analist derecelendirmeleri ve fiyat hedefleri | ✅ |
  138. | `get_dividends` | Temettü geçmişi, verim, dağıtım oranı | ✅ |
  139. | `get_earnings` | Kazanç takvimi, EPS geçmişi, büyüme tahminleri | ✅ |
  140. | `get_financial_statements` | Bilanço, gelir tablosu, nakit akışı | ✅ |
  141. | `get_financial_ratios` | Değerleme, Buffett, sağlık, gelişmiş metrikler | - |
  142. | `get_corporate_actions` | Sermaye artırımları, temettü geçmişi (BIST) | ✅ |
  143. | `get_news` | KAP haberleri + `news_id` ile detay | - |
  144. | `screen_securities` | 23 preset veya özel filtreler ile tarama | - |
  145. | `scan_stocks` | Teknik scanner (RSI, MACD, Supertrend, T3) | - |
  146. ### Kripto Araçları (1 araç - BtcTurk + Coinbase)
  147. | Araç | Açıklama |
  148. |------|----------|
  149. | `get_crypto_market` | Ticker, orderbook, trades, OHLC, borsa bilgileri |
  150. ### FX & Makro Araçları (4 araç)
  151. | Araç | Açıklama |
  152. |------|----------|
  153. | `get_fx_data` | 65 para birimi, metaller, emtialar (borsapy) |
  154. | `get_economic_calendar` | Ekonomik olaylar (TR, US, EU, DE, GB, JP, CN) |
  155. | `get_bond_yields` | Devlet tahvil faizleri (TR 2Y, 5Y, 10Y) |
  156. | `get_sector_comparison` | Sektör karşılaştırması ve ortalama metrikler |
  157. ### Fon & Endeks Araçları (2 araç)
  158. | Araç | Açıklama |
  159. |------|----------|
  160. | `get_fund_data` | TEFAS fon verileri + `compare_mode` ile karşılaştırma |
  161. | `get_index_data` | Borsa endeks verileri (BIST + US) |
  162. ### Makro & Yardım Araçları (5 araç)
  163. | Araç | Açıklama |
  164. |------|----------|
  165. | `get_macro_data` | TCMB enflasyon verileri ve hesaplama (TÜFE/ÜFE, key gerekmez) |
  166. | `get_evds_data` | TCMB EVDS — 145 kategori, on binlerce makro seri (rates, FX, BoP, expectation surveys); katalog/arama key gerekmez, veri çekme için `EVDS_API_KEY` env var (ücretsiz: https://evds3.tcmb.gov.tr) |
  167. | `get_screener_help` | Screener presetleri ve filtre dokümantasyonu |
  168. | `get_scanner_help` | BIST scanner göstergeleri ve presetler |
  169. | `get_regulations` | Türk yatırım fonu mevzuatı |
  170. #### 🔑 EVDS Kurulumu
  171. `get_evds_data` aracının veri çekme işlemleri (`series`, `multi_series`, `datagroup_data`) için TCMB'den ücretsiz bir API anahtarı gerekir. Katalog gezintisi, arama ve dashboard listeleme anahtar gerektirmeden çalışır.
  172. 1. https://evds3.tcmb.gov.tr → "BENİM SAYFAM" → Kayıt Ol
  173. 2. Profilim → API Key Kopyala
  174. 3. Ortam değişkeni olarak ayarla:
  175. ```bash
  176. export EVDS_API_KEY="your-key-here"
  177. ```
  178. veya MCP server config'e ekle (Claude Desktop / Cursor):
  179. ```json
  180. {
  181. "mcpServers": {
  182. "borsa": {
  183. "command": "uv",
  184. "args": ["run", "borsa-mcp"],
  185. "env": { "EVDS_API_KEY": "your-key-here" }
  186. }
  187. }
  188. }
  189. ```
  190. **Örnek kullanım:**
  191. ```python
  192. get_evds_data(action="categories") # 145 kategori
  193. get_evds_data(action="search", keyword="dolar") # katalog araması
  194. get_evds_data(action="series", series_code="TP.DK.USD.A.YTL", period="1y") # USD/TRY günlük
  195. get_evds_data(action="series", series_code="TP.FG.J0", formula="yoy_pct") # TÜFE YoY%
  196. get_evds_data(action="multi_series", series_codes=["TP.DK.USD.A.YTL","TP.DK.EUR.A.YTL"])
  197. get_evds_data(action="datagroup_data", datagroup_code="bie_dkdovizgn") # 137 seri tek çağrıda
  198. ```
  199. ---
  200. ## 🔍 Veri Kaynakları & Kapsam
  201. ### KAP (Kamuyu Aydınlatma Platformu)
  202. - **Şirketler**: 758 BIST şirketi (ticker kodları, adlar, şehirler, çoklu ticker desteği)
  203. - **Katılım Finans**: Resmi katılım finans uygunluk değerlendirmeleri
  204. - **Güncelleme**: Otomatik önbellek ve yenileme
  205. ### Yahoo Finance Entegrasyonu
  206. - **Endeks Desteği**: Tüm BIST endeksleri (XU100, XBANK, XK100 vb.) için tam destek
  207. - **Zaman Dilimi**: Tüm zaman damgaları Avrupa/İstanbul'a çevrilir
  208. - **Veri Kalitesi**: Büyük bankalar ve teknoloji şirketleri en iyi kapsama sahiptir
  209. - **Tarih Aralığı Desteği**: Belirli tarihler arası sorgulama (YYYY-MM-DD formatında, örn: "2024-01-01" - "2024-12-31")
  210. - **İki Sorgu Modu**:
  211. - **Dönem Modu:** Period parametresi ile (1d, 1mo, 1y, vb.) - varsayılan
  212. - **Tarih Modu:** start_date ve end_date parametreleri ile belirli tarih aralığı
  213. ### US Stock Market (Yahoo Finance)
  214. - **Kapsam**: S&P 500, Nasdaq-100, Dow Jones ve NYSE'deki tüm şirketler
  215. - **Endeksler**: 28 ana US endeksi (^GSPC, ^IXIC, ^DJI, Russell, sektör ETF'leri)
  216. - **Kategoriler**: Large Cap, Tech, Blue Chip, Small Cap, Mid Cap, International
  217. - **Finansal Tablolar**: Quarterly ve annual balance sheet, income statement, cash flow
  218. - **Değer Analizi**: Buffett analizi için US 10Y Treasury (^TNX) ve Fed %2.5 enflasyon hedefi
  219. - **Güncelleme**: Gerçek zamanlı piyasa verileri
  220. ### US Stock Screener (yfscreen paketi)
  221. - **Varlık Türleri**: Hisse senedi (equity), ETF ve yatırım fonları (mutual funds)
  222. - **Preset Sayısı**: 23 hazır tarama şablonu (18 hisse + 3 ETF + 2 yatırım fonu)
  223. - **Filtre Alanları**: 96+ hisse senedi, 29 ETF, 28 yatırım fonu filtre alanı
  224. - **Operatörler**: eq (eşit), gt (büyük), lt (küçük), btwn (arasında)
  225. - **Özel Filtreler**: Kullanıcı tanımlı filtreler ile gelişmiş tarama
  226. - **Akıllı Alan Dönüşümü**: ETF/fund taramalarında equity alanları otomatik dönüştürülür
  227. - **Otomatik Region**: Custom filter kullanırken `region=us` otomatik eklenir
  228. - **Sayfalama**: Offset/limit ile büyük sonuç setlerinde navigasyon
  229. - **Performans**: Yahoo Finance screener API entegrasyonu, hızlı sonuçlar
  230. ### BIST Hisse Tarayıcı (borsapy paketi)
  231. - **Veri Kaynağı**: İş Yatırım gelişmiş hisse arama (borsapy kütüphanesi)
  232. - **Preset Sayısı**: 15 hazır tarama şablonu (piyasa değeri, değer, temettü, momentum, hacim, yabancı, analist)
  233. - **Filtre Kriteri**: 50+ filtre (13 kategori: değerleme, kârlılık, temettü, getiri, piyasa, yabancı, analist, endeks)
  234. - **Operatörler**: min (minimum), max (maximum) ile aralık filtreleme
  235. - **Özel Filtreler**: Kullanıcı tanımlı filtreler ile gelişmiş tarama
  236. - **Otomatik Birim Dönüşümü**: Piyasa değeri ve hacim için TL → milyon TL otomatik dönüşüm
  237. - **Sayfalama**: Offset/limit ile büyük sonuç setlerinde navigasyon
  238. - **Performans**: İş Yatırım API entegrasyonu, hızlı sonuçlar
  239. - **Güncelleme**: Gerçek zamanlı BIST verileri
  240. ### Mynet Finans (Hibrit Mod)
  241. - **Türk Özel Verileri**: Kurumsal yönetim, ortaklık yapısı, bağlı şirketler
  242. - **KAP Haberleri**: Gerçek zamanlı resmi duyuru akışı
  243. - **Endeks Kompozisyonu**: Canlı endeks şirket listeleri
  244. ### TEFAS (Türkiye Elektronik Fon Alım Satım Platformu)
  245. - **Fon Evreni**: 800+ Türk yatırım fonu
  246. - **Resmi API**: TEFAS BindHistoryInfo ve BindHistoryAllocation API'leri
  247. - **Kategori Filtreleme**: 13 fon kategorisi (borçlanma, hisse senedi, altın vb.)
  248. - **Performans Metrikleri**: 7 dönemlik getiri analizi (1 günlük - 3 yıllık)
  249. - **Portföy Analizi**: 50+ Türk varlık kategorisi ile detaylı dağılım
  250. - **Güncellik**: Gerçek zamanlı fon fiyatları ve performans verileri
  251. ### Fon Mevzuatı
  252. - **Kaynak**: `fon_mevzuat_kisa.md` - 80,820 karakter düzenleme metni
  253. - **Kapsam**: Yatırım fonları için kapsamlı Türk mevzuatı
  254. - **İçerik**: Portföy limitleri, fon türleri, uyumluluk kuralları
  255. - **Güncelleme**: Dosya metadata ile son güncelleme tarihi
  256. ### BtcTurk Kripto Para Borsası (Türk Piyasası)
  257. - **İşlem Çiftleri**: 295+ kripto para işlem çifti (ana TRY ve USDT piyasaları dahil)
  258. - **Para Birimleri**: 158+ desteklenen kripto para ve fiat para birimi (BTC, ETH, TRY, USDT vb.)
  259. - **API Endpoint**: Resmi BtcTurk Public API v2 (https://api.btcturk.com/api/v2)
  260. - **Piyasa Verileri**: Gerçek zamanlı ticker fiyatları, emir defterleri, işlem geçmişi, OHLC/Kline grafikleri
  261. - **Türk Odak**: TRY çiftleri için optimize edilmiş (BTCTRY, ETHTRY, ADATRY vb.)
  262. - **Güncelleme Sıklığı**: Borsa bilgileri için 1 dakika önbellek ile gerçek zamanlı piyasa verileri
  263. - **Veri Kalitesi**: Milisaniye hassasiyetli zaman damgaları ile profesyonel seviye borsa verileri
  264. ### Coinbase Global Kripto Para Borsası (Uluslararası Piyasalar)
  265. - **İşlem Çiftleri**: 500+ global kripto para işlem çifti (ana USD, EUR ve GBP piyasaları dahil)
  266. - **Para Birimleri**: 200+ desteklenen kripto para ve fiat para birimi (BTC, ETH, USD, EUR, GBP vb.)
  267. - **API Endpoint**: Resmi Coinbase Advanced Trade API v3 ve App API v2 (https://api.coinbase.com)
  268. - **Piyasa Verileri**: Gerçek zamanlı ticker fiyatları, emir defterleri, işlem geçmişi, OHLC/mum grafikleri, sunucu zamanı
  269. - **Global Odak**: Uluslararası piyasalar için USD/EUR çiftleri (BTC-USD, ETH-EUR vb.)
  270. - **Güncelleme Sıklığı**: Borsa bilgileri için 5 dakika önbellek ile gerçek zamanlı piyasa verileri
  271. - **Veri Kalitesi**: Coinbase (NASDAQ: COIN) kurumsal seviye global likidite ile işletme düzeyinde borsa verileri
  272. - **Kapsam**: Tam global piyasa kapsama, kurumsal seviye işlem verileri, çapraz piyasa arbitraj fırsatları
  273. - **Çapraz Piyasa Analizi**: Türk kripto piyasaları (BtcTurk TRY çiftleri) ile global piyasaları (Coinbase USD/EUR çiftleri) karşılaştırma
  274. ### Dovizcom Döviz & Emtia Platformu (Türk & Uluslararası Piyasalar)
  275. - **Varlık Kapsamı**: 28+ varlık (ana para birimleri, kıymetli madenler, enerji emtiaları, yakıt fiyatları)
  276. - **Ana Para Birimleri**: USD, EUR, GBP, JPY, CHF, CAD, AUD ile gerçek zamanlı TRY döviz kurları
  277. - **Kıymetli Madenler**: Hem Türk (gram-altın, gümüş) hem uluslararası (ons, XAG-USD, XPT-USD, XPD-USD) çifte fiyatlandırma
  278. - **Enerji Emtiaları**: BRENT ve WTI petrol fiyatları ile tarihsel trendler ve piyasa analizi
  279. - **Yakıt Fiyatları**: Dizel, benzin ve LPG fiyatları (TRY bazlı) ile günlük fiyat takibi
  280. - **API Endpoint**: Resmi doviz.com API v12 (https://api.doviz.com/api/v12)
  281. - **Gerçek Zamanlı Veri**: Kısa vadeli analiz için 60 veri noktasına kadar dakikalık güncellemeler
  282. - **Tarihsel Veri**: Teknik analiz ve trend araştırması için özel tarih aralıklarında günlük OHLC verileri
  283. - **Güncelleme Sıklığı**: Güncel kurlar için 1 dakika önbellek ile gerçek zamanlı piyasa verileri
  284. - **Veri Kalitesi**: Türkiye'nin önde gelen finansal bilgi sağlayıcısından profesyonel seviye finansal veriler
  285. - **Piyasa Odağı**: Çapraz piyasa analizi için uluslararası USD/EUR karşılaştırmaları ile Türk TRY bazlı fiyatlandırma
  286. - **Kimlik Doğrulama**: Güvenilir API erişimi için uygun başlık yönetimi ile Bearer token kimlik doğrulaması
  287. - **Kapsam**: Döviz ticareti, kıymetli maden yatırımı, emtia analizi ve yakıt fiyat takibi için tam finansal piyasalar kapsamı
  288. ### Dovizcom Ekonomik Takvim (Çoklu Ülke Desteği)
  289. - **Makroekonomik Olaylar**: GDP, enflasyon, istihdam, sanayi üretimi, PMI, işsizlik oranları ve diğer piyasa etkili ekonomik göstergeler
  290. - **Ülke Kapsamı**: 30+ ülke (TR, US, EU, GB, JP, DE, FR, CA, AU, CN, KR, BR vb.) için ekonomik veri takibi
  291. - **Çoklu Ülke Filtreleme**: Virgülle ayrılmış ülke kodları ile esnek filtreleme (örn: "TR,US,DE")
  292. - **Varsayılan Davranış**: Türkiye ve ABD ekonomik olayları (TR,US) varsayılan olarak gösterilir
  293. - **API Endpoint**: Resmi Doviz.com Economic Calendar API (https://www.doviz.com/calendar/getCalendarEvents)
  294. - **Filtreleme Özellikleri**: Ülke bazlı filtreleme, önem seviyesi seçimi (yüksek/orta/düşük), özelleştirilebilir tarih aralıkları
  295. - **Veri Detayları**: Gerçek değerler, önceki dönem verileri, tahminler (mevcut olduğunda), dönem bilgileri Türkçe açıklamalar
  296. - **Güncelleme Sıklığı**: Gerçek zamanlı ekonomik olay takibi ve uluslararası piyasa etkisi analizi
  297. - **Zaman Dilimi Desteği**: Avrupa/İstanbul ana zaman dilimi ile Türk saati koordinasyonu
  298. - **Veri Kalitesi**: Doviz.com'un özelleşmiş finansal veri ağından profesyonel seviye uluslararası makroekonomik bilgiler
  299. ### TCMB Enflasyon Verileri (Resmi Merkez Bankası)
  300. - **Veri Kaynağı**: Türkiye Cumhuriyet Merkez Bankası resmi enflasyon istatistikleri sayfaları
  301. - **Veri Türleri**:
  302. - **TÜFE:** Tüketici Fiyat Endeksi (2005-2025, 245+ aylık kayıt)
  303. - **ÜFE:** Üretici Fiyat Endeksi - Yurt İçi (2014-2025, 137+ aylık kayıt)
  304. - **Güncelleme Sıklığı**: Aylık (genellikle ayın ortasında resmi açıklama)
  305. - **Veri Kalitesi**: Resmi TCMB kaynağından web scraping ile %100 güvenilir
  306. - **Performans**: 2-3 saniye (1 saatlik cache ile optimize edilmiş)
  307. - **Filtreleme**: Enflasyon türü seçimi, tarih aralığı (YYYY-MM-DD), kayıt sayısı limiti
  308. - **İstatistikler**: Min/max oranlar, ortalamalar, son değerler otomatik hesaplama
  309. - **Son Veriler (Mayıs 2025)**:
  310. - **TÜFE:** %35.41 (yıllık), %1.53 (aylık)
  311. - **ÜFE:** %23.13 (yıllık), %2.48 (aylık)
  312. - **Ekonomik Analiz**: ÜFE öncü gösterge olarak TÜFE hareketlerini öngörmede kullanılır
  313. ---
  314. ## 📊 Örnek Kullanım
  315. ```
  316. # Şirket arama
  317. GARAN hissesi için detaylı analiz yap
  318. # Endeks analizi
  319. XU100 endeksinin son 1 aylık performansını analiz et
  320. # Tarih aralığı ile hisse analizi (YENİ!)
  321. GARAN hissesinin 2024 yıl başından bugüne performansını analiz et
  322. # Belirli dönem karşılaştırması (YENİ!)
  323. THYAO'nun 2023 ve 2024 yıllarının ilk çeyreklerini karşılaştır
  324. # Teknik analiz
  325. ASELS için kapsamlı teknik analiz ve al-sat sinyalleri ver
  326. # KAP haberleri
  327. THYAO için son 5 KAP haberini getir ve ilkinin detayını analiz et
  328. # Katılım finans
  329. ARCLK'nın katılım finans uygunluğunu kontrol et
  330. # Sektör karşılaştırması
  331. Bankacılık sektöründeki ana oyuncuları karşılaştır: GARAN, AKBNK, YKBNK
  332. # US hisse analizi
  333. Apple (AAPL) hissesinin son 3 aylık performansını analiz et
  334. # US finansal tablolar
  335. Microsoft'un son yıllık bilançosunu getir
  336. # US Buffett değer analizi
  337. Amazon için Buffett değer analizi yap
  338. # US endeks arama
  339. Teknoloji sektörü endekslerini ara
  340. # US sektör karşılaştırması
  341. AAPL, MSFT, GOOGL şirketlerini sektör bazında karşılaştır
  342. # US finansal sağlık analizi
  343. Tesla için kapsamlı finansal sağlık analizi yap
  344. # US hisse tarama (screener)
  345. Büyük piyasa değerli (large cap) ABD hisselerini listele
  346. # US değer hisseleri tarama
  347. Düşük F/K oranına sahip (P/E < 15) değer hisselerini bul
  348. # US yüksek temettü hisseleri
  349. %5'ten fazla temettü veren ABD hisselerini ara
  350. # US sektör bazlı tarama
  351. Teknoloji sektöründeki büyük cap hisseleri listele
  352. # US ETF tarama
  353. 10 milyar dolardan fazla AUM'a sahip büyük ETF'leri göster
  354. # US özel filtre taraması
  355. Piyasa değeri 100 milyar dolar üstü ve ROE > %20 olan hisseleri bul
  356. # BIST hisse tarama (screener) - YENİ!
  357. Yüksek temettü veren BIST hisselerini listele
  358. # BIST düşük F/K tarama
  359. F/K oranı 10'dan düşük BIST hisselerini bul
  360. # BIST yüksek ROE tarama
  361. ROE oranı %15'ten yüksek şirketleri ara
  362. # BIST yabancı favorileri
  363. Yabancı yatırımcı oranı %40'tan fazla olan hisseleri göster
  364. # BIST momentum tarama
  365. Yükseliş potansiyeli %20'den fazla olan hisseleri listele
  366. # BIST özel filtre taraması
  367. Piyasa değeri 10 milyar TL üstü ve temettü verimi %3'ten fazla olan hisseleri bul
  368. # BIST analist tavsiyeleri
  369. AL önerisi alan BIST hisselerini listele
  370. # Fon arama ve analizi
  371. "altın" fonları ara ve en iyi performans gösteren 3 tanesini karşılaştır
  372. # Fon portföy analizi
  373. AAK fonunun son 6 aylık portföy dağılım değişimini analiz et
  374. # Fon mevzuat sorguları
  375. Yatırım fonlarında türev araç kullanım limitleri nelerdir?
  376. # Türk kripto para analizi
  377. Bitcoin'in TRY cinsinden son 1 aylık fiyat hareketlerini analiz et
  378. # Türk kripto piyasa takibi
  379. BtcTurk'te en çok işlem gören kripto çiftleri listele ve fiyat değişimlerini göster
  380. # Türk kripto emir defteri analizi
  381. BTCTRY çiftinin emir defterini görüntüle ve derinlik analizini yap
  382. # Global kripto para analizi
  383. Bitcoin'in USD cinsinden Coinbase'deki son 1 aylık fiyat hareketlerini analiz et
  384. # Global kripto piyasa takibi
  385. Coinbase'de en popüler USD/EUR kripto çiftlerini listele ve global piyasa trendlerini göster
  386. # Global kripto emir defteri analizi
  387. BTC-USD çiftinin Coinbase emir defterini görüntüle ve global likidite analizini yap
  388. # Çapraz piyasa kripto analizi
  389. Bitcoin fiyatını Türk (BTCTRY) ve global (BTC-USD) piyasalarda karşılaştır
  390. # Arbitraj fırsatı analizi
  391. ETH fiyatlarını BtcTurk (ETHUSDT) ve Coinbase (ETH-USD) arasında karşılaştırarak arbitraj fırsatlarını tespit et
  392. # BtcTurk kripto teknik analiz
  393. BTCTRY çiftinin günlük teknik analizini yap ve al-sat sinyallerini değerlendir
  394. # Coinbase global kripto teknik analiz
  395. BTC-USD çiftinin 4 saatlik teknik analizini yap ve RSI, MACD durumunu analiz et
  396. # Çapraz piyasa teknik analiz karşılaştırması
  397. Bitcoin'in hem Türk piyasasında (BTCTRY) hem global piyasada (BTC-USD) teknik analiz sinyallerini karşılaştır
  398. # Global kripto teknik analiz
  399. ETH-EUR çiftinin günlük Bollinger Bantları ve hareketli ortalama durumunu analiz et
  400. # Döviz kuru analizi
  401. USD/TRY kurunun güncel durumunu ve son 1 saatteki dakikalık hareketlerini analiz et
  402. # Altın fiyat takibi
  403. Gram altının TRY cinsinden güncel fiyatını al ve son 30 dakikadaki değişimini göster
  404. # Uluslararası altın karşılaştırması
  405. Türk gram altını ile uluslararası ons altın fiyatlarını karşılaştır
  406. # Emtia fiyat analizi
  407. Brent petrolün son 6 aylık OHLC verilerini al ve fiyat trendini analiz et
  408. # Kıymetli maden portföy takibi
  409. Altın, gümüş ve platinyum fiyatlarının güncel durumunu ve haftalık performansını karşılaştır
  410. # Çapraz döviz analizi
  411. EUR/TRY ve GBP/TRY kurlarının güncel durumunu karşılaştır ve arbitraj fırsatlarını değerlendir
  412. # Yakıt fiyat takibi
  413. Dizel, benzin ve LPG fiyatlarının güncel durumunu ve haftalık değişimlerini analiz et
  414. # Yakıt fiyat karşılaştırması
  415. Son 3 aylık dizel ve benzin fiyat trendlerini karşılaştır ve analiz et
  416. # Haftalık ekonomik takvim (çoklu ülke)
  417. Bu haftanın önemli ekonomik olaylarını TR,US,DE için listele ve piyasa etkilerini değerlendir
  418. # Tek ülke ekonomik takip
  419. Sadece Almanya'nın bu ayki ekonomik verilerini getir ve analiz et
  420. # Çoklu ülke ekonomik karşılaştırma
  421. TR,US,GB,FR,DE ülkelerinin bu haftaki tüm ekonomik verilerini karşılaştır
  422. # Ekonomik veri analizi
  423. Türkiye ve ABD'nin son çeyrek GDP büyüme verilerini karşılaştır ve trend analizini yap
  424. # TCMB TÜFE enflasyon analizi
  425. Son 2 yılın tüketici enflasyon verilerini getir ve trend analizini yap
  426. # TCMB ÜFE enflasyon analizi
  427. Üretici enflasyonunun son 1 yılını analiz et ve TÜFE ile karşılaştır
  428. # Enflasyon dönemsel analizi
  429. 2022-2024 yüksek enflasyon dönemini hem TÜFE hem ÜFE açısından analiz et
  430. # TÜFE vs ÜFE karşılaştırması
  431. Son 12 aylık TÜFE ve ÜFE verilerini karşılaştır ve fiyat geçişkenliğini analiz et
  432. # Güncel enflasyon durumu
  433. Son 6 aylık hem tüketici hem üretici enflasyon verilerini al ve Merkez Bankası hedefleriyle karşılaştır
  434. # TCMB enflasyon hesaplayıcı analizi
  435. 2020'deki 100 TL'nin bugünkü satın alma gücünü hesapla
  436. # Yüksek enflasyon dönemi analizi
  437. 2021-2024 yüksek enflasyon döneminde 1000 TL'nin değişimini hesapla ve kümülatif enflasyon etkisini analiz et
  438. # Uzun dönemli satın alma gücü analizi
  439. 2010'dan bugüne 5000 TL'lik maaşın satın alma gücündeki değişimi hesapla
  440. # Kısa dönemli enflasyon hesaplaması
  441. Son 6 aylık enflasyon etkisini hesapla ve yıllık bazda projeksiyon yap
  442. # Ekonomik kriz dönemleri karşılaştırması
  443. 2001, 2008 ve 2018 ekonomik krizlerinin enflasyon etkilerini karşılaştır
  444. # Kontrat endeksleme hesaplaması
  445. Kira sözleşmelerinin enflasyon ayarlaması için gerekli artış oranını hesapla
  446. ```
  447. ---
  448. 📜 **Lisans**
  449. Bu proje MIT Lisansı altında lisanslanmıştır. Detaylar için `LICENSE` dosyasına bakınız.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.