API і сервер MCP GetLinkFast

Для чого це

• Агенції та SEO-команди: підключіть свої внутрішні інструменти й панелі звітності до акаунта. Каталог, кошик, замовлення та статуси читаються в JSON.
• ШІ-агенти: попросіть Claude Code або Cursor «знайди 5 фінансових сайтів із DR 40+ і замов». Агент шукає, показує вам підсумок і замовляє лише після вашої згоди.
• 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, а ШІ-агент бачить лише дозволені інструменти.

Швидкий старт

Усі маршрути починаються з https://www.getlinkfast.com/api/v1. Зберігайте www: адреса без www перенаправляє, а HTTP-клієнт після перенаправлення більше не надсилає заголовок Authorization.

Суми вказано в євро без ПДВ. Відповіді в 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 на id сайту з кроку 2. Ніколи не надсилайте ціну: її обчислює сервер.

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.
• 300 HTTP-запитів на хвилину на ключ на сервері MCP. Кожен викликаний інструмент додатково враховується в ліміті свого права.
• Понад це: 429 rate_limited. Час очікування в секундах вказує заголовок Retry-After у HTTP і details.retry_after_seconds у результаті інструмента MCP.
• Не більше 100 результатів на сторінку (page_size).
• Тіло запиту: не більше 1 МБ.

Коди помилок

Усі помилки мають однакову форму. Перевіряйте 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 дає вашому ШІ-агенту ті самі функції, що й 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 і сайти, де посилання допомогло б. Це займає кілька хвилин. Нічого не списується, а звіт відкривається квотою аудитів організації, якщо вона є. Ліміт: 10 аудитів на ключ за 24 години; повторний запит того самого домену протягом години поверне наявний аудит.
2. get_audit повертає статус і поточний етап, а коли статус стане ready, ще й звіт у summary. Викликайте його раз на 30–60 секунд. list_audits перелічує аудити організації, спочатку нові.
3. plan_links будує календар за готовим аудитом: місячний бюджет у євро без ПДВ (щонайменше 100 €), від 2 до 12 місяців і, за бажанням, дата старту та цільові сторінки. Як і покупка, це два кроки. Без токена нічого не зберігається: агент отримує календар (посилання, дати надсилання, підсумок) і confirmation_token, чинний 10 хвилин. Після вашої згоди він знову викликає інструмент з тими самими полями й токеном, і план зберігається.
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? Напишіть нам, вам відповість людина з команди.