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 個です。失効したキーはただちに使えなくなります。組織を離れたメンバーのキーも同様です。キーはコードリポジトリに含めないでください。キーを持つ人は誰でも、あなたの組織として操作できます。

キーの権限

各キーには 1 つ以上の権限があります。必要な権限がないリクエストには 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。
• 1 つの値は 1 回の購入意図に対応します。同じ値を再送すると、カートがその後変わっていても、2 回目の引き落としなしに元の注文が返ります（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 が示します。
• 1 ページあたり最大 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

ターミナルでコマンドを 1 つ実行します：

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 からやり直します。切断後に同じトークンで再度呼び出すと、2 回目の引き落としなしに同じ注文が返ります。

クライアントを自作する場合

サーバーはセッションを持ちません。各 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 サーバーのツールを使う 4 つのステップです。

1. run_audit はドメインのフル監査を開始します。技術チェック、ChatGPT での可視性、リンクが役立つサイトを調べます。数分かかります。引き落としは行われず、組織に監査枠があれば、その枠でレポートが開きます。上限はキーあたり 24 時間で 10 件です。同じドメインを 1 時間以内に再度依頼すると、既存の監査が返ります。
2. get_audit はステータスと現在のステップを返し、ステータスが ready になるとレポートを summary に返します。30〜60 秒ごとに呼び出してください。list_audits は組織の監査を新しい順に一覧表示します。
3. plan_links は完了した監査からカレンダーを作ります。月額予算（税抜ユーロ、最低 100 €）、2〜12 か月、任意で開始日と対象ページを指定します。購入と同じく 2 段階です。トークンなしでは何も保存されず、エージェントはカレンダー（リンク、送信日、合計）と 10 分間有効な confirmation_token を受け取ります。あなたの承認後、同じ項目とトークンでツールをもう一度呼び出すと、プランが保存されます。
4. get_plan は各リンクを追跡します。対象ページ、アンカー、価格、状態（予定、注文済み、公開済み、キャンセル済み、失敗のいずれかで、失敗には insufficient_credits などの原因が付きます）。cancel_planned_link は API で計画したリンク 1 件、またはドメインのまだ注文されていないリンクすべてをキャンセルします。当社チームが予定に組み込んだリンクはそのまま残ります。1 件なら 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 についてご質問がありますか？お問い合わせください。チームの担当者がお答えします。