API a server MCP GetLinkFast

K čemu to slouží

• Agentury a SEO týmy: napojte své interní nástroje a reportovací nástěnky na svůj účet. Katalog, košík, objednávky a stavy čtete v JSON.
• AI agenti: požádejte Claude Code nebo Cursor „najdi mi 5 finančních webů s DR 40+ a objednej je“. Agent vyhledává, ukáže vám souhrn a objedná až po vašem souhlasu.
• Make, n8n, Zapier: stačí modul HTTP a klíč.

API prodává článek hosta (guest_post), vložení odkazu (link_insertion) a balíčky SEO/GEO, pouze za kredity. Nákup kreditů a ostatní nabídky zůstávají na nástěnce.

Vytvořit klíč

1. Otevřete Nástěnka → Přístup k API.
2. Pojmenujte klíč (například „Agent Claude“ nebo „Reporting Make“) a zvolte jeho oprávnění. U klíče, který smí objednávat, můžete nastavit limit na objednávku a limit na 24 hodin.
3. Zkopírujte klíč. Začíná na glf_live_ a zobrazí se jen jednou: uchováváme pouze jeho otisk.
4. Posílejte ho v hlavičce každého požadavku: Authorization: Bearer glf_live_…

Nejvýše 10 aktivních klíčů na organizaci. Odvolaný klíč okamžitě přestane fungovat, stejně jako klíče člena, který organizaci opustí. Držte klíč mimo repozitáře kódu: kdo ho má, jedná jménem vaší organizace.

Oprávnění klíče

Každý klíč nese jedno nebo více oprávnění. Požadavek bez potřebného oprávnění dostane 403 insufficient_scope a AI agent vidí jen povolené nástroje.

Rychlý start

Všechny cesty začínají na https://www.getlinkfast.com/api/v1. Ponechte www: adresa bez www přesměrovává a klient HTTP po přesměrování už neposílá hlavičku Authorization.

Částky jsou v eurech bez DPH. Odpovědi jsou v JSON, pole v 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"}'

Nahraďte site_id id webu z kroku 2. Nikdy neposílejte cenu: počítá ji server.

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

Odpověď obsahuje id objednávky, strženou částku a váš zbývající zůstatek. Průběh pak sledujte přes GET /orders/{id}.

Objednávání za kredity

API objednává pouze za kredity a nikdy nespouští platbu kartou. Kredity se dobíjejí na nástěnce.

Objednávka bere položky guest_post a link_insertion z košíku. Ostatní položky, přidané z nástěnky, zůstávají v košíku a jsou uvedeny v skipped_items.

Ve výchozím stavu žádný limit: jedinou hranicí je váš zůstatek. U klíče, který smí objednávat, nastavte limit na objednávku a limit na klouzavých 24 hodin. Objednávka, která je překročí, je odmítnuta (403 spending_limit_exceeded, se zbývající částkou), bez stržení.

Nedostatečný zůstatek: 402 insufficient_credits, s chybějící částkou a odkazem na stránku Kredity, k předání někomu z vašeho týmu. Nic se nestrhne.

Dál vše probíhá jako z nástěnky: potvrzovací e-mail a sledování na obrazovce Objednávky, kde objednávka nese název klíče, který ji zadal.

Hlavička Idempotency-Key

• Povinná u POST /checkout a POST /packs/orders: 8 až 128 tisknutelných znaků ASCII, bez mezer. Bez ní: 400 idempotency_key_required.
• Jedna hodnota odpovídá jednomu záměru nákupu. Opětovné odeslání stejné hodnoty vrátí původní objednávku (200, "replayed": true) bez druhého stržení, i když se košík mezitím změnil.
• Po vypršení časového limitu nebo výpadku sítě to zkuste znovu se stejnou hodnotou: nezaplatíte dvakrát.
• Pro nový nákup vygenerujte novou hodnotu, například UUID.
• U POST /checkout i u POST /packs/orders je hodnota už použitá pro jiný nákup odmítnuta: 409 idempotency_conflict, bez stržení. U balíčku je odmítnuta i stejná hodnota odeslaná s jiným obsahem.
• Na straně MCP tuto roli plní potvrzovací token: nemusíte nic generovat.

Limity

• 120 požadavků za minutu na klíč pro čtení a stejně tolik, odděleně, pro košík: jedno neubírá z druhého.
• 10 volání za minutu na klíč na nákupní cesty nebo nástroje — včetně opakování, odmítnutí a kroku souhrnu v MCP.
• 300 požadavků HTTP za minutu na klíč na serveru MCP. Každý volaný nástroj se navíc počítá do limitu svého oprávnění.
• Nad tento limit: 429 rate_limited. Dobu čekání v sekundách udává hlavička Retry-After přes HTTP a details.retry_after_seconds ve výsledku nástroje MCP.
• Nejvýše 100 výsledků na stránku (page_size).
• Tělo požadavku: nejvýše 1 MB.

Chybové kódy

Každá chyba má stejný tvar. Testujte code: je stabilní. message je v angličtině a je určena vývojáři; details uvádí chybné pole nebo částky.

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

Server MCP

Server MCP dává vašemu AI agentovi stejné funkce jako API, se stejným klíčem. Jeho adresa: https://www.getlinkfast.com/api/mcp.

Claude Code

Jeden příkaz v terminálu:

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

Cursor

V ~/.cursor/mcp.json. Vyhněte se souboru .cursor/mcp.json v projektu: často skončí v repozitáři, i s klíčem.

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

Claude Desktop

Claude Desktop neposílá vlastní hlavičky vzdálenému serveru, a proto nemůže předat váš klíč. Připojí se nativně přes připojení OAuth, plánované v některé z příštích verzí. Dnes použijte Claude Code nebo Cursor: posílají klíč v hlavičce Authorization.

Nástroje

Agent vidí jen nástroje povolené oprávněními klíče: klíč bez práva objednávat nemá žádný nákupní nástroj.

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

Nákup ve dvou krocích

1. Agent zavolá checkout nebo order_pack bez confirmation_token: nic se nestrhne. Dostane souhrn (položky, celkem, zůstatek po stržení, zbývající limit) a confirmation_token.
2. Ukáže vám tento souhrn. Pokud souhlasíte, zavolá nástroj znovu s confirmation_token: objednávka je zadána a stržena.
3. Token platí 10 minut. Pokud se mezitím změní košík, cena nebo klíč, je odmítnut (confirmation_expired) a agent zopakuje krok 1. Opětovné volání se stejným tokenem po výpadku vrátí stejnou objednávku, bez druhého stržení.

Ručně psaný klient

Server je bez relace: každá zpráva JSON-RPC jde jako POST a odpověď přichází v JSON. Posílejte Accept: application/json, text/event-stream a Content-Type: application/json, jinak server odpoví 406. GET a DELETE vracejí 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"}'

Audit a plánování

Agent může zauditovat web a podle zprávy rozložit odkazy na několik měsíců. Čtyři kroky, s nástroji serveru MCP.

1. run_audit spustí úplný audit domény: technické kontroly, viditelnost v ChatGPT a weby, kde by odkaz pomohl. Počítejte s několika minutami. Nic se nestrhává a zpráva se odemkne kvótou auditů organizace, pokud ji má. Limit: 10 auditů na klíč za 24 hodin; opětovný požadavek na stejnou doménu do hodiny vrátí existující audit.
2. get_audit vrátí stav a aktuální krok, poté zprávu v summary, jakmile je stav ready. Volejte ho každých 30 až 60 sekund. list_audits vypíše audity organizace od nejnovějšího.
3. plan_links sestaví z hotového auditu kalendář: měsíční rozpočet v eurech bez DPH (alespoň 100 €), 2 až 12 měsíců a volitelně datum zahájení a cílové stránky. Stejně jako při nákupu jsou to dva kroky. Bez tokenu se nic neuloží: agent dostane kalendář (odkazy, data odeslání, součet) a confirmation_token platný 10 minut. Po vašem souhlasu zavolá nástroj znovu se stejnými poli a tokenem a plán se uloží.
4. get_plan sleduje každý odkaz: cílovou stránku, kotvu, cenu a stav (naplánováno, objednáno, zveřejněno, zrušeno nebo selhalo, u selhání s příčinou, například insufficient_credits). cancel_planned_link zruší odkaz naplánovaný přes API nebo všechny dosud neobjednané odkazy domény. Odkazy naplánované naším týmem zůstávají: team_planned pro jeden odkaz, skipped_team_planned pro jejich počet.

Při uložení plánu se nic nestrhává. Každý odkaz se strhne v kreditech v den odeslání, za cenu znovu načtenou téhož dne, při denním ranním průchodu (kolem 06:20 UTC). Pokud ten den chybí zůstatek, odkaz se neobjedná a v get_plan se zobrazí jako neúspěšný. Už objednaný odkaz nelze zrušit.

Oprávnění: run_audit a cancel_planned_link vyžadují cart, plan_links vyžaduje purchase a get_audit, list_audits a get_plan vyžadují read. Limity útrat klíče platí i pro plánované odkazy.

V nástěnce zobrazuje stránka Delegování tyto odkazy v bloku „Naplánované odkazy“. Vlastník organizace tam může odebrat odkazy naplánované přes API. Odkazy naplánované naším týmem jsou jen ke čtení.

Reference

Každá cesta s oprávněním a odpovídajícím nástrojem MCP. Parametry, schémata odpovědí a chyby cesta po cestě: popis OpenAPI 3.1.

Otázka k API? Napište nám, odpoví vám člověk z týmu.