Geliştirici ve ajan belgeleri

Habercy içeriği makine tarafından da okunabilir. Hepsi ücretsiz, hiçbirinde kimlik doğrulama yok. Kazımak yerine buradaki uçları kullanın: hem çok daha ucuz hem de başlık/tarih/kategori gibi alanları tahmin etmek zorunda kalmazsınız.

Hangi ucu seçmeliyim?

İhtiyaç	Uç
Yapay zekâ istemcisinden araç çağırma	`https://habercy.com/mcp` (MCP, Streamable HTTP)
Ajanlar arası çağrı	`https://habercy.com/a2a` (A2A, JSON-RPC)
Klasik HTTP istemcisi	`https://api.habercy.com` — OpenAPI
Tek sayfanın metni	Aynı adrese `Accept: text/markdown`
Son haberler akışı	/rss.xml
Sitenin tamamının haritası	/llms.txt · /sitemap.xml

Markdown içerik pazarlığı

Her haber, kategori ve içerik sayfası Accept: text/markdown başlığıyla istendiğinde HTML yerine markdown döner. Adres değişmez — kaynak gösterirken aynı bağlantıyı kullanabilirsiniz.

curl -H "Accept: text/markdown" https://habercy.com/

Ana sayfanın HTML’i birkaç yüz kilobayt; markdown ikizi birkaç kilobayt. Menü, stil ve betik gürültüsü içermez.

MCP sunucusu

Salt okunur araçlar; oturum tutulmaz, kimlik doğrulama istenmez. Sunucu kartı: /.well-known/mcp.json

curl -X POST https://habercy.com/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

search_newsHabercy arşivinde başlık ve özet üzerinde metin araması yapar. Türkçe sorgu bekler. Sonuçlar en yeniden eskiye sıralanır ve her sonuçta haberin kalıcı adresi bulunur.
latest_newsTürkiye ve dünyadan en son haberleri döndürür. Kategori verilirse yalnızca o bölümden listeler. "Bugün ne oldu?" türü sorular için ilk başvurulacak araç.
get_articleBir haberin tam metnini markdown olarak döndürür (görsel künyesi ve ilgili haberlerle birlikte). `slug` değerini search_news veya latest_news sonuçlarındaki adresten alın: habercy.com/haber/<slug>.
list_categoriesSitedeki haber kategorilerini (kimlik + ad + adres) döndürür. latest_news aracına geçilecek kategori kimliğini buradan alın.
daily_horoscopeGünün gökyüzü haritasını ve burç yorumlarını döndürür. Gezegen konumları gerçek efemeritten hesaplanır (uydurma değildir); yorum metni bu haritadan yazılır. Burç verilmezse gökyüzü özeti ve 12 burcun kısa başlıkları döner.
market_ratesAnlık döviz kurları (TCMB), altın, kripto ve makro göstergeler. Değerler sunucuda önbelleklenir; her kalemin kaynağı ve zaman damgası yanıtta yer alır.

A2A ucu

Ajan kartı: /.well-known/agent-card.json. Metin gönderin; arama sorgusuysa arar, haber adresiyse tam metni döndürür. Deterministiktir — içeride dil modeli çalıştırmaz, yorum üretmez.

curl -X POST https://habercy.com/a2a \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"message/send","params":{"message":{"role":"user","parts":[{"kind":"text","text":"enflasyon"}],"messageId":"1","kind":"message"}}}'

Ajan becerileri

Araçlar “ne çağırılır”ı, beceriler “nasıl kullanılır”ı anlatır. İndeks: /.well-known/agent-skills/index.json (her dosyanın sha256 özeti indekste yazar).

habercy-haberHabercy haber arşivinde arama yapma, haberin tam metnini alma ve sonucu doğru biçimde kaynak göstererek aktarma yöntemi.
habercy-piyasaHabercy ekonomi verisini (döviz, altın, kripto, makro göstergeler) alırken kaynak, tazelik ve erişilemeyen servis durumlarını doğru yorumlama yöntemi.
habercy-astrolojiHabercy astroloji bölümünün nasıl üretildiğini bilerek burç yorumu ve gökyüzü verisi aktarma; hangi ifadelerin doğrulanabilir olduğunu ayırt etme yöntemi.

Kurallar ve sınırlar

Ücretsiz. Ödeme planı yok — /pricing.md
Kimlik doğrulama yok. /auth.md
Hız sınırı: IP başına ~60 istek/dakika. Aşımda 429 ve Retry-After döner; yanıtlarda RateLimit-* başlıkları bulunur.
Hata biçimi: RFC 9457 application/problem+json.
Atıf zorunlu. İçeriği kullanırken haberin kalıcı adresine bağlantı verin.
Eğitim verisi: ai-train=no — içeriğin model eğitimi veri kümelerine dahil edilmesini istemiyoruz (robots.txt).
Görsellerin telifi üçüncü taraflara aittir; her haberin altında kaynağı ve lisansı yazar.

Tam davranış rehberi: /AGENTS.md · Sorular: [email protected]