API dan server MCP Citevana

REST API

Setiap respons berformat JSON. Respons yang berhasil berisi "ok": true. Alat gratis mengembalikan ringkasan dalam bahasa sederhana dan daftar tugas yang diurutkan berdasarkan kepentingan, lengkap dengan perkiraan waktu.

Contoh permintaan

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"

Error

Semua error menggunakan bentuk JSON yang sama, seperti di bawah. Kode error mencakup invalid_request, invalid_url, blocked_host, fetch_failed, unauthorized, insufficient_scope, not_found, rate_limited, dan quota_exceeded.

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

Batas dan header

Setiap respons yang diukur menyertakan X-RateLimit-Limit, X-RateLimit-Remaining, dan X-RateLimit-Reset (detik Unix). Respons 429 juga menyertakan Retry-After. Panggilan dengan kunci dihitung terhadap kuota harian api_calls ruang kerja Anda, dan setiap kunci dapat memiliki batas harian sendiri yang lebih rendah.

Browser dapat memanggil endpoint alat gratis dari situs mana pun tanpa kunci. Endpoint yang memerlukan kunci tidak mengizinkan permintaan browser lintas origin, jadi panggil dari server Anda.

Tambahkan ?locale=es, pt-BR, de, fr, ja, id, hi, tr, vi, atau ar ke endpoint alat untuk mendapatkan ringkasan dalam bahasa tersebut.

Sumber, diperiksa 16 September 2026: https://spec.openapis.org/oas/v3.1.1.html

Server MCP

Hubungkan klien MCP apa pun yang mendukung server jarak jauh ke https://citevana.com/api/mcp. Server ini menggunakan transport Streamable HTTP, merespons dalam JSON, dan tidak menyimpan sesi.

• check_ai_crawlers — Crawler pencarian, asisten, dan pelatihan AI mana yang diizinkan sebuah situs. Gratis.
• audit_page — Audit SEO on-page dan kesiapan AI untuk satu URL. Gratis.
• generate_llms_txt — Membuat file llms.txt dari nama situs, ringkasan, dan tautan. Gratis; tidak ada yang diambil dari web.
• get_site_audit_summary — Audit terbaru untuk salah satu situs Anda. Memerlukan kunci API dengan read:audits.

Server mendukung revisi protokol 2026-07-28 (metadata per permintaan dan server/discover). Server juga menerima handshake initialize dari revisi 2025-11-25, 2025-06-18, dan 2025-03-26.

Tiga tool gratis berfungsi tanpa autentikasi. Untuk get_site_audit_summary, klien Anda harus mengirim kunci API sebagai header Authorization: Bearer. Citevana belum menyediakan masuk dengan OAuth untuk MCP.

{
  "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": {}
    }
  }
}

Sumber, diperiksa 16 September 2026: https://modelcontextprotocol.io/specification/2026-07-28/basic/transports/streamable-http

Klien MCP lain dan agen Anda sendiri

Jika klien Anda memungkinkan pengaturan header HTTP untuk server jarak jauh, tambahkan Authorization: Bearer diikuti kunci Anda untuk membuka get_site_audit_summary. Setiap panggilan dihitung terhadap kuota harian api_calls yang sama dengan REST API.

Ekstensi Chrome

Ekstensi Chrome Citevana menjalankan pemeriksaan crawler AI dan audit halaman pada tab yang sedang Anda buka melalui API ini. Tidak perlu akun, dan kunci opsional akan menampilkan audit situs Anda sendiri. Ekstensi ini sedang disiapkan untuk Chrome Web Store.

Ekstensi ini hanya meminta izin activeTab dan storage, serta akses ke API Citevana. Alamat halaman hanya dikirim saat Anda mengklik pemeriksaan, dan query string tidak pernah dikirim.

Sumber, diperiksa 16 September 2026: https://developer.chrome.com/docs/extensions/develop/concepts/activeTab

Keamanan dan privasi

• Setiap tool bersifat hanya-baca. Tidak ada yang pernah diubah di situs web Anda.
• Teks yang disalin dari halaman yang diambil ditandai sebagai data tidak tepercaya, sehingga asisten AI tidak boleh mengikuti instruksi di dalamnya.
• Kami hanya mengambil halaman publik, sebagai CitevanaBot, dan memblokir alamat jaringan pribadi dan khusus.
• Kami hanya menyimpan hash SHA-256 dari setiap kunci API. Kunci hanya ditampilkan sekali, dan Anda dapat mencabutnya kapan saja. Pembuatan dan pencabutan kunci dicatat di log audit.

CitevanaBot

Pertanyaan umum

Sumber

• 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