डेवलपर के लिए

जो कुछ हम मापते हैं
वह पढ़ा जा सकता है।

एक ही कुंजी REST API और MCP दोनों खोलती है; दोनों केवल-पढ़ने के हैं और दोनों Studio प्लान में शामिल हैं। आपका डेटा हमारी स्क्रीन में बंद नहीं है - वह आपकी स्क्रिप्ट, आपके डैशबोर्ड या आपके सहायक तक उसी रूप में पहुँचता है।

अपने डैशबोर्ड में ले जाइए
रैंक इतिहास को अंदरूनी डैशबोर्ड, स्प्रेडशीट या साप्ताहिक रिपोर्ट में खींच लीजिए। डेटा आपका है; उसे हमारी स्क्रीन पर रुकना ज़रूरी नहीं।
रिलीज़ से पहले जाँच
नया मेटाडेटा भेजने से पहले स्क्रिप्ट से कस्प बैंड पढ़वाइए: उपशीर्षक से जो शब्द अभी हटाया, उस पर आप किस रैंक पर हैं - क्या वह सचमुच छोड़ा जा सकता है?
सहायक से पूछिए
MCP जुड़ा हो तो “मेरे कौन-से कीवर्ड दहलीज़ बैंड में हैं और कौन सबसे लोकप्रिय है?” का जवाब बिना एक भी स्क्रीनशॉट के मिल जाता है।

एक ही लाइन में शुरू करें

अंदर आने के तीन रास्ते, कुंजी एक। जो आप हैं वही चुनिए: MCP बोलने वाला सहायक, एक टर्मिनल, या एक स्क्रिप्ट।

claude-code

claude mcp add --transport http rankcusp \
  https://rankcusp.com/api/mcp \
  --header "Authorization: Bearer rc_live_…" \
  --header "Accept-Language: tr"

सेटअप बस इतना ही है। दूसरा हेडर ही तय करता है कि फ़ैसले आपकी भाषा में लौटें; उसे हटा दीजिए तो अंग्रेज़ी में आएँगे। पूछिए “मेरे कौन-से कीवर्ड दहलीज़ बैंड में हैं?” और सहायक नीचे दिए टूल ख़ुद बुला लेगा।

कुंजी

इसे खाता स्क्रीन से बनाइए। कुंजी सिर्फ़ एक बार दिखती है - हम उसका सारांश ही रखते हैं, इसलिए खो जाने पर वापस नहीं ला सकते; आप उसे रद्द करके नई ले लेते हैं।

सहायक क्या कर सकता है

नौ टूल। इनमें आठ सिर्फ़ पढ़ते हैं; आख़िरी कीवर्ड जोड़ता है और बुलाए जाने से पहले ही क्लाइंट को यह बता देता है। जुड़ते ही सहायक इन तक पहुँच जाता है, और भीतर से CLI भी इन्हीं को बुलाती है।

list_apps: खाते की ऐप्स और प्रतिद्वंद्वी। बाक़ी हर टूल जो appId माँगता है, वह यहीं से आता है।
cusp_actions: 11-30 बैंड, लोकप्रियता के क्रम में: उन शब्दों की छोटी सूची जिन पर अक्षर खर्च करना बनता है।
get_keyword: एक कीवर्ड - रैंक, लोकप्रियता, कठिनाई - और उसका फ़ैसला आपकी भाषा में लिखा हुआ: इसे साधना बनता है या नहीं, और किस आधार पर।
ranking_keywords: कोई ऐप पहले से किन शब्दों पर रैंक कर रही है - इस उत्पाद ने जो भी खोज चलाई, उन सबके साझा रिकॉर्ड से। किसी प्रतिद्वंद्वी पर तानिए तो उसके पढ़ लेगा: Apple इसके लिए कोई एंडपॉइंट नहीं देता, इसलिए जवाब उतना ही चौड़ा है जितना देखा जा चुका है।
keyword_competitors: इस वाक्यांश पर और कौन रैंक करता है, पहले पेज के दस से भी गहरे। जहाँ आप 60 पर हैं वहाँ 40 पर बैठी ऐप ही पढ़ने लायक़ है।
audit_metadata: प्रकाशित करने से पहले शीर्षक, उपशीर्षक और कीवर्ड फ़ील्ड का मसौदा पढ़ता है: क्या दोहराया गया, क्या बर्बाद हुआ, और कितने अक्षर वापस मिलते हैं।
country_priorities: अगला घंटा किस स्टोर का हक़ है: हर देश में दहलीज़ शब्दों की गिनती, और प्रतिद्वंद्वी कहाँ सबसे कमज़ोर हैं।
list_keywords: एक देश के सारे ट्रैक किए कीवर्ड, उनकी मौजूदा और पिछली रैंक के साथ।
add_keywords: लिखने वाला अकेला टूल। किसी ऐप की एक स्टोरफ़्रंट वाली ट्रैक सूची में कीवर्ड जोड़ता है - सूची या चिपकाई हुई पंक्ति से। वे बिना स्कोर के आते हैं - स्कोर करने में Apple के अनुरोध लगते हैं और वह कलेक्टर की बारी का इंतज़ार करता है - इसलिए यहाँ खाली लोकप्रियता शून्य नहीं है।

CLI

एक `curl` और एक कुंजी। यह टर्मिनल में पढ़ने के लिए बनी तालिकाएँ छापती है - बिना मापा मान वहाँ भी डैश ही रहता है, शून्य कहीं नहीं गढ़ा जाता।

terminal

$ rankcusp cusp 1544… --country us
KEYWORD          RANK   Δ  POP  DIFF  CUSP
───────────────  ────  ──  ───  ────  ────
habit tracker      14  +5   32    41  •   
streak tracking    23   -    -    38  •

rankcusp: सत्र खोलता है: किससे जुड़े हैं, क्या पूछ सकते हैं, और एक प्रॉम्प्ट।
rankcusp apps: खाते की ऐप्स और प्रतिद्वंद्वी।
rankcusp keywords <appId> --country <cc>: किसी एक स्टोर के सारे ट्रैक किए कीवर्ड।
rankcusp cusp <appId> --country <cc>: किसी एक ऐप का दहलीज़ बैंड, लोकप्रियता के क्रम में।
rankcusp keyword <appId> <phrase> --country <cc>: एक कीवर्ड और उसका फ़ैसला।
rankcusp audit --country <cc> --title … --keywords …: प्रकाशित करने से पहले मेटाडेटा का मसौदा जाँचता है।
rankcusp countries <appId>: अगला काम किस स्टोर पर करना है।
rankcusp tools: टूल की सूची देता है - सहायक इसी से अपना रास्ता ढूँढ़ता है।

एंडपॉइंट

GET/api/v1/apps: खाते के ऐप और प्रतियोगी। बाकी कॉल जो appId माँगते हैं वह यहीं से आता है।
GET/api/v1/keywords?app=…&country=…: ट्रैक किए गए कीवर्ड: रैंक, पिछली रैंक, लोकप्रियता, कठिनाई, और कस्प बैंड में है या नहीं।
GET/api/v1/keywords?app=…&country=…&cusp=1: केवल 11-30 बैंड - जिन पर एक मेटाडेटा बदलाव सबसे ज़्यादा लौटाता है।
GET/api/v1/keywords?app=…&country=…&keyword=…: एक कीवर्ड: उसका पहला पेज और फ़ैसला - इसे निशाना बनाना चाहिए या नहीं, और किस आधार पर।
POST/api/mcp: MCP एंडपॉइंट (JSON-RPC 2.0)। ऊपर गिनाए नौ टूल यहीं से चलते हैं।

जवाब कैसा दिखता है?

नीचे का उदाहरण कस्प बैंड माँगने वाली कॉल का आकार दिखाता है। दूसरी पंक्ति देखिए: previousRank और popularity null हैं। इसका अर्थ है कि यह कीवर्ड पहली बार मापा गया और उसकी लोकप्रियता अभी नहीं मिल पाई - शून्य नहीं।

json

{
  "total": 2,
  "maxPageSize": 200,
  "keywords": [
    {
      "keyword": "habit tracker",
      "country": "us",
      "rank": 14,
      "previousRank": 19,
      "delta": 5,
      "popularity": 32,
      "difficulty": 41,
      "cusp": true,
      "lastMeasuredAt": "2026-08-12T04:12:09.114Z"
    },
    {
      "keyword": "streak tracking",
      "country": "us",
      "rank": 23,
      "previousRank": null,
      "delta": null,
      "popularity": null,
      "difficulty": 38,
      "cusp": true,
      "lastMeasuredAt": "2026-08-12T04:12:11.902Z"
    }
  ]
}

जो जानना ज़रूरी है

जो मापा नहीं गया वह `null` लौटता है, कभी शून्य नहीं। rank: null का अर्थ है “पहले 200 से बाहर”, popularity: null का अर्थ है “अभी मापा नहीं गया”। इन्हें शून्य से बदलने वाला क्लाइंट देर-सबेर उनका औसत निकाल लेगा।
फ़ैसले आपकी अपनी भाषा में लौटते हैं। MCP एंडपॉइंट क्लाइंट की भाषा पढ़ता है, और CLI RANKCUSP_LANG=hi लेती है। आँकड़े हर भाषा में एक जैसे रहते हैं।
प्रति मिनट 120 अनुरोध। इससे ऊपर 429 और retry-after मिलेगा।
प्रति पेज अधिकतम 200 पंक्तियाँ; offset से आगे बढ़िए।
सब कुछ केवल-पढ़ने का है। API से कीवर्ड न जोड़े जाते हैं न हटाए जाते हैं।
हर कॉल में country ज़रूरी है: एक ही वाक्यांश दो स्टोरफ़्रंट में दो अलग खोजें हैं, इसलिए दो अलग पंक्तियाँ भी।
कुंजी एक खाते का प्रतिनिधित्व करती है, किसी व्यक्ति का नहीं। एक कुंजी साझा करने के बजाय अलग-अलग बनाना, एक को रद्द करना दूसरे को तोड़े बिना संभव बनाता है।