डेवलपर

Citevana API और MCP सर्वर

Citevana में एक मुफ़्त REST API और एक मुफ़्त MCP सर्वर है। इनसे आप जाँच सकते हैं कि AI क्रॉलर किसी साइट तक पहुँच सकते हैं या नहीं, SEO और AI रेडीनेस के लिए पेज ऑडिट कर सकते हैं, llms.txt फ़ाइल बना सकते हैं और अपनी साइट के ऑडिट पढ़ सकते हैं। टूल एंडपॉइंट के लिए कुंजी नहीं चाहिए: बिना कुंजी वे वेबसाइट के मुफ़्त टूल वाली ही सीमा साझा करते हैं — रोज़ 3 जाँच, जो हर इंटरनेट कनेक्शन के हिसाब से गिनी जाती हैं। मुफ़्त अकाउंट और API कुंजी इसे बढ़ाकर रोज़ 100 कॉल कर देते हैं और आपके वर्कस्पेस का डेटा भी खोल देते हैं।

पिछली समीक्षा 16 सितंबर 2026

मुख्य बातें

REST बेस URL: https://citevana.com/api/v1
ऑथेंटिकेशन: मुफ़्त टूल के लिए कुछ नहीं, नीचे बताई गई बिना-कुंजी वाली साझा सीमा के भीतर। अन्यथा वर्कस्पेस API कुंजी: Authorization: Bearer cv_live_…
मुफ़्त कोटा: बिना कुंजी: हर इंटरनेट कनेक्शन के लिए रोज़ 3 जाँच, जो वेबसाइट के मुफ़्त टूल के साथ साझा होती हैं। कुंजी के साथ: मुफ़्त प्लान पर रोज़ 100 कॉल। दोनों खिड़कियाँ UTC में हैं, और प्रति मिनट 20 की बर्स्ट सीमा है।
MCP एंडपॉइंट: https://citevana.com/api/mcp
MCP प्रोटोकॉल वर्शन: 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26
OpenAPI 3.1 विवरण: https://citevana.com/api/v1/openapi.json

REST API

हर रिस्पॉन्स JSON में होता है। सफल रिस्पॉन्स में "ok": true होता है। मुफ़्त टूल आसान भाषा में सारांश और महत्व के क्रम में टू-डू सूची लौटाते हैं, समय के अनुमान के साथ।

एंडपॉइंट
मेथड	पाथ	एक्सेस	यह क्या करता है
GET	/sites	read:sites वाली कुंजी	कुंजी के वर्कस्पेस की साइटों की सूची देता है।
GET	/sites/{siteId}/audits/latest	read:audits वाली कुंजी	सबसे हाल का पूरा हुआ साइट ऑडिट लौटाता है: स्कोर, समस्याएँ, AI रेडीनेस और टू-डू।
POST	/tools/ai-crawlers	कुंजी की ज़रूरत नहीं (साझा सीमा), या read:tools कुंजी	किसी साइट की robots.txt पढ़ता है और बताता है कि किन AI क्रॉलर को अनुमति है या वे ब्लॉक हैं।
POST	/tools/page-audit	कुंजी की ज़रूरत नहीं (साझा सीमा), या read:tools कुंजी	एक पेज का ऑडिट करता है: टाइटल, डिस्क्रिप्शन, हेडिंग, canonical, noindex, स्ट्रक्चर्ड डेटा और alt टेक्स्ट।
POST	/tools/llms-txt	कुंजी की ज़रूरत नहीं (साझा सीमा), या read:tools कुंजी	किसी साइट की llms.txt जाँचता है, या आपके भेजे लिंक से नई बनाता है।

उदाहरण अनुरोध

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"

एरर

सभी एरर एक ही JSON रूप में आती हैं, जो नीचे दिखाया गया है। एरर कोड में invalid_request, invalid_url, blocked_host, fetch_failed, unauthorized, insufficient_scope, not_found, rate_limited और quota_exceeded शामिल हैं।

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

सीमाएँ और हेडर

हर मीटर्ड रिस्पॉन्स में X-RateLimit-Limit, X-RateLimit-Remaining और X-RateLimit-Reset (Unix सेकंड) शामिल होते हैं, जो बताते हैं कि कॉल किस सीमा में गिनी गई। 429 रिस्पॉन्स में Retry-After भी होता है। बिना कुंजी वाली कॉल आपके इंटरनेट कनेक्शन की साझा मुफ़्त-टूल सीमा में गिनी जाती हैं; कुंजी वाली कॉल आपके वर्कस्पेस के दैनिक api_calls कोटे में गिनी जाती हैं, और हर कुंजी की अपनी कम दैनिक सीमा भी हो सकती है। जिस कॉल से कोई नतीजा नहीं मिलता — क्योंकि साइट तक पहुँचा नहीं जा सका या उसकी बॉट सुरक्षा ने जवाब दिया — वह बिल्कुल नहीं गिनी जाती।

ब्राउज़र किसी भी साइट से बिना कुंजी के मुफ़्त टूल एंडपॉइंट कॉल कर सकते हैं। जिन एंडपॉइंट के लिए कुंजी चाहिए, वे क्रॉस-ऑरिजिन ब्राउज़र अनुरोधों की अनुमति नहीं देते, इसलिए उन्हें अपने सर्वर से कॉल करें।

सारांश उस भाषा में पाने के लिए टूल एंडपॉइंट में ?locale=es, pt-BR, de, fr, ja, id, hi, tr, vi या ar जोड़ें।

स्रोत, 16 सितंबर 2026 को जाँचा गया: https://spec.openapis.org/oas/v3.1.1.html

MCP सर्वर

रिमोट सर्वर को सपोर्ट करने वाले किसी भी MCP क्लाइंट को https://citevana.com/api/mcp से कनेक्ट करें। यह Streamable HTTP ट्रांसपोर्ट का इस्तेमाल करता है, JSON में जवाब देता है और कोई सेशन नहीं रखता।

check_ai_crawlers — कोई साइट किन AI सर्च, असिस्टेंट और ट्रेनिंग क्रॉलर को अनुमति देती है। मुफ़्त।
audit_page — एक URL का ऑन-पेज SEO और AI-रेडीनेस ऑडिट। मुफ़्त।
generate_llms_txt — साइट के नाम, सारांश और लिंक से llms.txt फ़ाइल बनाता है। मुफ़्त; कुछ भी फ़ेच नहीं होता।
get_site_audit_summary — आपकी किसी साइट का सबसे हाल का ऑडिट। read:audits वाली API कुंजी ज़रूरी।

सर्वर प्रोटोकॉल रिविज़न 2026-07-28 (प्रति-अनुरोध मेटाडेटा और server/discover) को सपोर्ट करता है। यह रिविज़न 2025-11-25, 2025-06-18 और 2025-03-26 का initialize हैंडशेक भी स्वीकार करता है।

तीनों मुफ़्त टूल बिना ऑथेंटिकेशन के काम करते हैं और बिना-कुंजी वाली सीमा साझा करते हैं: हर इंटरनेट कनेक्शन के लिए रोज़ 3 जाँच। get_site_audit_summary के लिए आपके क्लाइंट को आपकी API कुंजी Authorization: Bearer हेडर में भेजनी होगी, जिससे यह दैनिक सीमा भी बढ़ जाती है। Citevana अभी MCP के लिए OAuth साइन-इन नहीं देता।

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

स्रोत, 16 सितंबर 2026 को जाँचा गया: https://modelcontextprotocol.io/specification/2026-07-28/basic/transports/streamable-http

इसे ChatGPT में जोड़ें

ChatGPT में Settings खोलें, फिर Security and login, और Developer mode चालू करें। आप इसका इस्तेमाल कर पाएँगे या नहीं, यह आपके अकाउंट और वर्कस्पेस नीति पर निर्भर है।
Plugins पर जाएँ और प्लस बटन चुनें।
एक नाम (जैसे Citevana) और छोटा विवरण डालें।
Connection में Public endpoint चुनें और https://citevana.com/api/mcp डालें।
कनेक्शन बनाएँ और उसे मिले टूल की समीक्षा करें।

ChatGPT OAuth से या बिना ऑथेंटिकेशन के कनेक्ट होता है, और API कुंजी नहीं भेज सकता। वहाँ तीनों मुफ़्त टूल काम करते हैं। get_site_audit_summary जवाब देता है कि इसके लिए कुंजी चाहिए।

स्रोत, 16 सितंबर 2026 को जाँचा गया: https://developers.openai.com/apps-sdk/deploy/connect-chatgpt

स्रोत, 16 सितंबर 2026 को जाँचा गया: https://developers.openai.com/apps-sdk/build/auth

इसे Claude में जोड़ें

Claude में Connectors सेक्शन खोजें।
सेक्शन के नीचे Add custom connector पर क्लिक करें।
रिमोट MCP सर्वर URL https://citevana.com/api/mcp डालें।
एडवांस्ड सेटिंग (OAuth client ID और secret) वैकल्पिक हैं और इन टूल के लिए ज़रूरी नहीं। Add पर क्लिक करें।

कस्टम कनेक्टर Claude और Claude Desktop पर Pro, Max, Team और Enterprise प्लान के लिए उपलब्ध हैं। Claude कनेक्टर साइन-इन के लिए OAuth का इस्तेमाल करते हैं, इसलिए फ़िलहाल वहाँ सिर्फ़ मुफ़्त टूल उपलब्ध हैं।

स्रोत, 16 सितंबर 2026 को जाँचा गया: https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp

अन्य MCP क्लाइंट और आपके अपने एजेंट

अगर आपका क्लाइंट रिमोट सर्वर के लिए HTTP हेडर सेट करने देता है, तो get_site_audit_summary इस्तेमाल करने के लिए Authorization: Bearer के बाद अपनी कुंजी जोड़ें। कुंजी वाली कॉल REST API वाले उसी दैनिक api_calls कोटे में गिनी जाती है; बिना कुंजी वह साझा मुफ़्त-टूल सीमा में गिनी जाती है।

Chrome एक्सटेंशन

Citevana Chrome एक्सटेंशन इस API के ज़रिए आपकी खुली टैब पर AI क्रॉलर जाँच और पेज ऑडिट चलाता है। इसके लिए अकाउंट की ज़रूरत नहीं और यह बिना-कुंजी वाली सीमा इस्तेमाल करता है; वैकल्पिक कुंजी उस सीमा को बढ़ा देती है और आपकी अपनी साइटों के ऑडिट दिखाती है। इसे Chrome Web Store के लिए तैयार किया जा रहा है।

यह सिर्फ़ activeTab और storage अनुमतियाँ माँगता है, साथ ही Citevana API तक एक्सेस। यह पेज का पता सिर्फ़ तब भेजता है जब आप जाँच पर क्लिक करते हैं, और क्वेरी स्ट्रिंग कभी नहीं भेजता।

स्रोत, 16 सितंबर 2026 को जाँचा गया: https://developer.chrome.com/docs/extensions/develop/concepts/activeTab

सुरक्षा और गोपनीयता

हर टूल सिर्फ़ पढ़ता है। आपकी वेबसाइट पर कभी कुछ नहीं बदला जाता।
फ़ेच किए गए पेजों से कॉपी किया गया टेक्स्ट अविश्वसनीय डेटा के रूप में चिह्नित होता है, इसलिए AI असिस्टेंट को उसमें मिले निर्देशों का पालन कभी नहीं करना चाहिए।
हम सिर्फ़ सार्वजनिक पेज CitevanaBot के रूप में फ़ेच करते हैं, और निजी व आरक्षित नेटवर्क पतों को ब्लॉक करते हैं।
हम हर API कुंजी का सिर्फ़ SHA-256 हैश सेव करते हैं। कुंजी एक ही बार दिखाई जाती है, और आप इसे कभी भी रद्द कर सकते हैं। कुंजी बनाना और रद्द करना ऑडिट लॉग में दर्ज होता है।

CitevanaBot

API कुंजी पाएँ

साइन इन करें और सेटिंग खोलें, फिर API कुंजियाँ। कुंजी को जिन स्कोप की ज़रूरत है (read:tools, read:sites, read:audits) उन्हें चुनें, और चाहें तो दैनिक सीमा सेट करें।

API कुंजी बनाएँ

अक्सर पूछे जाने वाले सवाल

क्या Citevana API मुफ़्त है?

हाँ। टूल एंडपॉइंट के लिए कुंजी नहीं चाहिए और वे वेबसाइट के मुफ़्त टूल वाली सीमा साझा करते हैं: रोज़ 3 जाँच, हर इंटरनेट कनेक्शन के हिसाब से, इसलिए एक ही दफ़्तर या कैंपस कनेक्शन के सब लोग उन्हें आपस में बाँटते हैं। मुफ़्त अकाउंट और API कुंजी इसे आपके वर्कस्पेस प्लान के दैनिक api_calls कोटे तक बढ़ा देते हैं — मुफ़्त प्लान पर रोज़ 100 — और आपकी अपनी साइटें व ऑडिट पढ़ने देते हैं।

MCP सर्वर क्या है?

MCP (Model Context Protocol) एक खुला प्रोटोकॉल है जिसका इस्तेमाल AI असिस्टेंट बाहरी टूल कॉल करने के लिए करते हैं। Citevana MCP सर्वर जोड़ने के बाद, ChatGPT या Claude जैसा असिस्टेंट चैट में ही आपके लिए जाँचें चला सकता है।

क्या ये टूल मेरी वेबसाइट बदल सकते हैं?

नहीं। API और MCP टूल सिर्फ़ सार्वजनिक पेज और आपके ऑडिट नतीजे पढ़ते हैं। सुधार सिर्फ़ Citevana ऐप में लागू होते हैं, और सिर्फ़ तब जब आप हर एक को मंज़ूर करें।

जाँच में कौन-से AI क्रॉलर शामिल हैं?

इसमें OpenAI (GPTBot, OAI-SearchBot, ChatGPT-User), Anthropic (ClaudeBot, Claude-SearchBot, Claude-User), Perplexity, Google-Extended, Applebot, Meta, Amazon, Common Crawl और Bing शामिल हैं। नतीजे में हर क्रॉलर उसके ऑपरेटर के दस्तावेज़ से लिंक होता है।

सीमा तक पहुँचने पर क्या होता है?

API quota_exceeded कोड और Retry-After हेडर के साथ 429 लौटाता है, और MCP टूल एक संदेश लौटाते हैं जिसमें बताया जाता है कि सीमा कब रीसेट होगी। सीमाएँ 00:00 UTC पर रीसेट होती हैं। बिना कुंजी के, संदेश यह भी बताता है कि API कुंजी कैसे लें — सीमा वही बढ़ाती है।