Nautilinks Backlinks

Pesquise, compare, ordene e acompanhe posicionamentos de backlinks franceses por meio de um servidor MCP remoto.

Documentação

Compre backlinks de um agente de IA, ou via API

O catálogo Nautilinks é acessível via API REST e servidor MCP. Um agente pode escolher seus formatos, aplicar seus descontos, usar o crédito pré-pago e enviar um link Stripe apenas para o eventual saldo restante.

✓ Autenticação por chave de API✓ Servidor MCP remoto✓ Nenhum cartão é debitado sem validação humana

Disponibilidade verificável

O que se conecta hoje — e o que vem depois

Disponível

API REST, scripts e n8n

Chave Bearer pessoal, endpoints JSON e webhooks assinados.

Disponível

Claude Code, Cursor e clientes MCP com cabeçalhos

Conexão direta ao servidor MCP remoto com a chave Nautilinks.

OAuth em preparação

Diretórios públicos ChatGPT e Claude

A chave de API atual não é suficiente para uma conexão pública nativa. O conector será submetido após a adição de OAuth.

Não apresentamos uma futura presença nos diretórios ChatGPT ou Claude como já disponível. O servidor e as ferramentas existem; a distribuição nativa ainda exige autenticação OAuth compatível com essas plataformas.

Nautilinks vende backlinks diretamente, sem marketplace ou comissão, em uma rede de sites que editamos nós mesmos. Esta página descreve o acesso por máquina a esse mesmo catálogo: uma API REST e um servidor MCP, pensados para que um agente LLM possa buscar um site relevante, fazer um pedido e acompanhar seu andamento, sem que um humano preencha formulário.

O princípio continua o mesmo do resto do site: o catálogo consultado por API é público em sua lógica, os preços são os exibidos no lado humano, e nenhum cartão é jamais debitado sem que um humano valide o pagamento, seja antecipadamente ao abastecer o saldo pré-pago da conta, ou no momento ao abrir um link Stripe. O agente pede, o humano paga, de uma forma ou de outra.

Primeiros passos

Três etapas para conectar um agente

  1. Crie uma conta Nautilinks. Cadastro gratuito, nenhum cartão bancário solicitado nesta etapa. É essa conta que recebe as faturas e paga, no final, via Stripe.
  2. Gere uma chave de API. No espaço do membro, seção « Minha conta » e depois « Chaves de API ». A chave (formato sn_live_...) é exibida uma única vez, para copiar imediatamente. Até 5 chaves ativas por conta, revogáveis a qualquer momento.
  3. Conecte o MCP ou chame a API. Dois caminhos equivalentes: um cliente MCP (Claude Code, claude.ai, Cursor…) que fala com o servidor mcp.nautilinks.co, ou chamadas HTTP diretas em /api/v1/agent/*. O contrato JSON é idêntico nos dois lados.

Sem pacote para instalar

Conectar o servidor MCP

Servidor remoto na Cloudflare (transporte HTTP streamable), sem sessão ou estado mantido no lado Nautilinks. Cada chamada transporta sua própria chave de API.

claude mcp add --transport http nautilinks https://mcp.nautilinks.co/mcp \
  --header "Authorization: Bearer YOUR_API_TOKEN"

claude.ai — Configurações → Conectores → Adicionar conector personalizado

URL : https://mcp.nautilinks.co/mcp
En-tête : Authorization: Bearer YOUR_API_TOKEN

Se o cliente não aceitar cabeçalho personalizado

https://mcp.nautilinks.co/mcp?key=sn_live_votre_cle

Onze ferramentas expostas: catálogo e artigos existentes, projetos e planos de visibilidade de IA, saldo pré-pago, criação de pedidos e acompanhamento de orçamentos/pedidos. Mesmo contrato de dados que a API REST abaixo para esses recursos; os webhooks, por sua vez, só são acessíveis por chamada HTTP direta.

/api/v1/agent/*

Referência da API para agentes

Método

Endpoint

Retorna

Escopo

GET

/api/v1/agent/catalog

Lista os sites da rede nos três raios (Plancton, Corail, Nautilus), filtrável (inclusive por raio via shelf) e paginada.

read

GET

/api/v1/agent/catalog/:id

Ficha completa de um site (métricas, preços, raio, nicho).

read

GET

/api/v1/agent/catalog/:id/articles

Artigos existentes disponíveis para uma inserção vendida uma única vez, com suas palavras-chave e posições.

read

GET

/api/v1/agent/balance

Saldo pré-pago disponível na conta.

read

POST

/api/v1/agent/orders

Cria 1 a 20 links, aplica promoção/boas-vindas e depois crédito; Stripe só recebe o saldo restante.

order

GET

/api/v1/agent/orders

Lista os pedidos feitos com esta chave.

read

GET

/api/v1/agent/orders/:id

Status detalhado por link (a atribuir, publicado…) e URL publicada uma vez no ar.

read

GET

/api/v1/agent/quotes/:id

Consulta um orçamento para saber se o pagamento foi realizado e sob qual número de pedido.

read

GET

/api/v1/agent/webhooks

Lista as assinaturas de webhook ativas da chave.

read

POST

/api/v1/agent/webhooks

Cria uma assinatura (URL + eventos), retorna um segredo exibido uma única vez.

order

DELETE

/api/v1/agent/webhooks/:id

Revoga uma assinatura de webhook.

order

GET

/api/v1/agent/ai-visibility/projects

Lista os projetos de visibilidade de IA da conta.

read

GET

/api/v1/agent/ai-visibility/projects/:id/plan

Produz linhas de pedido prontas para revisão a partir das oportunidades de IA não cobertas.

read

Autenticação

Cada chamada carrega o cabeçalho Authorization: Bearer sn_live_.... A chave é própria de uma conta humana: qualquer pedido criado por API é vinculado a essa conta, faturado em seu endereço e visível em seu espaço do membro da mesma forma que um pedido feito pelo carrinho web. Uma chave recém-criada carrega os dois escopos (read e order) por padrão.

Idempotência dos pedidos

O cabeçalho opcional Idempotency-Key evita duplicatas em caso de reenvio de rede. A chave está ligada ao corpo financeiro: um reenvio idêntico retorna o mesmo orçamento e a mesma sessão Stripe, enquanto um corpo diferente com a mesma chave responde idempotency_key_reused.

Limite diário

Um limite anti-abuso se aplica por chave de API, na ordem de cerca de vinte pedidos por dia. Uma vez atingido, a API responde 429 com o código daily_order_cap_reached. Um reenvio idêntico (mesma Idempotency-Key) nunca conta duas vezes.

Descontos, crédito e depois saldo Stripe

O corpo aceita promo_code. A API recalcula o bruto, compara esse código com a oferta de boas-vindas automática, aplica o melhor desconto e depois o crédito pré-pago. Se o crédito cobrir o líquido, o pedido é concluído sem Stripe. Se for parcial, ele é colocado em hold e payment_url só fatura o saldo restante; um abandono restitui o hold. A resposta detalha gross_total_eur, discount_eur, credit_applied_cents e card_amount_cents. Nenhum cartão é debitado sem validação humana.

Webhooks

Uma assinatura de webhook (POST /api/v1/agent/webhooks, escopo order, até 5 ativas por conta) recebe order.accepted, order.published e order.cancelled em uma URL HTTPS pública escolhida pelo agente. Cada entrega é assinada: o cabeçalho Nautilinks-Signature carrega um HMAC-SHA256 calculado sobre o timestamp e o corpo bruto, com uma chave derivada do segredo retornado na criação (nunca o segredo em texto claro). GET /api/v1/agent/webhooks lista as assinaturas ativas, DELETE /api/v1/agent/webhooks/:id revoga uma.

Ponta a ponta

Exemplo completo, catálogo e depois pedido

1. Buscar um site no catálogo (aqui no raio Plancton)

curl -s "https://nautilinks.co/api/v1/agent/catalog?niche=voyage&shelf=Plancton&limit=5" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "ok": true,
  "count": 1,
  "total": 1,
  "sites": [
    {
      "id": 214,
      "domain": "exemple-voyage.fr",
      "niche_label": "Voyage",
      "language": "fr",
      "tf": 14,
      "traffic_monthly": 2100,
      "price_eur": 5,
      "price_shelf": "Plancton"
    }
  ]
}

A resposta completa também traz shelves, a descrição dos três raios (preços e critério), para que um agente descubra a oferta sem documentação externa.

curl -s -X POST "https://nautilinks.co/api/v1/agent/orders" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: cmd-2026-07-24-01" \
  -d '{
    "promo_code": "PARTENAIRE10",
    "items": [
      {
        "site_id": 214,
        "target_url": "https://votre-site.fr/page-cible/",
        "anchor_text": "assurance voyage longue duree",
        "anchor_type": "partial"
      }
    ]
  }'

Resposta se o saldo pré-pago cobrir o total

{
  "ok": true,
  "quote_id": "qt_8f2c...",
  "gross_total_eur": 5,
  "total_eur": 5,
  "discount_eur": 0,
  "credit_applied_cents": 500,
  "card_amount_cents": 0,
  "payment_url": null,
  "items_count": 1,
  "order_id": "ord_9a1d...",
  "order_status": "paid"
}

Resposta com crédito parcial (o humano só paga o saldo restante)

{
  "ok": true,
  "quote_id": "qt_8f2c...",
  "gross_total_eur": 5,
  "total_eur": 5,
  "discount_eur": 0,
  "credit_applied_cents": 200,
  "card_amount_cents": 300,
  "payment_url": "https://checkout.stripe.com/c/pay/...",
  "items_count": 1
}

Se payment_url valer null, o pedido já está pago pelo saldo pré-pago: order_id e order_status o descrevem diretamente. Caso contrário, o agente transmite payment_url ao humano; uma vez o pagamento feito, GET /api/v1/agent/quotes/qt_8f2c... retorna o order_id resultante, e depois GET /api/v1/agent/orders/:id acompanha o link até sua publicação.

Perguntas frequentes

Um agente de IA pode pagar sozinho, sem intervenção humana?

Se o crédito pré-pago cobrir o líquido após desconto, o pedido é pago diretamente. Se for parcial, ele é retido e um link Stripe só fatura o saldo restante ao humano. Sem crédito, o Stripe fatura o líquido completo. Nenhum cartão é jamais debitado automaticamente.

Quais links são compráveis por API hoje?

Os três raios do catálogo: Plancton a 5 €, Corail a 15 € e Nautilus a 30 €. Um pedido de 1 a 20 links pode misturar novos artigos dedicados e inserções em artigos existentes, com pacotes tier-2 opcionais de 1, 3 ou 5 links e vínculo a um projeto de visibilidade de IA.

O que acontece após o pagamento?

Uma vez o orçamento pago (crédito ou webhook Stripe, dependendo do caminho escolhido), o pedido existe exatamente como uma compra feita pelo carrinho web. Os links Plancton são então auto-atribuídos (exceto se o kill-switch interno voltar ao modo manual); os links Corail e Nautilus passam por atribuição manual no lado da equipe. Todos seguem depois o fluxo habitual até a publicação.

Há limite de pedidos por dia?

Sim, um limite anti-abuso por chave de API (cerca de vinte pedidos por dia por padrão). Acima disso, a API responde 429 com o código daily_order_cap_reached. Um reenvio com a mesma Idempotency-Key nunca consome esse limite duas vezes.

O servidor MCP exige instalação local?

Não, é um servidor remoto (Cloudflare Worker) em HTTP streamable, sem pacote npm para instalar. Ele apenas retransmite sua chave de API para a API Nautilinks, sem armazenar nada do lado dele.

Posso testar sem compromisso?

O escopo read (leitura do catálogo, pedidos, orçamentos, saldo) está incluído por padrão em cada chave, assim como o escopo order. Você também pode gerar uma chave sandbox (prefixo sn_test_): ela simula um pedido sem jamais debitar a carteira nem criar pedido real em um editor, com a resposta trazendo sandbox: true.

Como acompanhar o andamento de um pedido sem ficar consultando a API?

Criando uma assinatura de webhook (POST /api/v1/agent/webhooks) em uma URL HTTPS pública, para um ou mais eventos entre order.accepted, order.published e order.cancelled. Cada entrega é assinada em HMAC-SHA256 no cabeçalho Nautilinks-Signature, a verificar antes de confiar no conteúdo.

Uma chave de API, e seu agente compra links

Crie uma conta, gere sua chave no espaço do membro, conecte o MCP ou chame a API. O catálogo de três raios (Plancton, Corail, Nautilus) está disponível desde já.