Agent How-to

Wie Agents RGate nutzen.

RGate ist ein Release Gate as a Service für Dev, Ops und Agents. Diese Anleitung zeigt, wie ein Agent RGate entdeckt, installiert, aufruft und Ergebnisse an Menschen oder Coding-Workflows übergibt.

Installiere den RGate Release Readiness Skill.

Für skill-fähige Agenten ist das der schnellste Weg, RGate als externes Release Gate für öffentliche Websites, Web Apps und API-nahe Oberflächen zu nutzen.

npx skills add marcoldenburg/rgate-release-readiness-skill

Repository: marcoldenburg/rgate-release-readiness-skill

1. RGate entdecken

Agents sollten mit den Markdown- und maschinenlesbaren Discovery-Dateien starten, bevor sie Tools aufrufen. Diese Dateien erklären, was RGate macht, wann es genutzt wird, welche Pricing-Grenzen gelten und welche API-Oberflächen verfügbar sind. Für Brand-Lookups: /de/developer-resources.

Human page

Scan im Browser starten und Report an den User zurückgeben.

/de

Developer Resources

Kanonische RGate-Ressourcen für API Docs, MCP, CLI, Auth und Agent Handoff.

/de/developer-resources

REST API

Scans starten, Ergebnisse pollen, Fix-Pläne generieren, Markdown exportieren und Historie vergleichen.

/api/scan

OpenAPI

Maschinenlesbarer API-Vertrag für Function Calling und generierte Clients.

/openapi.json

MCP Server

Native Tool-Oberfläche für Claude, Coding Agents und MCP-Clients.

/api/mcp

MCP Manifest

Discovery-Datei für Transport, Tools, Server-Identität und Branding.

/.well-known/mcp.json

Agent Guide

Markdown-Anweisungen für autonome Agents.

/agents.md

LLM Context

Vollständiger Produktkontext für Agents, die eine Markdown-Quelle ingestieren.

/llms-full.txt

CLI

Command-Line-Nutzung für Agents, CI und Release-Skripte.

/cli.md

Pricing

Maschinenlesbare Preise und Limits.

/pricing.md

2. Agent Skill und CLI installieren

Nutze den RGate Skill in skill-fähigen Agent-Umgebungen. Nutze die CLI, wenn ein Agent, CI-Job oder Release-Skript RGate braucht, ohne die REST API direkt zu implementieren.

npx skills add marcoldenburg/rgate-release-readiness-skill

npm install -g @rgate_io/rgate

npx @rgate_io/rgate scan https://www.rgate.io --wait --json
rgate get <scanId>
rgate fix-plan <scanId> --format markdown
rgate export <scanId> --template cursor

Skill: marcoldenburg/rgate-release-readiness-skill. Package: @rgate_io/rgate. Binary: rgate. Docs: /cli.md.

3. REST API nutzen

Öffentliche Scans brauchen keine Authentifizierung. Agents starten einen Scan, pollen bis zum Abschluss und rufen danach die Formate ab, die User oder Coding-Umgebung brauchen.

curl -X POST https://www.rgate.io/api/scan \
  -H 'content-type: application/json' \
  --data '{"url":"https://www.rgate.io"}'

curl https://www.rgate.io/api/scan/{scanId}
curl -X POST https://www.rgate.io/api/scan/{scanId}/fix-plan
curl https://www.rgate.io/api/scan/{scanId}/export.md?template=cursor
curl https://www.rgate.io/api/scans/{scanId}/diff?against={previousScanId}

4. MCP Tools nutzen

MCP-Clients können sich mit dem Streamable-HTTP-Endpunkt verbinden und denselben Workflow als Tools aufrufen. Zahlungsfreigaben bleiben ein Handoff an Menschen; Agents sollen Checkout nicht autonom abschließen.

start_scan

Start an RGate website quality scan for a public URL across security, SEO, accessibility, legal compliance, and sustainability.

get_scan

Fetch scan status and, once complete, structured findings, check results, and technology detections.

list_checks

Describe the RGate scan layers and check catalog for agent planning and user explanations.

get_pricing

Return machine-readable RGate plan names, prices, scan limits, and best-fit use cases.

create_checkout_handoff

Create a human handoff URL for purchasing a full report or subscription after a scan is complete.

generate_fix_plan

Generate a prioritized release-readiness fix plan from scan findings. Returns blockers first, then high-impact follow-ups and backlog items.

export_scan_markdown

Export scan results as Markdown for Cursor prompts, GitHub issues, or executive summaries.

compare_scan_history

Compare two scans for the same domain and return added, resolved, improved, and worsened findings.

5. Empfohlener Agent Loop

Bestätigen, dass der User die öffentliche Website oder API-nahe Oberfläche scannen darf.
Aktuelle Constraints in /agents.md oder /llms-full.txt lesen.
Scan mit REST, MCP oder CLI starten.
Pollen, bis der Scan done oder failed ist.
Blocker zuerst zusammenfassen: Security, Compliance, Accessibility, SEO und Sustainability.
Fix-Plan generieren und Markdown für Cursor, GitHub Issues oder Release-Checkliste exportieren.
Agent Handoff nur für Checkout- oder Report-Zugriff vorbereiten; Mensch muss Zahlung und Entscheidungen freigeben.