API i serwer MCP GetLinkFast

Do czego to służy

• Agencje i zespoły SEO: podłącz swoje narzędzia wewnętrzne i dashboardy raportowe do konta. Katalog, koszyk, zamówienia i statusy odczytasz w formacie JSON.
• Agenci AI: poproś Claude Code lub Cursor: „znajdź 5 serwisów finansowych z DR 40+ i zamów”. Agent wyszukuje, pokazuje podsumowanie i zamawia dopiero po Twojej zgodzie.
• Make, n8n, Zapier: wystarczy moduł HTTP i klucz.

API sprzedaje artykuł gościnny (guest_post), wstawienie linku (link_insertion) i pakiety SEO/GEO, wyłącznie za kredyty. Zakup kredytów i pozostałe oferty zostają w panelu.

Utwórz klucz

1. Otwórz Panel → Dostęp do API.
2. Nazwij klucz (na przykład „Agent Claude” lub „Raporty Make”) i wybierz jego uprawnienia. Na kluczu, który może zamawiać, możesz ustawić limit na zamówienie i limit na 24 godziny.
3. Skopiuj klucz. Zaczyna się od glf_live_ i jest wyświetlany tylko raz: przechowujemy wyłącznie jego skrót.
4. Wysyłaj go w nagłówku każdego żądania: Authorization: Bearer glf_live_…

Maksymalnie 10 aktywnych kluczy na organizację. Unieważniony klucz natychmiast przestaje działać, podobnie jak klucze członka, który opuszcza organizację. Trzymaj klucz poza repozytoriami kodu: kto go ma, działa w imieniu Twojej organizacji.

Uprawnienia klucza

Każdy klucz ma jedno lub kilka uprawnień. Żądanie bez wymaganego uprawnienia otrzymuje 403 insufficient_scope, a agent AI widzi tylko dozwolone narzędzia.

Szybki start

Wszystkie ścieżki zaczynają się od https://www.getlinkfast.com/api/v1. Zachowaj www: adres bez www przekierowuje, a klient HTTP po przekierowaniu przestaje wysyłać nagłówek Authorization.

Kwoty są w euro bez VAT. Odpowiedzi są w JSON, pola w 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"}'

Zastąp site_id identyfikatorem serwisu z kroku 2. Nigdy nie wysyłaj ceny: serwer ją oblicza.

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

Odpowiedź zawiera id zamówienia, pobraną kwotę i pozostałe saldo. Następnie śledź postęp przez GET /orders/{id}.

Zamawianie za kredyty

API zamawia wyłącznie za kredyty i nigdy nie uruchamia płatności kartą. Kredyty doładowuje się w panelu.

Zamówienie obejmuje pozycje guest_post i link_insertion z koszyka. Pozostałe pozycje, dodane w panelu, zostają w koszyku i są wymienione w skipped_items.

Domyślnie brak limitu: jedyną granicą jest Twoje saldo. Na kluczu, który może zamawiać, ustaw limit na zamówienie i limit na kroczące 24 godziny. Zamówienie, które je przekracza, zostaje odrzucone (403 spending_limit_exceeded, z dostępną resztą), bez obciążenia.

Niewystarczające saldo: 402 insufficient_credits, z brakującą kwotą i linkiem do strony Kredyty, do przekazania osobie z Twojego zespołu. Nic nie zostaje pobrane.

Dalej wszystko działa jak w panelu: e-mail z potwierdzeniem i śledzenie na ekranie Zamówienia, gdzie zamówienie nosi nazwę klucza, który je złożył.

Nagłówek Idempotency-Key

• Wymagany w POST /checkout i POST /packs/orders: od 8 do 128 drukowalnych znaków ASCII, bez spacji. Bez niego: 400 idempotency_key_required.
• Jedna wartość to jeden zamiar zakupu. Ponowne wysłanie tej samej wartości zwraca pierwotne zamówienie (200, "replayed": true) bez drugiego obciążenia, nawet jeśli koszyk się od tego czasu zmienił.
• Po przekroczeniu czasu lub awarii sieci ponów żądanie z tą samą wartością: nie zapłacisz dwa razy.
• Dla nowego zakupu wygeneruj nową wartość, na przykład UUID.
• Zarówno w POST /checkout, jak i w POST /packs/orders wartość użyta już przy innym zakupie zostaje odrzucona: 409 idempotency_conflict, bez obciążenia. Przy pakiecie odrzucona zostaje też ta sama wartość wysłana z inną treścią.
• Po stronie MCP tę rolę pełni token potwierdzenia: nie musisz niczego generować.

Limity

• 120 żądań na minutę na klucz do odczytu i tyle samo, osobno, dla koszyka: jedno nie uszczupla drugiego.
• 10 wywołań na minutę na klucz do tras lub narzędzi zakupowych — łącznie z powtórzeniami, odmowami i krokiem podsumowania MCP.
• 300 żądań HTTP na minutę na klucz na serwerze MCP. Każde wywołane narzędzie liczy się dodatkowo do limitu swojego uprawnienia.
• Powyżej: 429 rate_limited. Czas oczekiwania w sekundach podaje nagłówek Retry-After w HTTP oraz details.retry_after_seconds w wyniku narzędzia MCP.
• Maksymalnie 100 wyników na stronę (page_size).
• Treść żądania: maksymalnie 1 MB.

Kody błędów

Każdy błąd ma tę samą postać. Sprawdzaj code: jest stabilny. message jest po angielsku i przeznaczony dla programisty; details wskazuje błędne pole lub kwoty.

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

Serwer MCP

Serwer MCP daje Twojemu agentowi AI te same funkcje co API, z tym samym kluczem. Jego adres: https://www.getlinkfast.com/api/mcp.

Claude Code

Jedno polecenie w terminalu:

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

Cursor

W ~/.cursor/mcp.json. Unikaj pliku .cursor/mcp.json w projekcie: często trafia do repozytorium, razem z kluczem.

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

Claude Desktop

Claude Desktop nie wysyła niestandardowych nagłówków do zdalnego serwera, więc nie może przekazać Twojego klucza. Połączy się natywnie przez połączenie OAuth, planowane w jednej z kolejnych wersji. Dziś używaj Claude Code lub Cursor: wysyłają klucz w nagłówku Authorization.

Narzędzia

Agent widzi tylko narzędzia dozwolone przez uprawnienia klucza: klucz bez prawa do zamawiania nie ma żadnego narzędzia zakupu.

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

Zakup w dwóch krokach

1. Agent wywołuje checkout lub order_pack bez confirmation_token: nic nie zostaje pobrane. Otrzymuje podsumowanie (pozycje, suma, saldo po obciążeniu, pozostały limit) i confirmation_token.
2. Pokazuje Ci to podsumowanie. Jeśli się zgodzisz, wywołuje narzędzie ponownie z confirmation_token: zamówienie zostaje złożone i pobrane.
3. Token jest ważny 10 minut. Jeśli w międzyczasie zmieni się koszyk, cena lub klucz, zostaje odrzucony (confirmation_expired), a agent powtarza krok 1. Ponowne wywołanie z tym samym tokenem po awarii zwraca to samo zamówienie, bez drugiego obciążenia.

Klient pisany ręcznie

Serwer jest bezsesyjny: każda wiadomość JSON-RPC idzie metodą POST, a odpowiedź przychodzi w JSON. Wysyłaj Accept: application/json, text/event-stream i Content-Type: application/json, inaczej serwer odpowie 406. GET i DELETE zwracają 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"}'

Audyt i planowanie

Agent może zrobić audyt strony, a potem rozłożyć linki na kilka miesięcy na podstawie raportu. Cztery kroki, z narzędziami serwera MCP.

1. run_audit uruchamia pełny audyt domeny: kontrole techniczne, widoczność w ChatGPT i strony, na których link by pomógł. Potrwa to kilka minut. Nic nie jest pobierane, a raport odblokowuje się limitem audytów organizacji, jeśli ją ma. Limit: 10 audytów na klucz na 24 godziny; ponowna prośba o tę samą domenę w ciągu godziny zwraca istniejący audyt.
2. get_audit zwraca status i bieżący etap, a potem raport w summary, gdy status zmieni się na ready. Wywołuj go co 30–60 sekund. list_audits wypisuje audyty organizacji, od najnowszego.
3. plan_links buduje kalendarz z gotowego audytu: miesięczny budżet w euro bez VAT (co najmniej 100 €), od 2 do 12 miesięcy oraz opcjonalnie data startu i strony docelowe. Tak jak przy zakupie, są dwa kroki. Bez tokenu nic nie jest zapisywane: agent dostaje kalendarz (linki, daty wysyłki, suma) i confirmation_token ważny 10 minut. Po Twojej zgodzie wywołuje narzędzie ponownie z tymi samymi polami i tokenem, a plan zostaje zapisany.
4. get_plan śledzi każdy link: stronę docelową, anchor, cenę i stan (zaplanowany, zamówiony, opublikowany, anulowany lub nieudany, z przyczyną niepowodzenia, np. insufficient_credits). cancel_planned_link anuluje link zaplanowany przez API albo wszystkie jeszcze niezamówione linki domeny. Linki zaplanowane przez nasz zespół pozostają na miejscu: team_planned dla jednego linku, skipped_team_planned dla ich liczby.

Zapis planu niczego nie pobiera. Każdy link jest pobierany w kredytach w dniu wysyłki, po cenie odczytanej ponownie tego dnia, podczas codziennego porannego przebiegu (około 06:20 UTC). Jeśli tego dnia brakuje salda, link nie jest zamawiany i w get_plan ma status nieudanego. Linku już zamówionego nie da się anulować.

Uprawnienia: run_audit i cancel_planned_link wymagają cart, plan_links wymaga purchase, a get_audit, list_audits i get_plan wymagają read. Limity wydatków klucza obowiązują także dla zaplanowanych linków.

W panelu strona Delegowanie pokazuje te linki w bloku „Zaplanowane linki”. Właściciel organizacji może tam usunąć linki zaplanowane przez API. Linki zaplanowane przez nasz zespół są tylko do odczytu.

Dokumentacja referencyjna

Każda ścieżka z jej uprawnieniem i odpowiadającym jej narzędziem MCP. Parametry, schematy odpowiedzi i błędy dla każdej ścieżki: opis OpenAPI 3.1.

Pytanie o API? Napisz do nas, odpowie Ci osoba z zespołu.