GetLinkFast API 및 MCP 서버

활용 방법

• 에이전시와 SEO 팀: 내부 도구와 리포팅 대시보드를 계정에 연결하세요. 카탈로그, 장바구니, 주문, 상태를 JSON으로 읽을 수 있습니다.
• AI 에이전트: Claude Code나 Cursor에 “DR 40 이상인 금융 사이트 5개를 찾아서 주문해 줘”라고 요청하세요. 에이전트가 검색하고 요약을 보여 준 뒤, 승인한 경우에만 주문합니다.
• 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를 받으며, AI 에이전트에는 허용된 도구만 보입니다.

빠른 시작

모든 경로는 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를 2단계에서 찾은 사이트의 id로 바꾸세요. 가격은 절대 보내지 마세요. 서버가 계산합니다.

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에 필수입니다. 공백 없이 인쇄 가능한 ASCII 문자 8~128자. 없으면: 400 idempotency_key_required.
• 하나의 값은 하나의 구매 의도에 해당합니다. 같은 값을 다시 보내면 그사이 장바구니가 바뀌었더라도 두 번째 차감 없이 원래 주문이 반환됩니다(200, "replayed": true).
• 시간 초과나 네트워크 끊김 후에는 같은 값으로 다시 시도하세요. 두 번 결제되지 않습니다.
• 새 구매에는 UUID 같은 새 값을 생성하세요.
• POST /checkout와 POST /packs/orders 모두에서, 다른 구매에 이미 쓴 값은 거부됩니다: 409 idempotency_conflict, 차감 없음. 팩의 경우 같은 값을 다른 내용으로 보내도 거부됩니다.
• MCP에서는 확인 토큰이 이 역할을 하므로 값을 생성할 필요가 없습니다.

제한

• 조회는 키당 분당 120회, 장바구니는 별도로 같은 횟수입니다. 한쪽이 다른 쪽 한도를 쓰지 않습니다.
• 구매 경로 또는 도구 호출은 키당 분당 10회 — 재전송, 거부, MCP 요약 단계 포함.
• MCP 서버의 HTTP 요청은 키당 분당 300회. 호출한 각 도구는 해당 권한의 한도에도 함께 집계됩니다.
• 초과 시: 429 rate_limited. 대기 시간(초)은 HTTP에서는 Retry-After 헤더가, MCP 도구 결과에서는 details.retry_after_seconds가 알려 줍니다.
• 페이지당 최대 100개 결과(page_size).
• 요청 본문: 최대 1 MB.

오류 코드

모든 오류는 같은 형식입니다. 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와 같은 기능을 AI 에이전트에 제공합니다. 주소: 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

2단계 구매

1. 에이전트가 confirmation_token 없이 checkout 또는 order_pack을 호출합니다. 아무것도 차감되지 않습니다. 에이전트는 요약(항목, 합계, 차감 후 잔액, 남은 한도)과 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 가시성, 링크가 도움이 될 사이트를 살펴봅니다. 몇 분이 걸립니다. 아무것도 차감되지 않으며, 조직에 감사 할당량이 있으면 그 할당량으로 보고서가 열립니다. 한도는 키당 24시간에 10건입니다. 같은 도메인을 1시간 안에 다시 요청하면 기존 감사가 반환됩니다.
2. get_audit은 상태와 현재 단계를 반환하고, 상태가 ready가 되면 보고서를 summary에 담아 반환합니다. 30~60초마다 호출하세요. list_audits는 조직의 감사를 최신순으로 나열합니다.
3. plan_links는 완료된 감사로 일정을 만듭니다. 월 예산(부가세 제외 유로, 최소 100 €), 2~12개월, 선택 사항으로 시작일과 대상 페이지를 지정합니다. 구매와 마찬가지로 두 단계입니다. 토큰 없이는 아무것도 저장되지 않으며, 에이전트는 일정(링크, 발송일, 합계)과 10분간 유효한 confirmation_token을 받습니다. 승인하시면 같은 항목과 토큰으로 도구를 다시 호출하고, 계획이 저장됩니다.
4. get_plan은 각 링크를 추적합니다. 대상 페이지, 앵커, 가격, 상태(예약됨, 주문됨, 게시됨, 취소됨 또는 실패, 실패 시 insufficient_credits 같은 원인 포함). cancel_planned_link는 API로 계획한 링크 하나, 또는 도메인의 아직 주문되지 않은 모든 링크를 취소합니다. 저희 팀이 일정에 넣은 링크는 그대로 남습니다. 링크 하나는 team_planned, 그 개수는 skipped_team_planned입니다.

계획을 저장할 때는 아무것도 차감되지 않습니다. 각 링크는 발송일에, 그날 다시 읽은 가격으로, 매일 아침 정기 처리(UTC 06:20경) 때 크레딧에서 차감됩니다. 그날 잔액이 부족하면 링크는 주문되지 않고 get_plan에 실패로 표시됩니다. 이미 주문된 링크는 더 이상 취소할 수 없습니다.

권한: run_audit과 cancel_planned_link에는 cart, plan_links에는 purchase, get_audit, list_audits, get_plan에는 read가 필요합니다. 키의 지출 한도는 계획된 링크에도 적용됩니다.

대시보드의 위임 페이지는 이 링크들을 “예약된 링크” 블록에 보여 줍니다. 조직 소유자는 API로 예약된 링크를 거기서 철회할 수 있습니다. 저희 팀이 예약한 링크는 읽기 전용입니다.

참조

각 경로와 그 권한, 대응하는 MCP 도구입니다. 경로별 매개변수, 응답 스키마, 오류는 OpenAPI 3.1 명세를 참고하세요.

API에 관해 궁금한 점이 있나요? 문의해 주세요. 팀 담당자가 답변해 드립니다.