Pełny przepływ x402

Zobacz jak działa płatność — krok po kroku

CrawlPay stoi między klientem (np. agentem AI) a chronionym API. Nieopłacone żądania dostają 402, opłacone przechodzą do originu, a płatność staje się częścią rekordu rozliczenia.

Dzisiaj

Podpisana autoryzacja x402

Każda płatność to podpisana autoryzacja x402. Platforma weryfikuje podpis, kwotę, odbiorcę, sieć, okno ważności i nonce przed odblokowaniem treści.

Wkrótce on-chain

Settlement jako transfer USDC

Ta sama podpisana autoryzacja rozliczy się jako transfer USDC on-chain. Platforma nadaje transakcję, czeka na potwierdzenie, oznacza nonce jako zużyty i zwraca hash rozliczenia.

Publiczny przepływ w 5 krokach

Wydawca chroni trasę API

Tworzy aplikację, definiuje cennik i oznacza wybrane trasy jako płatne.

Klient dostaje challenge 402

Żądanie bez płatności otrzymuje standardowy challenge x402 z ceną, aktywem, siecią i odbiorcą.

Klient podpisuje autoryzację

Portfel lub zatwierdzony provider podpisujący tworzy dowód płatności dla challenge’u.

CrawlPay weryfikuje i rozlicza

Platforma sprawdza dowód, egzekwuje ochronę przed replayem i zapisuje wynik rozliczenia.

Wydawca widzi ruch i przychód

Konsola pokazuje opłacone żądania, referencje rozliczeń, telemetrię ruchu i saldo wypłat.

// serwer MCP dla agentów AI

paypercrawl-agent-pay

Pozwala Claude Desktop i Claude Code płacić challenge x402 autonomicznie — w ramach barier, które definiujesz. Agent wywołuje narzędzia; serwer egzekwuje limity i podpisuje autoryzację EIP-712 lokalnym kluczem.

Dostępne narzędzia

pay_fetch

Wykonuje żądanie HTTP i płaci każdy challenge x402 w ramach limitów. Zwraca odpowiedź lub blocked / requiresConfirmation.

preview_price

Sprawdza cenę żądania bez płacenia. Zwraca cenę, sieć, adres payTo i czy mieści się w polityce.

get_spend_status

Pokazuje aktualne wydatki i pozostałe budżety (dziś, per domena, całkowity).

list_allowed_domains

Zwraca skonfigurowane listy allow/deny domen oraz tryb dry-run.

set_limit

Zmienia limit wydatków w locie (bez restartu).

Bariery bezpieczeństwa

Listy allow / deny domen z wildcardami (*.example.com)

Maks. cena pojedynczego żądania

Dzienny limit per domena

Globalny limit dzienny

Całkowity budżet dożywotni

Tryb dry-run (symuluje bez płacenia)

Próg ręcznego potwierdzenia — powyżej niego wymaga confirm:true

Konfiguracja w 3 krokach

Instalacja (Node ≥ 18)

Pobierz serwer MCP (.tgz)

npm install -g paypercrawl-agent-pay-0.1.0.tgz

Konfiguracja (portfel, limity, domeny)

paypercrawl-agent-pay ui
# → http://127.0.0.1:4402 · config: ~/.paypercrawl-agent-pay/config.json

Wolisz nie trzymać klucza prywatnego w pliku? Ustaw zmienną środowiskową PPC_AGENT_PRIVATE_KEY — panel pokaże wtedy tylko wyprowadzony adres portfela.

Dodanie do Claude Desktop

{
  "mcpServers": {
    "paypercrawl-agent-pay": {
      "command": "paypercrawl-agent-pay"
    }
  }
}

Dla Claude Code: dodaj ten sam wpis do .mcp.json w katalogu projektu.

Bezpieczeństwo: załaduj do portfela agenta tylko tyle USDC, ile jesteś gotów zaryzykować. Klucz prywatny nie jest nigdy logowany ani zwracany przez żadne narzędzie. Użyj dryRun: true na początku.

Ta strona opisuje publiczny przepływ płatności. Szczegóły implementacyjne udostępniamy bezpośrednio zatwierdzonym wydawcom i partnerom integracyjnym.