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? Напишите нам, вам ответит человек из команды.