API e servidor MCP da GetLinkFast

Para que serve

• Agências e equipes de SEO: conecte suas ferramentas internas e seus painéis de acompanhamento à sua conta. Catálogo, carrinho, pedidos e status são lidos em JSON.
• Agentes de IA: peça ao Claude Code ou ao Cursor “encontre 5 sites de finanças com DR 40+ e faça o pedido”. O agente pesquisa, mostra o resumo e só faz o pedido depois da sua aprovação.
• Make, n8n, Zapier: um módulo HTTP e uma chave bastam.

A API vende o artigo convidado (guest_post), a inserção de link (link_insertion) e os pacotes SEO/GEO, somente com créditos. A compra de créditos e as outras ofertas continuam no painel.

Criar uma chave

1. Abra Painel → Acesso à API.
2. Dê um nome à chave (por exemplo “Agente Claude” ou “Relatórios Make”) e escolha suas permissões. Em uma chave que pode fazer pedidos, você pode definir um limite por pedido e um limite em 24 horas.
3. Copie a chave. Ela começa com glf_live_ e é exibida uma única vez: guardamos apenas uma impressão dela.
4. Envie-a no cabeçalho de cada requisição: Authorization: Bearer glf_live_…

No máximo 10 chaves ativas por organização. Uma chave revogada para de funcionar na hora, assim como as chaves de um membro que sai da organização. Mantenha a chave fora dos seus repositórios de código: quem a tem age em nome da sua organização.

As permissões de uma chave

Cada chave tem uma ou mais permissões. Uma requisição sem a permissão necessária recebe 403 insufficient_scope, e um agente de IA só vê as ferramentas permitidas.

Início rápido

Todas as rotas começam com https://www.getlinkfast.com/api/v1. Mantenha o www: o endereço sem www redireciona, e um cliente HTTP deixa de enviar o cabeçalho Authorization após um redirecionamento.

Os valores estão em euros sem IVA. As respostas são em JSON, com campos em 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"}'

Substitua site_id pelo id de um site da etapa 2. Nunca envie um preço: o servidor o calcula.

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

A resposta traz o id do pedido, o valor debitado e seu saldo restante. Depois, acompanhe o andamento com GET /orders/{id}.

Fazer pedidos com créditos

A API faz pedidos somente com créditos e nunca inicia um pagamento com cartão. Os créditos são recarregados no painel.

Um pedido usa os itens guest_post e link_insertion do carrinho. Os outros itens, adicionados pelo painel, ficam no carrinho e são listados em skipped_items.

Nenhum limite por padrão: seu saldo é o único limite. Em uma chave que pode fazer pedidos, defina um limite por pedido e um limite em 24 horas corridas. Um pedido que os ultrapasse é recusado (403 spending_limit_exceeded, com o valor ainda disponível), sem débito.

Saldo insuficiente: 402 insufficient_credits, com o valor que falta e o link da página Créditos, para repassar a alguém da sua equipe. Nada é debitado.

Depois, tudo funciona como no painel: email de confirmação e acompanhamento na tela Pedidos, onde o pedido leva o nome da chave que o fez.

O cabeçalho Idempotency-Key

• Obrigatório em POST /checkout e POST /packs/orders: de 8 a 128 caracteres ASCII imprimíveis, sem espaços. Sem ele: 400 idempotency_key_required.
• Um valor equivale a uma intenção de compra. Reenviar o mesmo valor retorna o pedido original (200, "replayed": true) sem segundo débito, mesmo que o carrinho tenha mudado desde então.
• Após um tempo limite excedido ou uma queda de rede, repita com o mesmo valor: você não pagará duas vezes.
• Para uma nova compra, gere um novo valor, por exemplo um UUID.
• Tanto em POST /checkout quanto em POST /packs/orders, um valor já usado em outra compra é recusado: 409 idempotency_conflict, sem débito. Para um pacote, o mesmo valor enviado com outro conteúdo também é recusado.
• No lado MCP, o token de confirmação cumpre esse papel: você não precisa gerar nada.

Limites

• 120 requisições por minuto e por chave para leitura, e outras tantas, separadamente, para o carrinho: uma não consome a outra.
• 10 chamadas por minuto e por chave às rotas ou ferramentas de compra — repetições, recusas e etapa de resumo MCP incluídas.
• 300 requisições HTTP por minuto e por chave no servidor MCP. Cada ferramenta chamada conta também no limite da sua permissão.
• Acima disso: 429 rate_limited. A espera, em segundos, é indicada pelo cabeçalho Retry-After em HTTP, e por details.retry_after_seconds no resultado de uma ferramenta MCP.
• No máximo 100 resultados por página (page_size).
• Corpo da requisição: no máximo 1 MB.

Códigos de erro

Todo erro tem a mesma forma. Teste code: ele é estável. message está em inglês e se dirige ao desenvolvedor; details indica o campo com erro ou os valores.

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

O servidor MCP dá ao seu agente de IA as mesmas funções da API, com a mesma chave. O endereço dele: https://www.getlinkfast.com/api/mcp.

Claude Code

Um comando no seu terminal:

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

Cursor

Em ~/.cursor/mcp.json. Evite o arquivo .cursor/mcp.json de um projeto: ele costuma ir parar no repositório, junto com a chave.

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

Claude Desktop

O Claude Desktop não envia cabeçalhos personalizados a um servidor remoto, então não consegue transmitir sua chave. Ele vai se conectar de forma nativa com a conexão OAuth, prevista para uma próxima versão. Hoje, use o Claude Code ou o Cursor: eles enviam a chave no cabeçalho Authorization.

As ferramentas

O agente só vê as ferramentas permitidas pelas permissões da chave: uma chave sem permissão para fazer pedidos não tem nenhuma ferramenta 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

A compra em duas etapas

1. O agente chama checkout ou order_pack sem confirmation_token: nada é debitado. Ele recebe o resumo (itens, total, saldo após o débito, limite restante) e um confirmation_token.
2. Ele mostra esse resumo a você. Se você aceitar, ele chama a ferramenta de novo com o confirmation_token: o pedido é feito e debitado.
3. O token vale 10 minutos. Se nesse meio-tempo o carrinho, um preço ou a chave mudar, ele é recusado (confirmation_expired) e o agente refaz a etapa 1. Chamar de novo com o mesmo token após uma queda retorna o mesmo pedido, sem segundo débito.

Cliente escrito à mão

O servidor não tem sessão: cada mensagem JSON-RPC é enviada via POST e a resposta chega em JSON. Envie Accept: application/json, text/event-stream e Content-Type: application/json; caso contrário, o servidor responde 406. GET e DELETE respondem 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 e planejar

Um agente pode auditar um site e distribuir links ao longo de vários meses a partir do relatório. Quatro etapas, com as ferramentas do servidor MCP.

1. run_audit inicia a auditoria completa de um domínio: verificações técnicas, visibilidade no ChatGPT e sites onde um link ajudaria. Conte alguns minutos. Nada é debitado, e o relatório é liberado com a cota de auditorias da organização, quando ela tem uma. Limite: 10 auditorias por chave a cada 24 horas; pedir o mesmo domínio de novo dentro de uma hora devolve a auditoria existente.
2. get_audit devolve o estado e a etapa atual, depois o relatório em summary quando o estado passa a ready. Chame-o a cada 30 a 60 segundos. list_audits lista as auditorias da organização, da mais recente para a mais antiga.
3. plan_links monta um calendário a partir de uma auditoria pronta: um orçamento mensal em euros sem IVA (pelo menos 100 €), de 2 a 12 meses e, opcionalmente, uma data de início e as páginas de destino. Como numa compra, são duas etapas. Sem token nada é salvo: o agente recebe o calendário (links, datas de envio, total) e um confirmation_token válido por 10 minutos. Com a sua aprovação, ele chama a ferramenta de novo com os mesmos campos e o token, e o plano é salvo.
4. get_plan acompanha cada link: página de destino, âncora, preço e estado (programado, pedido, publicado, cancelado ou com falha, com a causa da falha, por exemplo insufficient_credits). cancel_planned_link cancela um link planeado pela API ou todos os de um domínio ainda não pedidos. Os links programados pela nossa equipa mantêm-se: team_planned para um link, skipped_team_planned para o seu número.

Nada é debitado ao salvar o plano. Cada link é debitado em créditos no dia do seu envio, ao preço relido nesse dia, na passagem diária da manhã (por volta das 06:20 UTC). Se faltar saldo nesse dia, o link não é pedido e aparece como falha em get_plan. Um link já pedido não pode mais ser cancelado.

Permissões: run_audit e cancel_planned_link exigem cart, plan_links exige purchase, e get_audit, list_audits e get_plan exigem read. Os limites de gasto da chave valem também para os links planejados.

No painel, a página Delegação mostra esses links no bloco «Links programados». O proprietário da organização pode retirar ali os links planejados pela API. Os que a nossa equipe planejou são somente leitura.

Referência

Cada rota com sua permissão e a ferramenta MCP correspondente. Parâmetros, esquemas de resposta e erros rota a rota: a descrição OpenAPI 3.1.

Uma dúvida sobre a API? Escreva para nós, uma pessoa da equipe responde.