Startseite · API und KI-Agenten
Agent Ready

Kaufen Sie Backlinks über einen KI-Agenten oder per API

Der Nautilinks-Katalog ist auch per API und per MCP-Server zugänglich. Ein Agent (Claude, ChatGPT, Cursor…) kann eine Website suchen, eine Bestellung erstellen und sie direkt begleichen, wenn Ihr Guthaben sie deckt, oder Ihnen andernfalls einen Stripe-Zahlungslink übermitteln.

Konto erstellen API-Referenz ansehen
✓ Authentifizierung per API-Schlüssel✓ Entfernter MCP-Server✓ Keine Kartenbelastung ohne menschliche Bestätigung

Nautilinks verkauft Backlinks direkt, ohne Marketplace und ohne Provision, auf einem Netzwerk von Websites, die wir selbst betreiben. Diese Seite beschreibt den maschinellen Zugang zu genau diesem Katalog: eine REST-API und ein MCP-Server, konzipiert dafür, dass ein LLM-Agent eine passende Website suchen, eine Bestellung aufgeben und deren Fortschritt verfolgen kann, ohne dass ein Mensch ein Formular ausfüllt.

Das Prinzip bleibt dasselbe wie auf dem Rest der Website: Der per API abgefragte Katalog ist in seiner Logik öffentlich, die Preise sind dieselben wie auf der menschlichen Seite, und keine Karte wird jemals belastet, ohne dass ein Mensch die Zahlung bestätigt hat, sei es im Voraus durch das Aufladen des Guthabens, sei es im Moment durch das Öffnen eines Stripe-Links. Der Agent bestellt, der Mensch zahlt, auf die eine oder andere Weise.

Erste Schritte

Drei Schritte, um einen Agenten zu verbinden

  1. Erstellen Sie ein Nautilinks-Konto. Kostenlose Registrierung, in diesem Schritt wird keine Kreditkarte verlangt. Dieses Konto erhält die Rechnungen und zahlt letztlich über Stripe.
  2. Erzeugen Sie einen API-Schlüssel. Im Mitgliederbereich, Abschnitt „Mein Konto" dann „API-Schlüssel". Der Schlüssel (Format sn_live_...) wird nur einmal angezeigt und muss sofort kopiert werden. Bis zu 5 aktive Schlüssel pro Konto, jederzeit widerrufbar.
  3. Verbinden Sie den MCP oder rufen Sie die API auf. Zwei gleichwertige Wege: ein MCP-Client (Claude Code, claude.ai, Cursor…), der mit dem Server mcp.nautilinks.co spricht, oder direkte HTTP-Aufrufe an /api/v1/agent/*. Der JSON-Vertrag ist auf beiden Seiten identisch.
Ohne zu installierendes Paket

Den MCP-Server verbinden

Entfernter Server auf Cloudflare (streambarer HTTP-Transport), keine Sitzung und kein Zustand wird bei Nautilinks gespeichert. Jeder Aufruf transportiert Ihren eigenen API-Schlüssel.

Claude Code 
claude mcp add --transport http nautilinks https://mcp.nautilinks.co/mcp \
  --header "Authorization: Bearer YOUR_API_TOKEN"
claude.ai: Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen 
URL : https://mcp.nautilinks.co/mcp
En-tête : Authorization: Bearer YOUR_API_TOKEN
Falls der Client keinen benutzerdefinierten Header akzeptiert 
https://mcp.nautilinks.co/mcp?key=sn_live_votre_cle

Elf Tools werden bereitgestellt: Katalog und bestehende Artikel, KI-Sichtbarkeitsprojekte und -pläne, Guthaben, Bestellerstellung sowie Angebots- und Bestellverfolgung. Sie verwenden denselben Datenvertrag wie die REST-API weiter unten; Webhooks sind nur per direktem HTTP-Aufruf erreichbar.

/api/v1/agent/*

API-Referenz für Agenten

Methode
Endpunkt
Rückgabe
Scope
GET
/api/v1/agent/catalog
Listet die Websites des Netzwerks auf allen drei Preisstufen (Plancton, Corail, Nautilus) auf, filterbar (auch nach Preisstufe) und paginiert.
read
GET
/api/v1/agent/catalog/:id
Vollständiges Profil einer Website (Kennzahlen, Preis, Preisstufe, Nische).
read
GET
/api/v1/agent/catalog/:id/articles
Bestehende Artikel für eine einmalig verkaufte Einfügung, mit rankenden Keywords und Positionen.
read
GET
/api/v1/agent/balance
Verfügbares Guthaben des vorausbezahlten Kontos.
read
POST
/api/v1/agent/orders
Erstellt eine Bestellung für 1 bis 20 Links: wird sofort beglichen, wenn das Guthaben den Gesamtbetrag deckt, sonst wird ein Stripe-Zahlungslink zurückgegeben.
order
GET
/api/v1/agent/orders
Listet die mit diesem Schlüssel aufgegebenen Bestellungen auf.
read
GET
/api/v1/agent/orders/:id
Detaillierter Status pro Link (zuzuweisen, veröffentlicht…) und veröffentlichte URL, sobald online.
read
GET
/api/v1/agent/quotes/:id
Fragt ein Angebot ab, um zu erfahren, ob die Zahlung erfolgt ist und unter welcher Bestellnummer.
read
GET
/api/v1/agent/webhooks
Listet die aktiven Webhook-Abonnements des Schlüssels auf.
read
POST
/api/v1/agent/webhooks
Erstellt ein Abonnement (URL + Ereignisse), liefert ein einmalig angezeigtes Secret zurück.
order
DELETE
/api/v1/agent/webhooks/:id
Widerruft ein Webhook-Abonnement.
order
GET
/api/v1/agent/ai-visibility/projects
Listet die KI-Sichtbarkeitsprojekte des Kontos auf.
read
GET
/api/v1/agent/ai-visibility/projects/:id/plan
Erstellt prüfbare Bestellpositionen aus ungedeckten KI-Chancen.
read

Authentifizierung

Jeder Aufruf trägt den Header Authorization: Bearer sn_live_.... Der Schlüssel gehört zu einem menschlichen Konto: Jede per API erstellte Bestellung wird diesem Konto zugeordnet, an dessen Adresse abgerechnet und im Mitgliederbereich ebenso sichtbar wie eine über den Web-Warenkorb aufgegebene Bestellung. Ein frisch erstellter Schlüssel trägt standardmäßig beide Scopes (read und order).

Idempotenz der Bestellungen

Der optionale Header Idempotency-Key vermeidet Duplikate bei Netzwerk-Wiederholungen (Timeout, automatischer Retry auf Agentenseite). Ein zweiter Aufruf mit demselben Wert erzeugt keine neue Bestellung: Er liefert dasselbe Angebot zurück und, falls bereits eine Stripe-Zahlung läuft, dieselbe payment_url, statt eine zweite zu eröffnen.

Tägliches Limit

Ein Missbrauchsschutz-Limit gilt pro API-Schlüssel, in der Größenordnung von rund zwanzig Bestellungen pro Tag. Ist es erreicht, antwortet die API mit 429 und dem Code daily_order_cap_reached. Eine identische Wiederholung (derselbe Idempotency-Key) zählt niemals doppelt.

Zahlung: Guthaben oder Stripe-Link

Das Erstellen einer Bestellung belastet im Moment des Aufrufs nie eine Karte. Deckt das vorausbezahlte Guthaben des Kontos den Gesamtbetrag, wird es direkt bei der Erstellung belastet: Die Antwort trägt order_id und order_status: "paid", und payment_url ist null. Andernfalls wird nur ein Angebot erstellt, und die Antwort enthält ein Feld payment_url, einen klassischen Stripe-Checkout-Link, der vom Kontoinhaber, einem Menschen, geöffnet werden muss; nach erfolgter Zahlung wandelt ein bereits bestehender Webhook das Angebot in eine Bestellung um. In beiden Fällen wird keine Karte belastet, ohne dass eine Person die Zahlung bestätigt hat, im Voraus durch das Aufladen des Guthabens oder im Moment über Stripe, und ein Agent kann nur ausgeben, was bereits auf dem Konto liegt, innerhalb des täglichen Limits.

Webhooks

Ein Webhook-Abonnement (POST /api/v1/agent/webhooks, Scope order, bis zu 5 aktive pro Konto) empfängt order.accepted, order.published und order.cancelled auf einer öffentlichen HTTPS-URL, die der Agent wählt. Jede Zustellung ist signiert: Der Header Nautilinks-Signature trägt ein HMAC-SHA256, berechnet über den Zeitstempel und den rohen Body, mit einem vom bei der Erstellung zurückgegebenen Secret abgeleiteten Schlüssel (niemals das Secret im Klartext). GET /api/v1/agent/webhooks listet die aktiven Abonnements auf, DELETE /api/v1/agent/webhooks/:id widerruft eines.

Ende-zu-Ende

Vollständiges Beispiel: Katalog, dann Bestellung

1. Eine Website im Katalog suchen (hier auf der Preisstufe Plancton) 
curl -s "https://nautilinks.co/api/v1/agent/catalog?niche=voyage&shelf=Plancton&limit=5" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
Antwort (gekürzt) 
{
  "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"
    }
  ]
}

Die vollständige Antwort trägt auch shelves, die Beschreibung der drei Preisstufen (Preis und Kriterium), damit ein Agent das Angebot ohne externe Dokumentation entdeckt.

2. Die Bestellung erstellen 
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 '{
    "items": [
      {
        "site_id": 214,
        "target_url": "https://votre-site.fr/page-cible/",
        "anchor_text": "assurance voyage longue duree",
        "anchor_type": "partial"
      }
    ]
  }'
Antwort, wenn das Guthaben den Gesamtbetrag deckt 
{
  "ok": true,
  "quote_id": "qt_8f2c...",
  "total_eur": 5,
  "payment_url": null,
  "items_count": 1,
  "order_id": "ord_9a1d...",
  "order_status": "paid"
}
Antwort andernfalls (ein Angebot wird erstellt, ein Mensch muss zahlen) 
{
  "ok": true,
  "quote_id": "qt_8f2c...",
  "total_eur": 5,
  "payment_url": "https://checkout.stripe.com/c/pay/...",
  "items_count": 1
}

Ist payment_url gleich null, ist die Bestellung bereits durch das Guthaben beglichen: order_id und order_status beschreiben sie direkt. Andernfalls übermittelt der Agent payment_url an den Menschen; nach erfolgter Zahlung liefert GET /api/v1/agent/quotes/qt_8f2c... die resultierende order_id, und GET /api/v1/agent/orders/:id verfolgt den Link bis zu seiner Veröffentlichung.

Häufig gestellte Fragen

Kann ein KI-Agent allein zahlen, ohne menschliches Eingreifen?

Die Zahlung läuft über einen von zwei Wegen. Deckt das vorausbezahlte Guthaben des Kontos den Gesamtbetrag, wird die Bestellung sofort beglichen: Es ist das Guthaben, das ein Mensch zuvor aufgeladen hat, das zahlt, und der Aufruf schließt ab, ohne dass ein Link geöffnet werden muss. Andernfalls liefert die Bestellerstellung einen Stripe-Zahlungslink (payment_url) zurück, den ein Mensch öffnen und bezahlen muss. In beiden Fällen wird niemals eine Karte belastet, ohne dass eine Person die Zahlung bestätigt hat, und ein Agent kann nur ausgeben, was bereits auf dem Konto liegt, begrenzt durch ein tägliches Limit pro Schlüssel.

Welche Links können heute per API gekauft werden?

Alle drei Preisstufen des Katalogs: Plancton zu 5 €, Corail zu 15 € und Nautilus zu 30 €. Eine Bestellung mit 1–20 Links kann neue Artikel und einmalige Einfügungen in bestehende Artikel, optionale Tier-2-Pakete mit 1, 3 oder 5 Links sowie KI-Sichtbarkeitsprojekte mischen.

Was passiert nach der Zahlung?

Sobald das Angebot bezahlt ist (per Guthaben oder per Stripe-Webhook, je nach eingeschlagenem Weg), existiert die Bestellung genau wie ein Kauf über den Web-Warenkorb. Die Plancton-Links werden anschließend automatisch zugewiesen (außer der interne Kill-Switch schaltet auf manuellen Modus um); die Corail- und Nautilus-Links durchlaufen eine manuelle Zuweisung durch unser Team. Alle folgen anschließend dem üblichen Ablauf bis zur Veröffentlichung.

Gibt es ein Limit für Bestellungen pro Tag?

Ja, ein Missbrauchsschutz-Limit pro API-Schlüssel (standardmäßig rund zwanzig Bestellungen pro Tag). Darüber hinaus antwortet die API mit 429 und dem Code daily_order_cap_reached. Eine Wiederholung mit demselben Idempotency-Key verbraucht dieses Kontingent nie zweimal.

Erfordert der MCP-Server eine lokale Installation?

Nein, es handelt sich um einen entfernten Server (Cloudflare Worker) mit streambarem HTTP-Transport, ohne zu installierendes npm-Paket. Er leitet lediglich Ihren API-Schlüssel an die Nautilinks-API weiter, ohne selbst etwas zu speichern.

Kann ich unverbindlich testen?

Der Scope read (Lesen von Katalog, Bestellungen, Angeboten, Guthaben) ist standardmäßig in jedem Schlüssel enthalten, ebenso wie der Scope order. Sie können außerdem einen Sandbox-Schlüssel erzeugen (Präfix sn_test_): Er simuliert eine Bestellung, ohne jemals das Guthaben zu belasten oder eine echte Bestellung bei einem Herausgeber anzulegen, die Antwort trägt dann sandbox: true.

Wie verfolge ich den Fortschritt einer Bestellung, ohne die API abzufragen?

Indem Sie ein Webhook-Abonnement anlegen (POST /api/v1/agent/webhooks) auf einer öffentlichen HTTPS-URL, für ein oder mehrere Ereignisse aus order.accepted, order.published und order.cancelled. Jede Zustellung ist signiert, im Header Nautilinks-Signature mit HMAC-SHA256, zu prüfen, bevor dem Inhalt vertraut wird.

Ein API-Schlüssel, und Ihr Agent bereitet den Linkkauf vor

Erstellen Sie ein Konto, erzeugen Sie Ihren Schlüssel im Mitgliederbereich, verbinden Sie den MCP oder rufen Sie die API auf. Der Katalog mit drei Preisstufen (Plancton, Corail, Nautilus) ist ab heute verfügbar.

Konto erstellen Gesamten Katalog ansehen