Nautilinks Backlinks
Pesquise, compare, ordene e acompanhe posicionamentos de backlinks franceses por meio de um servidor MCP remoto.
Documentação
Início · API e agentes de IA
API REST + 11 ferramentas MCP
Compre backlinks a partir de um agente de IA, ou via API
O catálogo Nautilinks é acessível por API REST e por servidor MCP. Um agente pode escolher seus formatos, aplicar seus descontos, usar o crédito pré-pago e então enviar um link Stripe apenas para o eventual saldo restante.
Criar minha conta Ver a referência da API
✓ 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 a seguir
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 do 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.
A Nautilinks vende backlinks diretamente, sem marketplace nem comissão, em uma rede de sites que editamos nós mesmos. Esta página descreve o acesso de 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. Inscrição gratuita, nenhum cartão bancário solicitado nesta etapa. É essa conta que recebe as faturas e paga, no fim, 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 nem estado mantido no lado da Nautilinks. Cada chamada transporta sua própria chave de API.
Claude Code
claude mcp add --transport http nautilinks https://mcp.nautilinks.co/mcp \
--header "Authorization: Bearer YOUR_API_TOKEN"
claude.ai — Configurações → Conectores → Adicionar um 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 da 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 nas três faixas (Plancton, Corail, Nautilus), filtrável (inclusive por faixa via shelf) e paginada.
read
GET
/api/v1/agent/catalog/:id
Ficha completa de um site (métricas, preço, faixa, 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; o 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: todo 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 de 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, da ordem de cerca de vinte pedidos por dia. Uma vez atingido, a API responde com 429 e o código daily_order_cap_reached. Um reenvio idêntico (mesma Idempotency-Key) nunca conta duas vezes.
Descontos, crédito e depois saldo restante no 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.
De ponta a ponta
Exemplo completo, catálogo e depois pedido
1. Buscar um site no catálogo (aqui na faixa Plancton)
curl -s "https://nautilinks.co/api/v1/agent/catalog?niche=voyage&shelf=Plancton&limit=5" \
-H "Authorization: Bearer YOUR_API_TOKEN"
Resposta (abreviada)
{
"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 das três faixas (preço e critério), para que um agente descubra a oferta sem documentação externa.
2. Criar o pedido
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 então 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 o 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?
As três faixas 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 vinculação 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, conforme o 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 do lado da equipe. Todos seguem depois o circuito 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, dos pedidos, dos orçamentos, do 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 faixas (Plancton, Corail, Nautilus) está disponível desde já.