Was macht x402?
Suche nach neuen Diensten und sende bezahlte API-Anfragen über das x402-Zahlungsprotokoll. Verwende dieses Tool, wenn kein klares Tool zur Auswahl steht – durchsuche den Bazaar. Es kann auch genutzt werden, um einen x402-Endpunkt aufzurufen, Zahlungsanforderungen zu ermitteln, den Bazaar zu durchsuchen oder nach kostenpflichtigen Diensten zu suchen.
Funktionsweise
- Dienst suchen: Der Agent durchsucht den Bazaar nach passenden Diensten oder Endpunkten.
- Zahlungsanforderungen ermitteln: Vor der Anfrage werden die Zahlungsheader (
x402-amount,x402-currencyetc.) vom Server abgefragt. - Bezahlte Anfrage senden: Mit den ermittelten Zahlungsdaten wird die API-Anfrage inklusive Transaktion gesendet.
- Antwort verarbeiten: Erfolgreiche oder fehlgeschlagene Zahlungen werden vom Skill entsprechend weitergeleitet.
Konfiguration
- Endpunkt-URL: Muss über die Umgebungsvariable
X402_BAZAAR_URLoder im Skill selbst konfiguriert werden. - Zahlungsschlüssel: Falls erforderlich, über
X402_PRIVATE_KEYoderX402_WALLET. - Netzwerk: Standardmäßig Bitcoin Lightning Network; kann über
X402_NETWORKaufmainnetodertestnetgesetzt werden.
Beispielnutzung
# Suche nach einem Dienst für Wetterdaten
x402 search "Wettervorhersage"
# Bezahlte Anfrage an einen Endpunkt
x402 request https://api.weather.example.com/current \
--header "x402-amount: 0.01" \
--header "x402-currency: BTC"
Fehlerbehandlung
- Fehler 402 (Payment Required): Der Skill extrahiert automatisch die Zahlungsanforderungen aus dem Header
WWW-Authenticate. - Fehler 403 (Forbidden): Möglicherweise ungültiger oder abgelaufener Zahlungsschlüssel.
- Zeitüberschreitung: Bei ausbleibender Bestätigung der Transaktion wird der Vorgang nach 30 Sekunden abgebrochen.
Plattformen
Das Skill ist kompatibel mit:
- Claude Code
- Cursor
- Codex
- Andere AI-Agenten mit HTTP-Funktionalität
Weiterführende Informationen
Siehe die offizielle x402-Dokumentation für detaillierte Protokollinformationen und erweiterte Konfiguration.