aijobsboom-x402

x402-ограниченный API данных для доски вакансий квалифицированных рабочих aijobsboom.com, а также обёртка MCP-сервера, которая оплачивает вызовы от имени агента.

Рабочий API: https://aijobsboom-x402.sonofgus.workers.dev

Что это такое

Сводная статистика из конвейера aijobsboom — счётчики, а не объявления. Каждый запуск конвейера добавляет одну строку: общее количество извлечённых строк, количество строк, удалённых по каждому правилу очистки, счётчики по профессиям (electrician, HVAC, lineman, welder, mechanic, CDL) и счётчики по флагам льгот (fair-chance, will-train, per diem, day-1 benefits, sign-on bonus, travel paid, employer-posted six-figure, HOT count, North Dakota, Montana). Никакие названия вакансий, имена работодателей, URL-адреса объявлений или описания не предоставляются в этом наборе данных — см. methodology.md о причинах.

Related MCP server: GoldBean

Эндпоинты

Оплата обеспечивается через x402 — не требуются аккаунты, API-ключи или подписки.

MCP-сервер

mcp-server.js оборачивает API в два MCP-инструмента: get_snapshot и get_series. Он хранит собственный кошелёк Base (пополненный USDC) и сам оплачивает каждый ограниченный вызов через x402-fetch, так что вызывающий агент просто вызывает инструмент и получает JSON в ответ.

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

X402_CLIENT_PRIVATE_KEY — это приватный ключ с префиксом 0x от кошелька Base, пополненного USDC — никогда не коммитьте его.

Развёртывание Worker

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

Обновление данных: после каждого запуска pipeline.py в родительском репозитории скопируйте свежий archive/stats.csv поверх data/stats.csv, выполните npm run teaser для обновления teaser.html, затем переразверните. CSV включается в Worker на этапе сборки — во время выполнения данные не загружаются.

Документация

Полный словарь колонок, описание правил очистки и ограничения ToS: methodology.md.