GetLinkFast API और MCP सर्वर

यह किस काम आता है

• एजेंसियाँ और SEO टीमें: अपने आंतरिक टूल और ट्रैकिंग डैशबोर्ड अपने खाते से जोड़ें। कैटलॉग, कार्ट, ऑर्डर और स्थितियाँ JSON में पढ़ी जा सकती हैं।
• AI एजेंट: Claude Code या Cursor से कहें “DR 40+ वाली 5 फ़ाइनेंस साइटें ढूँढो और ऑर्डर करो”। एजेंट खोजता है, आपको सारांश दिखाता है और आपकी सहमति के बाद ही ऑर्डर करता है।
• Make, n8n, Zapier: एक HTTP मॉड्यूल और एक कुंजी काफ़ी है।

API गेस्ट पोस्ट (guest_post), लिंक इंसर्शन (link_insertion) और SEO/GEO पैक बेचता है, केवल क्रेडिट से। क्रेडिट ख़रीदना और बाकी ऑफ़र डैशबोर्ड में ही रहते हैं।

कुंजी बनाएँ

1. डैशबोर्ड → API एक्सेस खोलें।
2. कुंजी को नाम दें (जैसे “Claude एजेंट” या “Make रिपोर्टिंग”) और उसकी अनुमतियाँ चुनें। ऑर्डर कर सकने वाली कुंजी पर आप प्रति ऑर्डर सीमा और 24 घंटे की सीमा तय कर सकते हैं।
3. कुंजी कॉपी करें। यह glf_live_ से शुरू होती है और सिर्फ़ एक बार दिखाई जाती है: हम इसका केवल एक फ़िंगरप्रिंट रखते हैं।
4. इसे हर अनुरोध के हेडर में भेजें: Authorization: Bearer glf_live_…

प्रति संगठन अधिकतम 10 सक्रिय कुंजियाँ। रद्द की गई कुंजी तुरंत काम करना बंद कर देती है, और संगठन छोड़ने वाले सदस्य की कुंजियाँ भी। कुंजी को अपने कोड रिपॉज़िटरी से बाहर रखें: जिसके पास यह है, वह आपके संगठन की ओर से काम करता है।

कुंजी की अनुमतियाँ

हर कुंजी में एक या अधिक अनुमतियाँ होती हैं। आवश्यक अनुमति के बिना किए गए अनुरोध को 403 insufficient_scope मिलता है, और AI एजेंट केवल अनुमत टूल देखता है।

त्वरित शुरुआत

सभी रूट https://www.getlinkfast.com/api/v1 से शुरू होते हैं। www बनाए रखें: www के बिना पता रीडायरेक्ट करता है, और रीडायरेक्ट के बाद HTTP क्लाइंट Authorization हेडर नहीं भेजता।

राशियाँ VAT के बिना यूरो में हैं। जवाब JSON में हैं, फ़ील्ड snake_case में।

curl https://www.getlinkfast.com/api/v1/account \
  -H "Authorization: Bearer glf_live_…"

curl "https://www.getlinkfast.com/api/v1/sites?dr_min=40&language=fr&product=guest_post&sort=dr&dir=desc&page_size=10" \
  -H "Authorization: Bearer glf_live_…"

curl -X POST https://www.getlinkfast.com/api/v1/cart/items \
  -H "Authorization: Bearer glf_live_…" \
  -H "Content-Type: application/json" \
  -d '{"site_id":"8a1f0c3e-5b7d-4e2a-9c61-0f3b2d4e6a17","product_type":"guest_post","target_url":"https://www.example.com/invoicing","anchor":"invoicing software","topic":"How to choose invoicing software for a small business"}'

site_id को चरण 2 की किसी साइट के id से बदलें। कभी कीमत न भेजें: सर्वर उसकी गणना करता है।

curl -X POST https://www.getlinkfast.com/api/v1/checkout \
  -H "Authorization: Bearer glf_live_…" \
  -H "Idempotency-Key: order-2026-10-14-001"

जवाब में ऑर्डर का id, काटी गई राशि और आपका शेष बैलेंस होता है। फिर GET /orders/{id} से उसकी प्रगति देखें।

क्रेडिट से ऑर्डर

API केवल क्रेडिट से ऑर्डर करता है और कभी कार्ड भुगतान शुरू नहीं करता। क्रेडिट डैशबोर्ड में रिचार्ज होते हैं।

ऑर्डर कार्ट के guest_post और link_insertion आइटम लेता है। डैशबोर्ड से जोड़े गए बाकी आइटम कार्ट में रहते हैं और skipped_items में सूचीबद्ध होते हैं।

डिफ़ॉल्ट रूप से कोई सीमा नहीं: आपका बैलेंस ही एकमात्र सीमा है। ऑर्डर कर सकने वाली कुंजी पर प्रति ऑर्डर सीमा और लगातार 24 घंटे की सीमा तय करें। इन्हें पार करने वाला ऑर्डर अस्वीकार हो जाता है (403 spending_limit_exceeded, उपलब्ध शेष के साथ), बिना कटौती के।

अपर्याप्त बैलेंस: 402 insufficient_credits, कम पड़ी राशि और क्रेडिट पेज के लिंक के साथ, जिसे आप अपनी टीम के किसी व्यक्ति को भेज सकते हैं। कुछ नहीं कटता।

इसके बाद सब कुछ डैशबोर्ड की तरह चलता है: पुष्टि ईमेल और ऑर्डर स्क्रीन पर ट्रैकिंग, जहाँ ऑर्डर पर उस कुंजी का नाम होता है जिसने उसे दिया।

Idempotency-Key हेडर

• POST /checkout और POST /packs/orders पर अनिवार्य: 8 से 128 प्रिंट होने योग्य ASCII वर्ण, बिना स्पेस के। इसके बिना: 400 idempotency_key_required।
• एक मान एक ख़रीद इरादे के बराबर है। वही मान दोबारा भेजने पर मूल ऑर्डर लौटता है (200, "replayed": true), दूसरी कटौती के बिना, भले ही कार्ट तब से बदल गया हो।
• टाइमआउट या नेटवर्क टूटने के बाद उसी मान से दोबारा कोशिश करें: आप दो बार भुगतान नहीं करेंगे।
• नई ख़रीद के लिए नया मान बनाएँ, जैसे एक UUID।
• POST /checkout और POST /packs/orders दोनों पर, किसी दूसरी ख़रीद में इस्तेमाल हो चुका मान अस्वीकार होता है: 409 idempotency_conflict, बिना कटौती के। पैक के लिए, अलग सामग्री के साथ भेजा गया वही मान भी अस्वीकार होता है।
• MCP की ओर पुष्टि टोकन यही भूमिका निभाता है: आपको कुछ बनाना नहीं पड़ता।

सीमाएँ

• पढ़ने के लिए प्रति कुंजी प्रति मिनट 120 अनुरोध, और कार्ट के लिए अलग से उतने ही: एक दूसरे में से नहीं घटता।
• ख़रीद रूट या टूल पर प्रति कुंजी प्रति मिनट 10 कॉल — दोबारा भेजे गए अनुरोध, अस्वीकृतियाँ और MCP का सारांश चरण शामिल।
• MCP सर्वर पर प्रति कुंजी प्रति मिनट 300 HTTP अनुरोध। बुलाया गया हर टूल अपनी अनुमति की सीमा में भी गिना जाता है।
• इससे ऊपर: 429 rate_limited। प्रतीक्षा का समय (सेकंड में) HTTP पर Retry-After हेडर बताता है, और MCP टूल के परिणाम में details.retry_after_seconds।
• प्रति पेज अधिकतम 100 परिणाम (page_size)।
• अनुरोध का बॉडी: अधिकतम 1 MB।

त्रुटि कोड

हर त्रुटि का रूप एक जैसा होता है। code जाँचें: यह स्थिर है। message अंग्रेज़ी में है और डेवलपर के लिए है; details ग़लत फ़ील्ड या राशियाँ बताता है।

{
  "error": {
    "code": "insufficient_credits",
    "message": "Not enough credits for this order. Nothing was debited. Ask a human to top up at credits_url, then retry with the same Idempotency-Key.",
    "details": {
      "missing_amount": 42,
      "credits_url": "https://www.getlinkfast.com/dashboard/credits"
    }
  }
}

MCP सर्वर

MCP सर्वर आपके AI एजेंट को उसी कुंजी के साथ API जैसे ही फ़ंक्शन देता है। इसका पता: https://www.getlinkfast.com/api/mcp।

Claude Code

आपके टर्मिनल में एक कमांड:

claude mcp add --transport http getlinkfast https://www.getlinkfast.com/api/mcp --header "Authorization: Bearer glf_live_…"

Cursor

~/.cursor/mcp.json में। किसी प्रोजेक्ट की .cursor/mcp.json फ़ाइल से बचें: वह अक्सर कुंजी के साथ रिपॉज़िटरी में पहुँच जाती है।

{
  "mcpServers": {
    "getlinkfast": {
      "url": "https://www.getlinkfast.com/api/mcp",
      "headers": {
        "Authorization": "Bearer glf_live_…"
      }
    }
  }
}

Claude Desktop

Claude Desktop किसी रिमोट सर्वर को कस्टम हेडर नहीं भेजता, इसलिए वह आपकी कुंजी नहीं भेज सकता। यह आने वाले किसी संस्करण में नियोजित OAuth कनेक्शन से सीधे जुड़ेगा। आज Claude Code या Cursor इस्तेमाल करें: वे कुंजी Authorization हेडर में भेजते हैं।

टूल

एजेंट केवल वही टूल देखता है जिनकी कुंजी की अनुमतियाँ इजाज़त देती हैं: ऑर्डर का अधिकार न रखने वाली कुंजी के पास कोई ख़रीद टूल नहीं होता।

read

search_sitesget_sitelist_site_pageslist_categoriesget_accountlist_ordersget_orderget_auditquote_packlist_auditsget_plan

cart

get_cartadd_to_cartupdate_cart_itemremove_cart_itemadd_audit_pagerun_auditcancel_planned_link

purchase

checkoutorder_packplan_links

दो चरणों में ख़रीद

1. एजेंट checkout या order_pack को confirmation_token के बिना बुलाता है: कुछ नहीं कटता। उसे सारांश (आइटम, कुल, कटौती के बाद बैलेंस, शेष सीमा) और एक confirmation_token मिलता है।
2. वह आपको यह सारांश दिखाता है। आप सहमत हों तो वह confirmation_token के साथ टूल फिर बुलाता है: ऑर्डर दिया जाता है और राशि कटती है।
3. टोकन 10 मिनट तक मान्य है। अगर इस बीच कार्ट, कोई कीमत या कुंजी बदल जाए, तो यह अस्वीकार होता है (confirmation_expired) और एजेंट चरण 1 दोहराता है। रुकावट के बाद उसी टोकन से फिर बुलाने पर वही ऑर्डर लौटता है, दूसरी कटौती के बिना।

हाथ से लिखा क्लाइंट

सर्वर सेशन-रहित है: हर JSON-RPC संदेश POST से जाता है और जवाब JSON में आता है। Accept: application/json, text/event-stream और Content-Type: application/json भेजें, वरना सर्वर 406 लौटाता है। GET और DELETE 405 लौटाते हैं।

curl -X POST https://www.getlinkfast.com/api/mcp \
  -H "Authorization: Bearer glf_live_…" \
  -H "Accept: application/json, text/event-stream" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

ऑडिट और योजना

एजेंट किसी साइट का ऑडिट कर सकता है, फिर रिपोर्ट के आधार पर लिंक को कई महीनों में बाँट सकता है। MCP सर्वर के टूल से चार चरण।

1. run_audit किसी डोमेन का पूरा ऑडिट शुरू करता है: तकनीकी जाँच, ChatGPT में दृश्यता और वे साइटें जहाँ लिंक काम आएगा। इसमें कुछ मिनट लगते हैं। कुछ नहीं कटता, और संगठन के पास ऑडिट कोटा हो तो रिपोर्ट उसी से खुलती है। सीमा: प्रति कुंजी 24 घंटे में 10 ऑडिट; एक घंटे के भीतर वही डोमेन दोबारा माँगने पर मौजूदा ऑडिट लौटता है।
2. get_audit स्थिति और मौजूदा चरण देता है, और स्थिति ready होने पर रिपोर्ट summary में देता है। इसे हर 30 से 60 सेकंड में बुलाएँ। list_audits संगठन के ऑडिट सबसे नए से शुरू करके सूचीबद्ध करता है।
3. plan_links तैयार ऑडिट से कैलेंडर बनाता है: यूरो में मासिक बजट (VAT के बिना, कम से कम 100 €), 2 से 12 महीने, और वैकल्पिक रूप से शुरुआत की तारीख और लक्षित पेज। खरीद की तरह यह दो चरणों में होता है। टोकन के बिना कुछ सहेजा नहीं जाता: एजेंट को कैलेंडर (लिंक, भेजने की तारीख़ें, कुल) और 10 मिनट वैध confirmation_token मिलता है। आपकी सहमति के बाद वह उन्हीं फ़ील्ड और टोकन के साथ टूल को फिर बुलाता है, और योजना सहेज ली जाती है।
4. get_plan हर लिंक को ट्रैक करता है: लक्ष्य पेज, एंकर, कीमत और स्थिति (शेड्यूल, ऑर्डर, प्रकाशित, रद्द या विफल; विफलता पर कारण के साथ, जैसे insufficient_credits)। cancel_planned_link API से योजना बनाए गए एक लिंक को, या किसी डोमेन के अभी तक ऑर्डर न हुए सभी लिंक को रद्द करता है। हमारी टीम द्वारा शेड्यूल किए गए लिंक बने रहते हैं: एक लिंक के लिए team_planned, उनकी संख्या के लिए skipped_team_planned।

योजना सहेजते समय कुछ नहीं कटता। हर लिंक भेजने के दिन, उसी दिन दोबारा पढ़ी गई कीमत पर, रोज़ सुबह की नियमित प्रक्रिया (लगभग 06:20 UTC) में क्रेडिट से कटता है। उस दिन बैलेंस कम हो तो लिंक ऑर्डर नहीं होता और get_plan में विफल दिखता है। ऑर्डर हो चुका लिंक अब रद्द नहीं हो सकता।

अधिकार: run_audit और cancel_planned_link के लिए cart, plan_links के लिए purchase, और get_audit, list_audits व get_plan के लिए read चाहिए। कुंजी की खर्च सीमाएँ नियोजित लिंक पर भी लागू होती हैं।

डैशबोर्ड में प्रत्यायोजन पेज ये लिंक “शेड्यूल किए गए लिंक” ब्लॉक में दिखाता है। संगठन का मालिक वहाँ API से निर्धारित लिंक हटा सकता है। हमारी टीम के निर्धारित लिंक केवल पढ़े जा सकते हैं।

संदर्भ

हर रूट उसकी अनुमति और संबंधित MCP टूल के साथ। हर रूट के पैरामीटर, जवाब स्कीमा और त्रुटियाँ: OpenAPI 3.1 विवरण।

API के बारे में कोई सवाल? हमें लिखें, टीम का कोई व्यक्ति जवाब देगा।