API y servidor MCP de GetLinkFast

Para qué sirve

• Agencias y equipos SEO: conecte sus herramientas internas y sus tableros de seguimiento a su cuenta. Catálogo, carrito, pedidos y estados se leen en JSON.
• Agentes de IA: pida a Claude Code o Cursor «encuéntrame 5 sitios de finanzas con DR 40+ y haz el pedido». El agente busca, le muestra el resumen y solo hace el pedido con su aprobación.
• Make, n8n, Zapier: basta con un módulo HTTP y una clave.

La API vende el artículo de invitado (guest_post), la inserción de enlace (link_insertion) y los packs SEO/GEO, solo con créditos. La compra de créditos y las demás ofertas siguen en el panel.

Crear una clave

1. Abra Panel → Acceso API.
2. Asigne un nombre a la clave (por ejemplo «Agente Claude» o «Informes Make») y elija sus permisos. En una clave que puede hacer pedidos, puede fijar un tope por pedido y un tope en 24 horas.
3. Copie la clave. Empieza por glf_live_ y solo se muestra una vez: solo guardamos una huella de ella.
4. Envíela en la cabecera de cada solicitud: Authorization: Bearer glf_live_…

Como máximo 10 claves activas por organización. Una clave revocada deja de funcionar de inmediato, al igual que las claves de un miembro que abandona la organización. Mantenga la clave fuera de sus repositorios de código: quien la tenga actúa en nombre de su organización.

Los permisos de una clave

Cada clave lleva uno o varios permisos. Una solicitud sin el permiso necesario recibe 403 insufficient_scope, y un agente de IA solo ve las herramientas permitidas.

Inicio rápido

Todas las rutas empiezan por https://www.getlinkfast.com/api/v1. Mantenga el www: la dirección sin www redirige, y un cliente HTTP deja de enviar la cabecera Authorization tras una redirección.

Los importes están en euros sin IVA. Las respuestas son JSON, con campos en 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"}'

Sustituya site_id por el id de un sitio del paso 2. No envíe nunca un precio: lo calcula el servidor.

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

La respuesta da el id del pedido, el importe cargado y su saldo restante. Después, siga su avance con GET /orders/{id}.

Pedir con créditos

La API pide solo con créditos y nunca inicia un pago con tarjeta. Los créditos se recargan en el panel.

Un pedido toma las líneas guest_post y link_insertion del carrito. Las demás líneas, añadidas desde el panel, se quedan en el carrito y se listan en skipped_items.

Sin tope por defecto: su saldo es el único límite. En una clave que puede hacer pedidos, fije un tope por pedido y un tope en 24 horas móviles. Un pedido que los supere se rechaza (403 spending_limit_exceeded, con lo que queda disponible), sin cargo.

Saldo insuficiente: 402 insufficient_credits, con el importe que falta y el enlace a la página Créditos, para transmitirlo a alguien de su equipo. No se carga nada.

Después, todo funciona como desde el panel: email de confirmación y seguimiento en la pantalla Pedidos, donde el pedido lleva el nombre de la clave que lo hizo.

La cabecera Idempotency-Key

• Obligatoria en POST /checkout y POST /packs/orders: de 8 a 128 caracteres ASCII imprimibles, sin espacios. Sin ella: 400 idempotency_key_required.
• Un valor equivale a una intención de compra. Reenviar el mismo valor devuelve el pedido original (200, "replayed": true) sin un segundo cargo, aunque el carrito haya cambiado desde entonces.
• Tras un tiempo de espera agotado o un corte de red, reintente con el mismo valor: no pagará dos veces.
• Para una nueva compra, genere un nuevo valor, por ejemplo un UUID.
• Tanto en POST /checkout como en POST /packs/orders, un valor que ya sirvió para otra compra se rechaza: 409 idempotency_conflict, sin cargo. Para un pack, el mismo valor enviado con otro contenido también se rechaza.
• En el lado MCP, el token de confirmación cumple esta función: no tiene nada que generar.

Límites

• 120 solicitudes por minuto y por clave para la lectura, y otras tantas, por separado, para el carrito: una no consume de la otra.
• 10 llamadas por minuto y por clave a las rutas o herramientas de compra — reintentos, rechazos y paso de resumen MCP incluidos.
• 300 solicitudes HTTP por minuto y por clave en el servidor MCP. Cada herramienta llamada cuenta además en el límite de su permiso.
• Por encima: 429 rate_limited. La espera, en segundos, la indica la cabecera Retry-After en HTTP, y details.retry_after_seconds en el resultado de una herramienta MCP.
• Como máximo 100 resultados por página (page_size).
• Cuerpo de la solicitud: 1 MB como máximo.

Códigos de error

Todos los errores tienen la misma forma. Compruebe code: es estable. message está en inglés y se dirige al desarrollador; details indica el campo erróneo o los importes.

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

Servidor MCP

El servidor MCP da a su agente de IA las mismas funciones que la API, con la misma clave. Su dirección: https://www.getlinkfast.com/api/mcp.

Claude Code

Un comando en su terminal:

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

Cursor

En ~/.cursor/mcp.json. Evite el archivo .cursor/mcp.json de un proyecto: a menudo acaba en el repositorio, con la clave.

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

Claude Desktop

Claude Desktop no envía cabeceras personalizadas a un servidor remoto, así que no puede transmitir su clave. Se conectará de forma nativa con la conexión OAuth, prevista en una próxima versión. Hoy, use Claude Code o Cursor: envían la clave en la cabecera Authorization.

Las herramientas

El agente solo ve las herramientas permitidas por los permisos de la clave: una clave sin permiso para pedir no tiene ninguna herramienta de compra.

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

La compra en dos pasos

1. El agente llama a checkout o order_pack sin confirmation_token: no se carga nada. Recibe el resumen (líneas, total, saldo tras el cargo, tope restante) y un confirmation_token.
2. Le muestra ese resumen. Si usted acepta, vuelve a llamar a la herramienta con el confirmation_token: el pedido se realiza y se carga.
3. El token vale 10 minutos. Si mientras tanto cambia el carrito, un precio o la clave, se rechaza (confirmation_expired) y el agente repite el paso 1. Volver a llamar con el mismo token tras un corte devuelve el mismo pedido, sin segundo cargo.

Cliente escrito a mano

El servidor no tiene sesión: cada mensaje JSON-RPC se envía como POST y la respuesta llega en JSON. Envíe Accept: application/json, text/event-stream y Content-Type: application/json; si no, el servidor responde 406. GET y DELETE responden 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"}'

Auditar y planificar

Un agente puede auditar un sitio y repartir enlaces a lo largo de varios meses a partir del informe. Cuatro pasos, con las herramientas del servidor MCP.

1. run_audit lanza la auditoría completa de un dominio: controles técnicos, visibilidad en ChatGPT y sitios donde un enlace ayudaría. Cuente unos minutos. No se carga nada, y el informe se desbloquea con la cuota de auditorías de la organización si la tiene. Límite: 10 auditorías por clave y por 24 horas; si se pide el mismo dominio otra vez en la hora siguiente, se devuelve la auditoría existente.
2. get_audit devuelve el estado y el paso en curso, y después el informe en summary cuando el estado pasa a ready. Llámela cada 30 a 60 segundos. list_audits lista las auditorías de la organización, de la más reciente a la más antigua.
3. plan_links prepara un calendario a partir de una auditoría lista: un presupuesto mensual en euros sin IVA (al menos 100 €), de 2 a 12 meses y, opcionalmente, una fecha de inicio y las páginas objetivo. Como en una compra, hay dos pasos. Sin token no se guarda nada: el agente recibe el calendario (enlaces, fechas de envío, total) y un confirmation_token válido 10 minutos. Con su aprobación, vuelve a llamar a la herramienta con los mismos campos y el token, y el plan se guarda.
4. get_plan sigue cada enlace: página de destino, ancla, precio y estado (programado, pedido, publicado, cancelado o fallido, con la causa del fallo, por ejemplo insufficient_credits). cancel_planned_link cancela un enlace planificado por la API o todos los de un dominio que aún no se han pedido. Los enlaces programados por nuestro equipo se mantienen: team_planned para un enlace, skipped_team_planned para su número.

Al guardar el plan no se carga nada. Cada enlace se carga en créditos el día de su envío, al precio releído ese día, en el pase diario de la mañana (hacia las 06:20 UTC). Si falta saldo ese día, el enlace no se pide y aparece como fallido en get_plan. Un enlace ya pedido no se puede cancelar.

Permisos: run_audit y cancel_planned_link necesitan cart, plan_links necesita purchase, y get_audit, list_audits y get_plan necesitan read. Los topes de gasto de la clave se aplican a los enlaces planificados.

En el panel, la página Delegación muestra estos enlaces en el bloque «Enlaces programados». El propietario de la organización puede retirar ahí los enlaces planificados por la API. Los que planifica nuestro equipo son solo de lectura.

Referencia

Cada ruta con su permiso y la herramienta MCP que le corresponde. Parámetros, esquemas de respuesta y errores ruta por ruta: la descripción OpenAPI 3.1.

¿Una pregunta sobre la API? Escríbanos, una persona del equipo le responde.