aijobsboom-x402

x402-geschützte Daten-API für das aijobsboom.com Facharbeiter-Jobportal, plus einen MCP-Server-Wrapper, der Anrufe im Namen eines Agenten bezahlt.

Live-API: https://aijobsboom-x402.sonofgus.workers.dev

Was das ist

Rollup-Statistiken aus der aijobsboom-Pipeline – Zählungen, keine Auflistungen. Jeder Pipeline-Lauf fügt eine Zeile hinzu: Gesamtzahl der abgerufenen Zeilen, pro Bereinigungsregel entfernte Zeilen, Zählungen pro Gewerk (Elektriker, HVAC, Leitungsmonteur, Schweißer, Mechaniker, CDL) und Zählungen der Vorteils-Flags (fair-chance, will-train, per diem, day-1 benefits, sign-on bonus, travel paid, employer-posted six-figure, HOT count, North Dakota, Montana). In diesem Datensatz werden an keiner Stelle Berufsbezeichnungen, Arbeitgebernamen, Stellen-URLs oder Beschreibungen bereitgestellt – siehe methodology.md für die Gründe.

Related MCP server: GoldBean

Endpunkte

Die Zahlung wird über x402 durchgesetzt – keine Konten, API-Schlüssel oder Abonnements erforderlich.

MCP-Server

mcp-server.js kapselt die API als zwei MCP-Tools, get_snapshot und get_series. Es hält eine eigene Base-Wallet (mit USDC finanziert) und bezahlt jeden geschützten Aufruf selbst über x402-fetch, sodass der aufrufende Agent einfach ein Tool aufruft und JSON zurückerhält.

npm install
AIJOBSBOOM_API_BASE=https://aijobsboom-x402.sonofgus.workers.dev \
X402_CLIENT_PRIVATE_KEY=0x... \
npm run mcp

X402_CLIENT_PRIVATE_KEY ist der mit 0x präfixierte private Schlüssel einer mit USDC finanzierten Base-Wallet – niemals einchecken.

Worker-Bereitstellung

npm install
wrangler secret put X402_WALLET      # the Base address that receives USDC
wrangler secret put FACILITATOR_URL  # optional, overrides the default facilitator
npm run deploy

Datenaktualisierungen: Nach jedem pipeline.py-Lauf im übergeordneten Repository kopieren Sie die frische archive/stats.csv über data/stats.csv, führen npm run teaser aus, um teaser.html zu aktualisieren, und stellen dann erneut bereit. Die CSV wird zur Build-Zeit in den Worker eingebunden – es gibt keinen Datenabruf zur Laufzeit.

Dokumentation

Vollständiges Spaltenwörterbuch, Beschreibung der Bereinigungsregeln und ToS-Einschränkungen: methodology.md.