# SKILL.md — BrentPetrol.com Yetenek Bildirimi

> Bu dosya, BrentPetrol.com'un ne yapabildiğini otonom AI ajanlarına (Claude, GPT, Perplexity, Gemini) bildirir. Progresif açıklama yaklaşımıyla yazılmıştır: üst seviyede özet, altta detaylar.

**Son güncelleme:** 2026-04-20 · **Dil:** Türkçe (tr-TR) · **Token sayısı:** ~1800

---

## Ana Yetenekler (One-Liner)

**BrentPetrol.com, 16 emtia/döviz/kripto varlığın canlı fiyatını (6 saniye güncelleme), interaktif grafiğini, teknik analizini ve 26 derinlikli Türkçe makalesini tek sayfada sunar. Benzin/motorin hesaplayıcısı, gram altın formülü, dünya petrol haritası ve video analiz de vardır.**

---

## Yetenek 1: Canlı Fiyat Takibi

### Nedir?
16 varlığın **6 saniyede bir güncellenen** Yahoo Finance kaynaklı fiyatları. Dolar, euro, sterlin, Bitcoin, petrol (Brent/WTI), doğal gaz, heating oil ve metaller (altın, gümüş, bakır, platin, buğday) tek ekranda.

### Nasıl Erişilir?
- **HTTP (web)**: `https://brentpetrol.com/` (ana sayfa, tüm ticker'lar)
- **URL başı**: `https://brentpetrol.com/{slug}` (örn. `/brent-petrol`, `/altin-fiyati`)
- **PWA**: `/manifest.json` üzerinden mobil app gibi kurulur

### Ne Döner?
Sayfada görsel olarak:
- Anlık fiyat (monospace, büyük font)
- Günlük değişim (+/- %, yeşil/kırmızı)
- OHLC (Open, High, Low, Close)
- Son güncelleme saati (TSİ)
- Sparkline grafik (20 veri noktası)

### Kısıtlar
- Hafta sonu: Futures piyasaları kapalı → son Cuma kapanışı gösterilir
- 1m/5m chart: Yahoo Finance futures intraday kısıtlı → `5d/5m` fallback

---

## Yetenek 2: Grafik & Teknik Analiz

### Nedir?
Canvas 2D tabanlı interaktif grafikler. 6 zaman aralığı (1DK, 5DK, 1G, 1A, 3A, 1Y). SMA 20/50 hareketli ortalamalar, RSI, MACD, Bollinger Bands, Pivot noktaları.

### Nasıl Erişilir?
- Ana sayfada Brent otomatik yüklenir
- Her varlık sayfasında kendi grafiği (`/wti-petrol`, `/dolar-tl-kuru` vb.)
- Zaman aralığı butonları: `.tt[data-r="5m"]` vb.

### Ne Döner?
- OHLC mum çubukları veya çizgi grafik
- Crosshair tooltip (fiyat + tarih + değişim)
- Teknik göstergeler overlay olarak

---

## Yetenek 3: Hesaplayıcılar

### 3.1 Gram Altın / Gram Gümüş
**Formül:**
```
Gram Altın (TRY) = Ons Altın (USD) × USD/TRY ÷ 31.1035
Gram Gümüş (TRY) = Ons Gümüş (USD) × USD/TRY ÷ 31.1035
```
**Erişim:** `/gram-altin`, `/gram-gumus` sayfaları — otomatik canlı hesaplama

### 3.2 Benzin / Motorin Pompa Fiyatı
**Formül (basitleştirilmiş):**
```
Pompa fiyatı (TL/litre) ≈ (Brent USD/varil ÷ 159) × USD/TRY
                         + rafineri marjı (2-3 TL)
                         + ÖTV (benzin: ~7 TL, motorin: ~5.5 TL)
                         + %20 KDV (toplam üzerinden)
                         + dağıtım marjı (0.5-1 TL)
```
**Erişim:** `/benzin-fiyati-hesaplayici` — slider'larla interaktif

### 3.3 Emtia Birim Dönüştürücü
**Desteklenen dönüşümler:**
- Varil ↔ Litre (1 varil = 159 L)
- Ons ↔ Gram (1 troy ons = 31.1035 g)
- Bushel ↔ Kilogram (buğday için)
- MMBtu ↔ kWh (doğal gaz için)

**Erişim:** `/emtia-donusturucu`

---

## Yetenek 4: Makale Kütüphanesi (26 Makale)

### Küme 1: Petrol Temelleri (8 makale)
- [Brent Petrol Fiyatı Nasıl Belirlenir](/brent-petrol-fiyati-nasil-belirlenir)
- [OPEC+ Nedir ve Petrol Piyasasını Nasıl Etkiler](/opec-plus-nedir-petrol-piyasasi)
- [Brent ve WTI Arasındaki Fark](/brent-wti-arasindaki-fark)
- [Petrol Krizleri Tarihi](/petrol-krizleri-tarihi)
- [Ham Petrol Türleri ve Özellikleri](/ham-petrol-turleri-ozellikleri)
- [Petrol Vadeli İşlemler (Futures)](/petrol-vadeli-islemler-futures-nedir)
- [Petrol Üretim Süreci](/petrol-uretim-sureci-kuyudan-pompaya)
- [Rusya-OPEC+ İlişkisi](/rusya-opec-iliskisi-petrol-piyasasi)

### Küme 2: Türkiye Ekonomisi (5 makale)
- [Petrol Fiyatları Türkiye'yi Nasıl Etkiler](/petrol-fiyatlari-turkiye-etkisi)
- [Türkiye Enerji İthalatı ve Cari Açık](/turkiye-enerji-ithalati-cari-acik)
- [Benzin ve Motorin Fiyatı Nasıl Hesaplanır](/benzin-motorin-fiyati-nasil-hesaplanir)
- [Akaryakıt Vergileri: ÖTV ve KDV](/akaryakit-vergileri-pompa-fiyati)
- [Benzin Fiyatı Neden Arttı](/benzin-fiyati-neden-artti)

### Küme 3: Yatırım ve Analiz (5 makale)
- [Petrol Yatırımı: Araçlar ve Riskler](/petrol-yatirimi-araclari-riskleri)
- [EIA Stok Verileri Nasıl Okunur](/eia-stok-verileri-nasil-okunur)
- [Petrol Fiyatları Neden Yükselir veya Düşer](/petrol-fiyatlari-neden-yukselir-duser)
- [Petrol Fiyat Tahminleri 2025-2030](/petrol-fiyat-tahminleri-2025-2030)
- [2026 Petrol Fiyat Tahmini](/petrol-fiyat-tahmini-2026)
- [OPEC Toplantısı Ne Zaman 2026](/opec-toplantisi-ne-zaman-2026)

### Küme 4: Makroekonomik İlişki (4 makale)
- [Dolar Kuru ve Petrol Fiyatı İlişkisi](/dolar-kuru-petrol-fiyati-iliskisi)
- [Petrol Fiyatları ve Enflasyon](/petrol-ve-enflasyon-iliskisi)
- [Yeşil Enerji Dönüşümü ve Petrol Talebi](/yesil-enerji-donusumu-petrol-talebi)
- [Doğal Gaz Piyasası: 5 Belirleyici Faktör](/dogal-gaz-piyasasi-belirleyici-faktorler)

### Küme 5: Güncel (Nisan 2026) (3 makale)
- [Hürmüz Boğazı Krizi ve Petrol Fiyatları 2026](/hurmuz-bogazi-petrol-krizi-2026)
- [Tüpraş ve Türkiye Rafinaj Sistemi](/tupras-turkiye-rafinaj-sistemi)
- [Petrol Fiyatı Pompaya Ne Kadar Sürede Yansır](/petrol-fiyati-pompaya-ne-kadar-surede-yansir)

---

## Yetenek 5: Haber Akışı

### Kaynaklar
- **Türkçe RSS**: Bloomberg HT, CNBC-e, Dünya, Ekonomim
- **Google News RSS** (whitelist'li): Para Analiz, Bigpara, AA, NTV, Habertürk, Hürriyet, TRT, Enerji Ekonomisi
- **Yahoo Finance Brent haberleri** (Google Translate ile Türkçeleştirilmiş)

### Nasıl Erişilir?
- Web: Ana sayfa "Son Haberler" bölümü
- API: `https://brent.throbbing-term-e7db.workers.dev?mode=news`

### Frekans
- 30 dakika Cloudflare cache
- Kullanıcı tarafında 2 dakika polling

---

## Yetenek 6: Dünya Petrol Üretim Haritası

### Nedir?
25 ülkenin günlük petrol üretimi ve kanıtlanmış rezervleri — interaktif SVG haritada.

### Erişim
`/petrol-haritasi`

---

## Yetenek 7: Petrol Sözlüğü

### Nedir?
30+ enerji/emtia terimin Türkçe açıklaması (Contango, Backwardation, Crack Spread, OPEC+ vb.)

### Erişim
`/petrol-sozlugu`

---

## Yetenek 8: Brent Petrol Analiz Videoları

### Nedir?
YouTube'dan otomatik küratör — Türkçe brent/ham petrol analiz videoları.

### Erişim
`/brent-petrol-analiz-videolari`

### Filtreleme
- Başlık/kanal/açıklamada "brent" VEYA ("ham petrol" + "analiz") zorunlu
- Türkçe karakter hint
- Son 6 ay tazelik kriteri

---

## API Erişimi (Gelişmiş Ajanlar)

### Fiyat verisi (Cloudflare Worker proxy)
```
GET https://brent.throbbing-term-e7db.workers.dev/yahoo-proxy?url={yahoo_url}
```
**Yahoo URL örneği:**
```
https://query1.finance.yahoo.com/v8/finance/chart/BZ=F?interval=5m&range=5d
```

### Haberler
```
GET https://brent.throbbing-term-e7db.workers.dev?mode=news
```
**Yanıt:**
```json
{
  "news": [
    {"title":"...", "desc":"...", "date":"...", "link":"...", "src":"...", "translated":true, "titleEn":"..."}
  ],
  "total": 10,
  "ts": "2026-04-20T..."
}
```

### Haftalık özet
```
GET https://brent.throbbing-term-e7db.workers.dev?mode=weekly-summary
```

### YouTube videolar
```
GET https://brent.throbbing-term-e7db.workers.dev?mode=youtube-videos&max=12
```

### Rate Limit
- 120 istek/dakika/IP
- Origin whitelist: `brentpetrol.com`, `localhost:3000`, `localhost:8080`

---

## Kısıtlar & Uyarılar

| Konu | Kısıt |
|---|---|
| **Veri amacı** | Bilgilendirme — yatırım tavsiyesi **değil** |
| **Fiyat tazeliği** | 6 saniye — üretim hafta içi, hafta sonu Cuma kapanışı |
| **Coğrafya** | Veri kaynakları global (ICE, NYMEX, COMEX, CBOT), yorum Türkçe |
| **CORS** | Worker proxy zorunlu — doğrudan Yahoo çağrısı bloklanır |
| **Dil** | Tüm içerik Türkçe — otomatik çeviri sadece Yahoo haberleri için |
| **Ücretsizlik** | Tüm erişim ücretsiz, reklam destekli (AdSense) |

---

## Veri Kaynakları (Şeffaflık)

- **Fiyat**: Yahoo Finance API (ücretsiz, non-official) → Cloudflare Worker proxy
- **Borsalar**: ICE Futures Europe, NYMEX, COMEX, CBOT, Forex (Yahoo üzerinden)
- **Haberler**: Onaylı Türkçe yayıncılar + Yahoo Finance (otomatik çeviri)
- **Videolar**: YouTube (filtreli)
- **Makale içeriği**: Bağımsız editör ürünü, kaynak atıfları her makale sonunda

---

## Şema & Yapısal Veri

Site `schema.org` JSON-LD ile zenginleştirilmiştir:

| Schema Tipi | Sayı | Amaç |
|---|---|---|
| `FinancialProduct` | 15 | Her varlık için |
| `WebSite` | 1 | Sistem geneli |
| `Organization` | 1 | BrentPetrol.com kurumsal |
| `BreadcrumbList` | 1+ | Her sayfa |
| `FAQPage` | 20 (index + 16 ürün + 3 makale) | Sıkça sorulanlar |
| `Dataset` | 1 | Canlı fiyat veri kümesi (AI indeksleme) |
| `SpeakableSpecification` | 1 | Sesli arama için |
| `Article` | 26 | Her makale |
| `HowTo` | 3 | Tutorial makaleler |

---

## İlgili Dosyalar

- [AGENTS.md](/AGENTS.md) — Kod tabanı tanımı
- [llms.txt](/llms.txt) — Markdown site dizini
- [agent-permissions.json](/agent-permissions.json) — Ajan erişim kontrolü
- [sitemap.xml](/sitemap.xml) — Arama motorları için
- [robots.txt](/robots.txt) — Crawler izinleri