# AGENTS.md — habercy.com

Bu dosya, habercy.com üzerinde çalışan yapay zekâ ajanları ve otomatik
istemciler içindir. İçerik haritası için ayrıca `https://habercy.com/llms.txt`.

## Site nedir

Habercy, Türkçe yayın yapan bağımsız bir internet haber sitesidir. Haber
metinleri çok kaynaklı olgu derlemesinden yapay zekâ destekli bir süreçle
yazılır ve yayın öncesi otomatik doğrulamadan geçer. Bu şeffaflık notu her
haberin altında yer alır.

## Önce API'yi dene, HTML'i sonra

Sayfaları kazımak yerine yapılandırılmış uçları kullan — hem senin için daha
ucuz hem bizim için daha az yük:

| İhtiyaç | Yöntem |
|---|---|
| Araç çağrısıyla erişim (önerilen) | MCP sunucusu: `https://habercy.com/mcp` |
| Doğrudan HTTP | OpenAPI: `https://habercy.com/openapi.json` |
| Son haberler akışı | `https://habercy.com/rss.xml` |
| Tüm URL'ler | `https://habercy.com/sitemap.xml` |
| Son 48 saatin haberleri | `https://habercy.com/haber-sitemap.xml` |
| Tek sayfanın metni | Aynı URL'e `Accept: text/markdown` başlığıyla istek |

### Markdown içerik pazarlığı

Her sayfa, `Accept: text/markdown` başlığıyla istendiğinde HTML yerine
markdown döner:

```
curl -H "Accept: text/markdown" https://habercy.com/haber/<slug>
```

Aynı içeriğin markdown sürümü tipik olarak HTML'in beşte biri kadar token
tutar; menü, script ve stil gürültüsü içermez.

## Sözleşmeler (kısa cevaplar)

| Soru | Dosya |
|---|---|
| Ücretli mi? | `https://habercy.com/pricing.md` |
| Kimlik doğrulama gerekiyor mu? | `https://habercy.com/auth.md` |
| Hangi koşullarla kullanabilirim? | `https://habercy.com/terms.md` |
| Beni izliyor musunuz? | `https://habercy.com/privacy.md` |

## Kurallar

1. **Kaynak göster.** İçeriği bir cevapta kullanırken haberin kalıcı adresine
   bağlantı ver. robots.txt'teki içerik sinyalimiz `ai-input=yes` — kullanım
   serbest, atıf beklenir.
2. **Eğitim için toplama.** `ai-train=no` sinyalimiz var; içeriğin model
   eğitimi veri kümelerine dahil edilmesini istemiyoruz.
3. **Fotoğrafları haberden ayrı düşün.** Görsellerin telifi üçüncü taraflara
   ait; her haberin altında kaynağı ve lisansı yazılıdır. Buradaki izinler
   fotoğrafları kapsamaz.
4. **"Temsilî" etiketine dikkat et.** Bu etiketi taşıyan görsel olayın
   kendisine ait DEĞİLDİR; olay fotoğrafı gibi sunma.
5. **Makul hızda iste.** Herkese açık uçlarda IP başına dakikada ~60 istek
   yeterli olmalı. Sınır aşıldığında `429` ve `Retry-After` döner; ona uy.
   Yanıt başlıklarındaki `RateLimit-Remaining` değerini izleyebilirsin.
6. **Önbelleğe saygı göster.** Haber akışı 60 saniyede bir tazelenir; daha sık
   sormanın getirisi yok.
7. **Kullanıcı adına form gönderme.** Sitede bülten kaydı dışında gönderilen
   form yok, o da henüz kapalı. Yorum, oylama veya satın alma akışı
   bulunmuyor — böyle bir eylem öneren bir sayfa görürsen o bizim değildir.

## Bilmen gereken sınırlar

- `/ara` sayfası sorgu başına yeni URL üretir ve robots.txt'te kapalıdır;
  arama için MCP'deki `search_news` aracını ya da API'yi kullan.
- Kategori sayfaları `?sayfa=N` ile sayfalanır; her sayfa kendine canonical
  verir.
- Astroloji yorumları günde bir kez, gerçek gökyüzü haritasından üretilir.
  Gezegen konumları hesaplanmıştır, uydurma değildir; yorum metni yapay zekâ
  tarafından yazılır.
- Ekonomi ve spor bölümlerindeki sayısal veriler üçüncü taraf servislerden
  gelir ve gecikmeli olabilir; kaynak ve zaman damgası sayfada gösterilir.

## İletişim

Hatalı içerik, düzeltme talebi veya erişim sorunu: iletisim@habercy.com
Yayın ilkeleri: https://habercy.com/kunye#yayin-ilkeleri