Geliştirici Kaynakları

askinkilic.com.tr içeriğini yalnızca tarayıcıda okunmak üzere değil, programatik olarak da kullanılabilecek şekilde yayınlar. Bu sayfa, sitenin makine okunabilir yüzeyinin tamamını tek yerde toplar. Tüm uç noktalar herkese açıktır; kimlik doğrulama, API anahtarı veya kayıt gerekmez.

MCP Sunucusu

Site, Model Context Protocol sunucusu yayınlar. Claude, ChatGPT ve diğer yapay zeka istemcileri içeriği doğrudan araç olarak çağırabilir.

  • Uç nokta: POST https://www.askinkilic.com.tr/mcp
  • Taşıma: Streamable HTTP (JSON-RPC 2.0), protokol sürümü 2025-11-25
  • Manifest: /mcp.json ve /.well-known/mcp.json
  • Oturum: yok (durumsuz) — her istek kendi başına yeterlidir
  • Yetki: salt okunur, yazma yolu yoktur

Sunduğu araçlar:

Araç Ne yapar
search_posts Yayınlanmış yazılarda tam metin arama; başlık, URL, slug, tarih ve özet döner
get_post_markdown Bir yazının tam metnini Markdown olarak verir (slug ile)
list_categories Tüm kategorileri yazı sayısı ve arşiv adresiyle listeler
get_glossary_term Azure, bulut ve yapay zeka terimlerinin Türkçe tanımları

Markdown Erişimi

Her yazının Markdown sürümü iki yolla alınabilir:

  • Uzantı ile: yazı adresinin sonuna .md ekleyin — /ornek-yazi.md
  • İçerik pazarlığı ile: aynı adrese Accept: text/markdown başlığıyla istek gönderin. Ana sayfa ve tekil yazılar text/markdown döner; Accept: text/html ile HTML dönmeye devam eder.

Bulunamayan adresler de Accept: text/markdown ile istendiğinde Markdown biçiminde hata gövdesi döner; gövde, siteye giriş noktalarının bağlantılarını içerir.

Site İndeksleri ve Ajan Talimatları

  • /llms.txt — sitenin özet indeksi: uzmanlık alanları, son yazılar, kategoriler, sözlük terimleri
  • /llms-full.txt — kategori bazlı tam içerik indeksi
  • /agent-instructions.md — bu kaynağın ne zaman kullanılması ve ne zaman kullanılmaması gerektiğini açıklayan yönlendirme belgesi
  • /.well-known/ai.txt — erişim ve atıf politikası
  • /ai/summary.json, /ai/faq.json, /ai/service.json — yapılandırılmış site özeti
  • /sitemap.xml ve /feed/

Yapılandırılmış Veri

Sayfalar JSON-LD ile işaretlenir: TechArticle, FAQPage, DefinedTerm, BreadcrumbList, Person ve Organization. İletişim sayfası ContactPage olarak tiplenmiştir ve yayıncı kimliğini (e-posta, konum) satır içi taşır.

Kullanım ve Atıf

İçerik yapay zeka sistemleri tarafından okunabilir ve alıntılanabilir. Atıf yaparken yazının URL’sini ve Aşkın KILIÇ adını belirtmeniz beklenir. Yazılar birincil kaynakların derlenmesinin ardından büyük dil modelleri ile hazırlanır, otomatik kalite kapısından geçirilir ve insan editör tarafından incelenir; sürecin tamamı Hakkımda sayfasında açıklanır.

Soru veya geri bildirim için iletişim sayfasını kullanabilirsiniz.