Citevana API'si ve MCP sunucusu

REST API

Tüm yanıtlar JSON biçimindedir. Başarılı yanıtlar "ok": true içerir. Ücretsiz araçlar sade bir özet ile önem sırasına göre dizilmiş, süre tahminli bir yapılacaklar listesi döndürür.

Örnek istek

curl -s https://citevana.com/api/v1/tools/ai-crawlers \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com"}'

curl -s https://citevana.com/api/v1/sites \
  -H "Authorization: Bearer $CITEVANA_API_KEY"

Hatalar

Tüm hatalar aşağıda gösterilen aynı JSON yapısını kullanır. Hata kodları arasında invalid_request, invalid_url, blocked_host, fetch_failed, unauthorized, insufficient_scope, not_found, rate_limited ve quota_exceeded bulunur.

{
  "ok": false,
  "error": {
    "code": "quota_exceeded",
    "message": "Daily api_calls quota reached."
  },
  "requestId": "req_…"
}

Limitler ve üst bilgiler

Ölçülen her yanıt X-RateLimit-Limit, X-RateLimit-Remaining ve X-RateLimit-Reset (Unix saniyesi) içerir; bunlar çağrının hangi hakka sayıldığını gösterir. 429 yanıtı ayrıca Retry-After içerir. Anahtarsız çağrılar internet bağlantınızın paylaşılan ücretsiz araç hakkından, anahtarlı çağrılar ise çalışma alanınızın günlük api_calls hakkından düşer; her anahtarın kendine ait daha düşük bir günlük sınırı olabilir. Siteye ulaşılamadığı ya da bot koruması yanıt verdiği için sonuç döndürmeyen bir çağrı hiç sayılmaz.

Tarayıcılar ücretsiz araç uç noktalarını herhangi bir siteden anahtar olmadan çağırabilir. Anahtar gerektiren uç noktalar çapraz kaynaklı tarayıcı isteklerine izin vermez; bunları sunucunuzdan çağırın.

Özeti o dilde almak için bir araç uç noktasına ?locale=es, pt-BR, de, fr, ja, id, hi, tr, vi veya ar ekleyin.

Kaynak, 16 Eylül 2026 tarihinde kontrol edildi: https://spec.openapis.org/oas/v3.1.1.html

MCP sunucusu

Uzak sunucuları destekleyen herhangi bir MCP istemcisini https://citevana.com/api/mcp adresine bağlayın. Sunucu Streamable HTTP aktarımını kullanır, JSON ile yanıt verir ve oturum tutmaz.

• check_ai_crawlers — Bir sitenin hangi yapay zekâ arama, asistan ve eğitim tarayıcılarına izin verdiği. Ücretsiz.
• audit_page — Tek bir URL için sayfa içi SEO ve yapay zekâya hazırlık denetimi. Ücretsiz.
• generate_llms_txt — Site adı, özet ve bağlantılardan bir llms.txt dosyası oluşturur. Ücretsiz; hiçbir şey getirilmez.
• get_site_audit_summary — Sitelerinizden birinin en son denetimi. read:audits yetkili bir API anahtarı gerektirir.

Sunucu 2026-07-28 protokol revizyonunu (istek başına meta veriler ve server/discover) destekler. Ayrıca 2025-11-25, 2025-06-18 ve 2025-03-26 revizyonlarının initialize el sıkışmasını da kabul eder.

Üç ücretsiz araç kimlik doğrulama olmadan çalışır ve internet bağlantısı başına günde 3 kontrollük anahtarsız hakkı paylaşır. get_site_audit_summary için istemcinizin API anahtarınızı Authorization: Bearer üst bilgisi olarak göndermesi gerekir; bu aynı zamanda günlük hakkı da yükseltir. Citevana henüz MCP için OAuth ile giriş sunmuyor.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "check_ai_crawlers",
    "arguments": {
      "url": "https://example.com"
    },
    "_meta": {
      "io.modelcontextprotocol/protocolVersion": "2026-07-28",
      "io.modelcontextprotocol/clientCapabilities": {}
    }
  }
}

Kaynak, 16 Eylül 2026 tarihinde kontrol edildi: https://modelcontextprotocol.io/specification/2026-07-28/basic/transports/streamable-http

Diğer MCP istemcileri ve kendi ajanlarınız

İstemciniz uzak sunucu için HTTP üst bilgisi ayarlamanıza izin veriyorsa, get_site_audit_summary'yi kullanmak için Authorization: Bearer ve ardından anahtarınızı ekleyin. Anahtarlı bir çağrı REST API ile aynı günlük api_calls hakkından düşer; anahtarsız çağrı ise paylaşılan ücretsiz araç hakkından düşer.

Chrome uzantısı

Citevana Chrome uzantısı, bu API aracılığıyla görüntülediğiniz sekmede yapay zekâ tarayıcı kontrolünü ve sayfa denetimini çalıştırır. Hesap gerektirmez ve anahtarsız hakkı kullanır; isteğe bağlı bir anahtar bu sınırı yükseltir ve kendi site denetimlerinizi gösterir. Chrome Web Mağazası için hazırlanıyor.

Yalnızca activeTab ve storage izinlerini ve Citevana API'sine erişimi ister. Sayfa adresini yalnızca bir kontrole tıkladığınızda gönderir ve sorgu dizesini asla göndermez.

Kaynak, 16 Eylül 2026 tarihinde kontrol edildi: https://developer.chrome.com/docs/extensions/develop/concepts/activeTab

Güvenlik ve gizlilik

• Tüm araçlar salt okunurdur. Web sitenizde hiçbir şey değiştirilmez.
• Getirilen sayfalardan kopyalanan metin güvenilmeyen veri olarak işaretlenir; bu nedenle yapay zekâ asistanları içindeki talimatları asla uygulamamalıdır.
• Yalnızca herkese açık sayfaları CitevanaBot olarak getiririz ve özel ile ayrılmış ağ adreslerini engelleriz.
• Her API anahtarının yalnızca SHA-256 karmasını saklarız. Anahtar bir kez gösterilir ve istediğiniz zaman iptal edebilirsiniz. Anahtar oluşturma ve iptal işlemleri denetim günlüğüne kaydedilir.

CitevanaBot

Sıkça sorulan sorular

Kaynaklar

• https://modelcontextprotocol.io/specification/2026-07-28/basic/transports/streamable-http
• https://modelcontextprotocol.io/specification/2026-07-28/basic/versioning
• https://developers.openai.com/apps-sdk/deploy/connect-chatgpt
• https://developers.openai.com/apps-sdk/build/auth
• https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp
• https://spec.openapis.org/oas/v3.1.1.html
• https://developer.chrome.com/docs/extensions/develop/concepts/activeTab
• https://developer.chrome.com/docs/webstore/program-policies/policies