Veri

Yapay zekâ ajanları ve geliştiriciler için Citoyen

Citoyen'in rakamlarını yalnızca ekrandaki insanlar değil, yapay zekâ asistanları ve programlar da okuyabilir. Herkese açık, salt okunur bir sunucu onlara kartlardaki serilerin aynısını verir; her biri resmî üreticisi, dönemi ve birimiyle birlikte gelir, böylece bir yanıt bir rakamın nereden geldiğini söyleyebilir.

MCP sunucusu

Model Context Protocol (MCP), Claude veya ChatGPT gibi asistanların dış araçları çağırmak için kullandığı standarttır. Citoyen'in sunucusu ücretsizdir, anahtar ya da hesap gerektirmez ve yalnızca okur: sorulan sorulardan hiçbir şey saklamaz, hizmetin erişilebilir kalması için yalnızca çağrıları sayar.

Sunucu adresi

https://citoyenapp.com/mcp

Bağlantı kurma

  1. Claude'da

    claude.ai'de veya masaüstü uygulamasında: Ayarlar, Bağlayıcılar, Özel bağlayıcı ekle, ardından sunucu adresini yapıştırın.

  2. Diğer asistanlarda

    Geliştirici modundaki ChatGPT ve uzak MCP sunucularını kabul eden diğer asistanlar: sunucu adresiyle bir HTTP bağlayıcısı ekleyin.

  3. Bir kod düzenleyicide

    Cursor, VS Code, Claude Code ve benzeri araçlar: sunucuyu aşağıdaki gibi MCP yapılandırmalarına ekleyin.

MCP dosyası okuyan istemciler için yapılandırma:

{
  "mcpServers": {
    "citoyen": {
      "type": "http",
      "url": "https://citoyenapp.com/mcp"
    }
  }
}

Araçlar

search
Göstergeleri kodlarıyla, soruda adı geçen ülkeleri ve ilgili yayınları bulur.
get_series
Bir ülke için bir göstergenin serisi, kartında gösterildiği gibi: döneme göre değerler, birim, üretici ve kaynağa bağlantı. Varsayılan olarak son 10 yıl.
compare_countries
2 ile 8 ülke için tek bir uyumlaştırılmış kaynaktan bir gösterge, böylece değerler karşılaştırılabilir.
get_ranking
Kapsanan tüm ülkeler, ortak son dönem için bir göstergede en yüksek değerden en düşüğe sıralanır.
get_publication
Bir sentez notunun, analizin veya reform bilgi notunun ana noktaları, tam metnin bağlantısıyla.
get_release_calendar
Serilerin sonraki yayınları: üreticinin resmî tarihleri veya tahmini zaman aralıkları.

Sınırlar ve kurallar

  • Adres başına dakikada 60 çağrı. Bunun üzerinde sunucu biraz sonra tekrar denemenizi ister.
  • Seriler varsayılan olarak 10 yılı kapsar (istek üzerine 80 yıla kadar, yanıt başına en fazla 600 nokta); bir karşılaştırma 2 ile 8 ülkeyi kapsar.
  • Özel üreticilerin serileri ve SIPRI'nin Dünya Bankası aracılığıyla yayımladığı askerî seriler yalnızca son değerlerini ve karta bağlantıyı verir: koşulları tam serinin aktarılmasına izin vermez.
  • Yayınlar ana noktalarını ve bağlantıyı verir, asla tam metni vermez.
  • Projeksiyon olarak işaretlenen değerler tahmindir, asla gerçekleşmiş rakam değildir.
  • Her yanıt üreticisini belirtir: onu, yanıtta verilen Citoyen sayfasının bağlantısıyla birlikte kaynak gösterin.
  • Çağrılar, IP adresinden türetilen ve her gün değişen anonim bir anahtarla günlük olarak sayılır; adresin kendisi hiçbir zaman saklanmaz, sayımlar 30 gün tutulur.

Diğer erişim yolları

  • Her gösterge sayfası serisini CSV olarak sunar: adresine /data.csv ekleyin (özel üreticilerin serileri hariç).
  • Yapay zekâ tarayıcıları için düz metin site haritası: /llms.txt
  • Her kart, « Göm » düğmesiyle başka bir siteye yerleştirilebilir.

Kaynak gösterme

Her rakamla birlikte adı verilen resmî üreticiyi ve rakamın okunduğu yer olarak Citoyen'i, sayfasının bağlantısıyla birlikte belirtin.

Citoyen'in seçimleri, kontrolleri ve metinleri korunmaktadır ve veri tabanının sistematik olarak çekilmesine izin verilmez. Ayrıntılar: Yasal bilgiler