API și server MCP GetLinkFast

La ce folosește

• Agenții și echipe SEO: conectează instrumentele interne și panourile de raportare la contul tău. Catalogul, coșul, comenzile și stările se citesc în JSON.
• Agenți AI: cere-i lui Claude Code sau Cursor „găsește-mi 5 site-uri de finanțe cu DR 40+ și comandă”. Agentul caută, îți arată rezumatul și comandă doar după acordul tău.
• Make, n8n, Zapier: un modul HTTP și o cheie sunt suficiente.

API-ul vinde articolul invitat (guest_post), inserarea de link (link_insertion) și pachetele SEO/GEO, numai cu credite. Cumpărarea de credite și celelalte oferte rămân în panou.

Creează o cheie

1. Deschide Panou → Acces API.
2. Denumește cheia (de exemplu „Agent Claude” sau „Raportare Make”) și alege-i permisiunile. Pe o cheie care poate comanda, poți fixa un plafon pe comandă și un plafon pe 24 de ore.
3. Copiază cheia. Începe cu glf_live_ și se afișează o singură dată: păstrăm doar o amprentă a ei.
4. Trimite-o în antetul fiecărei cereri: Authorization: Bearer glf_live_…

Cel mult 10 chei active pe organizație. O cheie revocată nu mai funcționează imediat, la fel ca cheile unui membru care părăsește organizația. Ține cheia în afara depozitelor de cod: cine o deține acționează în numele organizației tale.

Permisiunile unei chei

Fiecare cheie are una sau mai multe permisiuni. O cerere fără permisiunea necesară primește 403 insufficient_scope, iar un agent AI vede doar instrumentele permise.

Pornire rapidă

Toate rutele încep cu https://www.getlinkfast.com/api/v1. Păstrează www: adresa fără www redirecționează, iar un client HTTP nu mai trimite antetul Authorization după o redirecționare.

Sumele sunt în euro fără TVA. Răspunsurile sunt în JSON, câmpurile în 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"}'

Înlocuiește site_id cu id-ul unui site de la pasul 2. Nu trimite niciodată un preț: serverul îl calculează.

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

Răspunsul conține id-ul comenzii, suma debitată și soldul rămas. Apoi urmărește progresul cu GET /orders/{id}.

Comandarea cu credite

API-ul comandă numai cu credite și nu declanșează niciodată o plată cu cardul. Creditele se reîncarcă din panou.

O comandă preia liniile guest_post și link_insertion din coș. Celelalte linii, adăugate din panou, rămân în coș și sunt listate în skipped_items.

Niciun plafon implicit: soldul tău este singura limită. Pe o cheie care poate comanda, fixează un plafon pe comandă și un plafon pe 24 de ore glisante. O comandă care le depășește este refuzată (403 spending_limit_exceeded, cu restul disponibil), fără debitare.

Sold insuficient: 402 insufficient_credits, cu suma lipsă și linkul paginii Credite, de transmis unei persoane din echipa ta. Nu se debitează nimic.

Apoi totul decurge ca din panou: email de confirmare și urmărire în ecranul Comenzi, unde comanda poartă numele cheii care a plasat-o.

Antetul Idempotency-Key

• Obligatoriu pe POST /checkout și POST /packs/orders: între 8 și 128 caractere ASCII imprimabile, fără spații. Fără el: 400 idempotency_key_required.
• O valoare înseamnă o intenție de cumpărare. Retrimiterea aceleiași valori returnează comanda inițială (200, "replayed": true) fără a doua debitare, chiar dacă între timp coșul s-a schimbat.
• După un timeout sau o întrerupere a rețelei, reîncearcă cu aceeași valoare: nu vei plăti de două ori.
• Pentru o cumpărare nouă, generează o valoare nouă, de exemplu un UUID.
• Atât pe POST /checkout, cât și pe POST /packs/orders, o valoare deja folosită pentru altă cumpărare este refuzată: 409 idempotency_conflict, fără debitare. Pentru un pachet, aceeași valoare trimisă cu alt conținut este și ea refuzată.
• Pe partea MCP, tokenul de confirmare joacă acest rol: nu ai nimic de generat.

Limite

• 120 cereri pe minut și pe cheie pentru citire și tot atâtea, separat, pentru coș: una nu o consumă pe cealaltă.
• 10 apeluri pe minut și pe cheie către rutele sau instrumentele de cumpărare — inclusiv reluările, refuzurile și pasul de rezumat MCP.
• 300 cereri HTTP pe minut și pe cheie pe serverul MCP. Fiecare instrument apelat se socotește în plus în limita permisiunii sale.
• Peste acestea: 429 rate_limited. Așteptarea, în secunde, e dată de antetul Retry-After în HTTP și de details.retry_after_seconds în rezultatul unui instrument MCP.
• Cel mult 100 rezultate pe pagină (page_size).
• Corpul cererii: cel mult 1 MB.

Coduri de eroare

Orice eroare are aceeași formă. Testează code: este stabil. message este în engleză și se adresează dezvoltatorului; details indică câmpul greșit sau sumele.

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

Serverul MCP îi oferă agentului tău AI aceleași funcții ca API-ul, cu aceeași cheie. Adresa lui: https://www.getlinkfast.com/api/mcp.

Claude Code

O comandă în terminal:

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

Cursor

În ~/.cursor/mcp.json. Evită fișierul .cursor/mcp.json al unui proiect: ajunge adesea în depozit, împreună cu cheia.

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

Claude Desktop

Claude Desktop nu trimite antete personalizate unui server la distanță, deci nu îți poate transmite cheia. Se va conecta nativ prin conexiunea OAuth, prevăzută într-o versiune viitoare. Astăzi, folosește Claude Code sau Cursor: ele trimit cheia în antetul Authorization.

Instrumentele

Agentul vede doar instrumentele permise de permisiunile cheii: o cheie fără dreptul de a comanda nu are niciun instrument de cumpărare.

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

Cumpărarea în doi pași

1. Agentul apelează checkout sau order_pack fără confirmation_token: nu se debitează nimic. Primește rezumatul (linii, total, sold după debitare, plafon rămas) și un confirmation_token.
2. Îți arată acest rezumat. Dacă accepți, apelează din nou instrumentul cu confirmation_token: comanda este plasată și debitată.
3. Tokenul este valabil 10 minute. Dacă între timp se schimbă coșul, un preț sau cheia, este refuzat (confirmation_expired) și agentul reia pasul 1. Un nou apel cu același token după o întrerupere returnează aceeași comandă, fără a doua debitare.

Client scris de mână

Serverul este fără sesiune: fiecare mesaj JSON-RPC pleacă prin POST, iar răspunsul vine în JSON. Trimite Accept: application/json, text/event-stream și Content-Type: application/json, altfel serverul răspunde 406. GET și DELETE răspund 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 și planificare

Un agent poate audita un site și apoi poate eșalona linkuri pe mai multe luni, pornind de la raport. Patru pași, cu instrumentele serverului MCP.

1. run_audit pornește auditul complet al unui domeniu: verificări tehnice, vizibilitate în ChatGPT și site-uri unde un link ar ajuta. Durează câteva minute. Nu se debitează nimic, iar raportul se deblochează cu cota de audituri a organizației, dacă are una. Limită: 10 audituri pe cheie la fiecare 24 de ore; dacă ceri același domeniu din nou în decurs de o oră, primești auditul existent.
2. get_audit returnează starea și etapa curentă, apoi raportul în summary când starea devine ready. Apelează-l la fiecare 30–60 de secunde. list_audits listează auditurile organizației, de la cel mai recent.
3. plan_links construiește un calendar dintr-un audit gata: un buget lunar în euro fără TVA (cel puțin 100 €), de la 2 la 12 luni și, opțional, o dată de start și paginile vizate. Ca la o achiziție, sunt doi pași. Fără token nu se salvează nimic: agentul primește calendarul (linkuri, date de trimitere, total) și un confirmation_token valabil 10 minute. După acordul tău, reapelează instrumentul cu aceleași câmpuri și cu tokenul, iar planul se salvează.
4. get_plan urmărește fiecare link: pagina țintă, ancora, prețul și starea (programat, comandat, publicat, anulat sau eșuat, cu cauza eșecului, de exemplu insufficient_credits). cancel_planned_link anulează un link planificat prin API sau toate linkurile unui domeniu încă necomandate. Linkurile programate de echipa noastră rămân pe loc: team_planned pentru un link, skipped_team_planned pentru numărul lor.

La salvarea planului nu se debitează nimic. Fiecare link se debitează în credite în ziua trimiterii, la prețul recitit în acea zi, la trecerea zilnică de dimineață (în jur de 06:20 UTC). Dacă soldul lipsește în acea zi, linkul nu se comandă și apare ca eșuat în get_plan. Un link deja comandat nu mai poate fi anulat.

Drepturi: run_audit și cancel_planned_link cer cart, plan_links cere purchase, iar get_audit, list_audits și get_plan cer read. Plafoanele de cheltuieli ale cheii se aplică și linkurilor planificate.

În panou, pagina Delegare arată aceste linkuri în blocul „Linkuri programate”. Proprietarul organizației poate retrage acolo linkurile planificate prin API. Cele planificate de echipa noastră sunt doar pentru citire.

Referință

Fiecare rută cu permisiunea sa și instrumentul MCP corespunzător. Parametri, scheme de răspuns și erori, rută cu rută: descrierea OpenAPI 3.1.

O întrebare despre API? Scrie-ne, o persoană din echipă îți răspunde.