Für Entwickler, Agenturen und Audit-Tools

Agent Readiness.
Ein API-Aufruf.

Integrieren Sie Website-Checks in Ihre eigenen Tools. Unsere kostenlose Agent Readiness API liefert einen nachvollziehbaren Score, einzelne Befunde und konkrete Empfehlungen als JSON.

Kostenloses Konto & API-Key erstellen Dokumentation lesen ↓

Bearer-Authentifizierung · JSONKeine KreditkarteREST · JSON · Bearer auth

60 Scans pro Konto und Stunde. Mehr Bedarf? Barnabas kontaktieren.

POST /api/scan

URL → AgentReady → JSON

curl --max-time 60 https://adaptmypage.com/api/scan \
  -H "Authorization: Bearer $AGENT_READY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","profile":"website"}'

Ein Bearer-Key für Ihre serverseitige Integration. Nicht in Frontend-Code oder öffentliche Repositories einfügen.

Ihren ersten Scan starten

Kostenloses Konto erstellen und unter Konto → API Keys einen Schlüssel erstellen.
Diesen Schlüssel auf Ihrem Server speichern.
Mit Authorization-Header und einer öffentlichen URL an POST /api/scan senden.

Feld	Bedeutung
`url`	Erforderlich. Öffentliche HTTP(S)-URL, maximal 2.048 Zeichen, keine Zugangsdaten, Query-Parameter oder Fragmente.
`profile`	Optional. Standard: `auto`. `website`, `merchant`, `api`, `marketplace`, `mcp-server`, `agent-service`.

JavaScript / Node.js

const response = await fetch(
  "https://adaptmypage.com/api/scan",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.AGENT_READY_API_KEY}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      url: "https://example.com",
      profile: "website"
    }),
    signal: AbortSignal.timeout(60000)
  }
);
const report = await response.json();
if (!response.ok) throw new Error(report.error.message);
console.log(report.score, report.findings);

Was prüft die Agent Readiness API?

Der Open-Source-Scanner AgentReady prüft öffentliche Discovery-, Richtlinien-, Daten- und Sicherheitssignale. Je nach Profil kommen API-, Commerce-, MCP-Server- oder Agent-Service-Prüfungen hinzu.

AI Discovery: robots.txt, Sitemaps, llms.txt und strukturierte Daten.
Zugriff & Vertrauen: Agentenrichtlinien, Supportinformationen und Sicherheitsindikatoren.
Integration: maschinenlesbare Schnittstellen und profilabhängige Befunde.

Passiver Alpha-Scan, kein Zertifikat: Wir führen kein JavaScript, keine Käufe und keine vollständigen Agentenaufgaben aus. MCP-Server-Erkennung ist nicht dasselbe wie Browser-WebMCP. llms.txt ist eine vorgeschlagene Konvention, kein garantierter Rankingfaktor.

Befunde statt einer Blackbox

Die Antwort enthält score (0–100), gewichtete scores je Kategorie, findings mit Status, Belegen und Empfehlungen sowie Scan-Metadaten. Die englischen Originalbefunde und Gewichte von AgentReady bleiben unverändert.

{
  "agentreadyVersion": "0.1.0-alpha.0",
  "profile": "website",
  "score": 48,
  "scores": [
    {
      "key": "discoverability",
      "label": "Discoverability",
      "score": 18,
      "weight": 35,
      "applicableFindings": 6
    }
  ],
  "findings": [
    {
      "id": "discoverability.robots_txt",
      "title": "robots.txt is available",
      "status": "warn",
      "severity": "minor",
      "category": "discoverability",
      "evidence": [
        {
          "message": "/robots.txt not available (HTTP 404)."
        }
      ],
      "recommendation": "Publish robots.txt so automated clients can understand crawl preferences."
    }
  ]
}

Gekürztes Beispiel, kein Live-Ergebnis. Kategoriescores sind Punkte relativ zum jeweiligen weight, nicht alle Prozentwerte.

pass · fail · warn · unknown · info · not_applicable

Unbekannt bedeutet nicht fehlgeschlagen. Ein hoher Score belegt keine erfolgreiche Agenteninteraktion.

Klare Grenzen

Für jeden Scan ist ein Bearer-API-Key erforderlich.
Kostenlose Konten haben 60 Scans pro Stunde. Die Antwort enthält RateLimit-*-Header.
Beim Limit liefert die API 429 rate_limit_exceeded und verweist für höhere Limits auf barnabas@adaptmypage.com.
Öffentliche HTTP(S)-URLs, maximal 2.048 Zeichen, keine Zugangsdaten, Parameter oder Fragmente.
Passive Prüfung: kein JavaScript, keine Formulare, kein Login und keine Agentenaktion.

Nur Websites prüfen, für die Sie eine Berechtigung haben. Bei Fehlern die Antwort und die HTTP-Statuscodes beachten.

Häufige Fragen

Ist das eine AI-SEO- oder LLMO-API?

Sie liefert technische Signale für AI Discovery und Agent Readiness, die Sie in SEO- oder LLMO-Audits verwenden können. Sie misst keine Platzierungen, Zitate oder Sichtbarkeit in ChatGPT.

Macht die API meine Website automatisch agentenbereit?

Nein. Die API prüft und berichtet. Implementierung und das experimentelle Agent-Tag-Pilotprojekt sind getrennt.

Werden meine Scan-Reports gespeichert?

Reports werden für die Antwort im Speicher verarbeitet, nicht als Report-Archiv gespeichert. Konten, Schlüssel-Hashes und Nutzungszähler werden gespeichert. Technische Provider-Logs können weiterhin anfallen.

Kann ich die API in n8n oder einem Agenten nutzen?

Ja. Nutzen Sie einen HTTP-Request-Schritt mit POST, JSON-Body und Bearer-Authentifizierung. Speichern Sie den Schlüssel im Credential-Store des Tools, nicht im Prompt. Unser Leitfaden zur Audit-Automatisierung (auf Englisch) zeigt Beispiele für ein Batch-Skript, einen n8n-Zeitplan und einen GitHub-Actions-Check.

Den nächsten Audit automatisieren.

Konto erstellen, Key konfigurieren, URL prüfen, JSON erhalten.

Kostenloses Konto & API-Key erstellen

Agent Readiness.Ein API-Aufruf.