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
- 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.
- 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.
- 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á.