GetLinkFast API ve MCP sunucusu

Ne işe yarar

• Ajanslar ve SEO ekipleri: iç araçlarınızı ve takip panolarınızı hesabınıza bağlayın. Katalog, sepet, siparişler ve durumlar JSON olarak okunur.
• Yapay zekâ ajanları: Claude Code veya Cursor'a “DR 40+ olan 5 finans sitesi bul ve sipariş ver” deyin. Ajan arar, size özeti gösterir ve yalnızca onayınızdan sonra sipariş verir.
• Make, n8n, Zapier: bir HTTP modülü ve bir anahtar yeterli.

API konuk makale (guest_post), bağlantı ekleme (link_insertion) ve SEO/GEO paketleri satar, yalnızca krediyle. Kredi satın alma ve diğer teklifler panelde kalır.

Anahtar oluşturma

1. Panel → API erişimi sayfasını açın.
2. Anahtara bir ad verin (örneğin “Claude ajanı” veya “Make raporlama”) ve yetkilerini seçin. Sipariş verebilen bir anahtarda sipariş başına bir limit ve 24 saatlik bir limit belirleyebilirsiniz.
3. Anahtarı kopyalayın. glf_live_ ile başlar ve yalnızca bir kez gösterilir: yalnızca bir parmak izini saklarız.
4. Her isteğin başlığında gönderin: Authorization: Bearer glf_live_…

Kuruluş başına en fazla 10 etkin anahtar. İptal edilen bir anahtar hemen çalışmayı bırakır; kuruluştan ayrılan bir üyenin anahtarları da öyle. Anahtarı kod depolarınızın dışında tutun: ona sahip olan, kuruluşunuz adına işlem yapar.

Bir anahtarın yetkileri

Her anahtarın bir veya daha fazla yetkisi vardır. Gerekli yetkisi olmayan bir istek 403 insufficient_scope alır ve bir yapay zekâ ajanı yalnızca izin verilen araçları görür.

Hızlı başlangıç

Tüm rotalar https://www.getlinkfast.com/api/v1 ile başlar. www kısmını koruyun: www olmayan adres yönlendirme yapar ve bir HTTP istemcisi yönlendirmeden sonra Authorization başlığını artık göndermez.

Tutarlar KDV hariç avrodur. Yanıtlar JSON'dur, alanlar snake_case biçimindedir.

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 değerini 2. adımdaki bir sitenin id'siyle değiştirin. Asla fiyat göndermeyin: fiyatı sunucu hesaplar.

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

Yanıt sipariş id'sini, düşülen tutarı ve kalan bakiyenizi verir. Ardından ilerlemeyi GET /orders/{id} ile takip edin.

Krediyle sipariş

API yalnızca krediyle sipariş verir ve hiçbir zaman kartla ödeme başlatmaz. Krediler panelden yüklenir.

Bir sipariş sepetteki guest_post ve link_insertion satırlarını alır. Panelden eklenen diğer satırlar sepette kalır ve skipped_items içinde listelenir.

Varsayılan limit yok: tek sınır bakiyenizdir. Sipariş verebilen bir anahtarda sipariş başına bir limit ve kayan 24 saatlik bir limit belirleyin. Bunları aşan bir sipariş reddedilir (403 spending_limit_exceeded, kalan tutarla birlikte), bakiyeden düşülmez.

Yetersiz bakiye: 402 insufficient_credits, eksik tutar ve ekibinizden birine iletmeniz için Krediler sayfasının bağlantısıyla. Hiçbir şey düşülmez.

Sonrasında her şey panelden olduğu gibi işler: onay e-postası ve Siparişler ekranında takip; burada sipariş, onu veren anahtarın adını taşır.

Idempotency-Key başlığı

• POST /checkout ve POST /packs/orders için zorunlu: boşluksuz, 8 ile 128 arası yazdırılabilir ASCII karakter. Olmadan: 400 idempotency_key_required.
• Bir değer bir satın alma niyetine karşılık gelir. Aynı değeri yeniden göndermek, sepet o zamandan beri değişmiş olsa bile, ikinci bir düşüm olmadan ilk siparişi döndürür (200, "replayed": true).
• Zaman aşımı veya ağ kesintisinden sonra aynı değerle yeniden deneyin: iki kez ödemezsiniz.
• Yeni bir satın alma için yeni bir değer üretin, örneğin bir UUID.
• POST /checkout üzerinde de POST /packs/orders üzerinde de başka bir satın almada kullanılmış bir değer reddedilir: 409 idempotency_conflict, düşüm olmadan. Bir pakette, farklı içerikle gönderilen aynı değer de reddedilir.
• MCP tarafında bu rolü onay belirteci üstlenir: hiçbir şey üretmeniz gerekmez.

Limitler

• Okuma için anahtar başına dakikada 120 istek ve sepet için ayrıca bir o kadar daha: biri diğerinden düşmez.
• Satın alma rotalarına veya araçlarına anahtar başına dakikada 10 çağrı — yeniden denemeler, retler ve MCP özet adımı dahil.
• MCP sunucusunda anahtar başına dakikada 300 HTTP isteği. Çağrılan her araç ayrıca kendi yetkisinin limitine sayılır.
• Bunun ötesinde: 429 rate_limited. Bekleme süresini saniye cinsinden HTTP'de Retry-After başlığı, MCP araç sonucunda ise details.retry_after_seconds verir.
• Sayfa başına en fazla 100 sonuç (page_size).
• İstek gövdesi: en fazla 1 MB.

Hata kodları

Her hata aynı biçimdedir. code değerini test edin: kararlıdır. message İngilizcedir ve geliştiriciye yöneliktir; details hatalı alanı veya tutarları belirtir.

{
  "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 sunucusu

MCP sunucusu, yapay zekâ ajanınıza API ile aynı işlevleri aynı anahtarla sunar. Adresi: https://www.getlinkfast.com/api/mcp.

Claude Code

Terminalinizde tek bir komut:

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

Cursor

~/.cursor/mcp.json içinde. Bir projenin .cursor/mcp.json dosyasından kaçının: çoğu zaman anahtarla birlikte depoya girer.

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

Claude Desktop

Claude Desktop uzak bir sunucuya özel başlık göndermez, bu yüzden anahtarınızı iletemez. İleriki bir sürümde planlanan OAuth bağlantısıyla doğrudan bağlanacak. Bugün Claude Code veya Cursor kullanın: anahtarı Authorization başlığında gönderirler.

Araçlar

Ajan yalnızca anahtarın yetkilerinin izin verdiği araçları görür: sipariş yetkisi olmayan bir anahtarın hiçbir satın alma aracı yoktur.

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

İki adımda satın alma

1. Ajan checkout veya order_pack aracını confirmation_token olmadan çağırır: hiçbir şey düşülmez. Özeti (satırlar, toplam, düşüm sonrası bakiye, kalan limit) ve bir confirmation_token alır.
2. Bu özeti size gösterir. Kabul ederseniz aracı confirmation_token ile yeniden çağırır: sipariş verilir ve düşülür.
3. Belirteç 10 dakika geçerlidir. Bu arada sepet, bir fiyat veya anahtar değişirse reddedilir (confirmation_expired) ve ajan 1. adımı yeniden yapar. Bir kesintiden sonra aynı belirteçle yeniden çağırmak, ikinci bir düşüm olmadan aynı siparişi döndürür.

Elle yazılmış istemci

Sunucu oturumsuzdur: her JSON-RPC mesajı POST ile gider ve yanıt JSON olarak gelir. Accept: application/json, text/event-stream ve Content-Type: application/json gönderin, aksi halde sunucu 406 yanıtı verir. GET ve DELETE 405 döndürür.

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"}'

Denetle ve planla

Bir ajan bir siteyi denetleyebilir, ardından rapora dayanarak bağlantıları birkaç aya yayabilir. Dört adım, MCP sunucusunun araçlarıyla.

1. run_audit bir alan adının tam denetimini başlatır: teknik kontroller, ChatGPT'deki görünürlük ve bir bağlantının işe yarayacağı siteler. Birkaç dakika sürer. Hiçbir şey düşülmez; kuruluşun denetim kotası varsa rapor bu kotayla açılır. Sınır: anahtar başına 24 saatte 10 denetim; aynı alan adı bir saat içinde yeniden istenirse mevcut denetim döner.
2. get_audit durumu ve geçerli adımı, durum ready olunca da raporu summary içinde verir. Her 30 ila 60 saniyede bir çağırın. list_audits kuruluşun denetimlerini en yeniden başlayarak listeler.
3. plan_links hazır bir denetimden takvim çıkarır: KDV hariç euro cinsinden aylık bütçe (en az 100 €), 2 ila 12 ay ve isteğe bağlı olarak başlangıç tarihi ile hedef sayfalar. Satın almada olduğu gibi iki adımdır. Jeton olmadan hiçbir şey kaydedilmez: ajan takvimi (bağlantılar, gönderim tarihleri, toplam) ve 10 dakika geçerli bir confirmation_token alır. Onayınızdan sonra aracı aynı alanlar ve jetonla yeniden çağırır, plan kaydedilir.
4. get_plan her bağlantıyı izler: hedef sayfa, çapa metni, fiyat ve durum (planlandı, sipariş edildi, yayımlandı, iptal edildi veya başarısız; başarısızlıkta insufficient_credits gibi bir nedenle). cancel_planned_link API ile planlanmış bir bağlantıyı ya da bir alan adının henüz sipariş edilmemiş tüm bağlantılarını iptal eder. Ekibimizin planladığı bağlantılar yerinde kalır: bir bağlantı için team_planned, sayıları için skipped_team_planned.

Plan kaydedilirken hiçbir şey düşülmez. Her bağlantı, gönderim gününde, o gün yeniden okunan fiyattan, günlük sabah geçişinde (yaklaşık 06:20 UTC) kredi olarak düşülür. O gün bakiye yetmezse bağlantı sipariş edilmez ve get_plan içinde başarısız görünür. Siparişi verilmiş bir bağlantı artık iptal edilemez.

İzinler: run_audit ve cancel_planned_link için cart, plan_links için purchase, get_audit, list_audits ve get_plan için read gerekir. Anahtarın harcama sınırları planlanan bağlantılar için de geçerlidir.

Panelde Devir sayfası bu bağlantıları “Planlanan bağlantılar” bloğunda gösterir. Kuruluşun sahibi, API ile planlanan bağlantıları buradan kaldırabilir. Ekibimizin planladıkları yalnızca okunur.

Başvuru

Her rota, yetkisi ve karşılık gelen MCP aracıyla. Rota rota parametreler, yanıt şemaları ve hatalar: OpenAPI 3.1 açıklaması.

API hakkında bir sorunuz mu var? Bize yazın, ekipten biri size yanıt verir.