convez.ai
MCP ServerSegurançaIntermediário
Iron-Mark

HireProof

Iron-Mark/Hackathon-HireProof

Agente IA com prova para verificar fraudes em oportunidades de emprego

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server que detecta fraudes em oportunidades de emprego, mensagens de recrutadores e links de inscrição através de análise de evidências. Retorna um veredito (Seguro, Cuidado ou Alto Risco) com sinalizadores, fontes verificadas e próximos passos para proteger candidatos.

Instalação

$npx convez-ai Iron-Mark/Hackathon-HireProof

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
7
Forks
4
Acompanhando
0
Saúde
42%
Último commit
há 2 dias
Versão
v1.1.0
Issues abertas
0
Contribuidores
3

Casos de uso

  • Validar posts de emprego suspeitos antes de candidatar
  • Verificar mensagens de recrutadores em comunidades de carreira
  • Auditar links de inscrição e footprint de empresas

Veredito

Solução bem estruturada e focada em um problema real (fraudes em emprego). O MCP server oferece integração sólida com múltiplas superfícies (web, CLI, API), mas o repositório é hackathon e pode precisar de consolidação em produção antes de adoção em massa.

README

A tradução para o português deste README ainda está na fila.

HireProof

Employment-fraud trust and safety for suspicious job posts, recruiter messages, screenshots, and apply links.

HireProof helps a job seeker decide whether an opportunity is worth trusting before they apply or share personal data. Paste the post, message, screenshot, or URL. The agent extracts the claims, checks evidence, and returns a Safe, Caution, or High-Risk verdict with visible red flags, green flags, source receipts, and next steps.

Built as a solo global hackathon project by Mark Siazon in just over one week for Cursor Hackathon.

Production Demo Stable Release Docs Case Study Pilot Intake Built Solo GitHub LinkedIn

Open Live App Download Extension Download Integrations Install CLI

HireProof high-risk demo preview

Why It Exists

Job scams often look normal until one detail breaks trust: unrealistic pay, no interview, Telegram-only contact, weak company footprint, fake recruiter identity, or a suspicious apply path. A careful applicant has to search the company, check recent news, compare legitimate roles, inspect the apply link, and still make a judgment call.

HireProof turns that manual investigation into one evidence-backed workflow. It is intentionally focused on employment fraud and job scams. It is not presented as a generic security platform, black-box fraud model, continuous-learning system, or in-house deepfake detector.

Why People Should Care

AudienceWhat HireProof gives them
Job seekersA fast, understandable verdict before they send money, IDs, resumes, or personal data.
Career communitiesA chat-ready bot path for checking suspicious posts where people already ask for help.
BuildersA reusable verification core exposed through web, API, MCP, ChatSDK, WDK, CLI, SDK, n8n, LangChain, and extension surfaces.
Judges and reviewersA narrow, real-world safety wedge with production proof, visible evidence, and honest boundaries.
Future maintainersClear docs, proof status, packaging commands, and reproducible demo fixtures instead of a one-off event demo.

Use Or Download

ActionLink
Open the demo-safe audit UIRun HireProof
Install the CLInpx @hireproof/cli
Download the Chrome extension ZIPhireproof-extension.zip
Download native integration source packhireproof-native-integrations.zip
Import n8n HTTP workflowhireproof-n8n-workflow.json
Use Make HTTP confighireproof-make-http-config.json
Use standalone LangChain toolhireproof-langchain-tool.ts
Run curl smoke templatehireproof-automation-curl.sh

Live Links

DestinationLink
Production apphttps://hireproof.tech
Main audit flowhttps://hireproof.tech/audit
Portfolio case studyhttps://hireproof.tech/portfolio
Pilot intakehttps://hireproof.tech/pilot
Public docshttps://hireproof.tech/docs
Track proofhttps://hireproof.tech/docs/triple-track-coverage
Health checkhttps://hireproof.tech/api/health
Integration proofhttps://hireproof.tech/api/integrations/proof
Discord installhttps://discord.com/oauth2/authorize?client_id=1500240100804530336&scope=bot%20applications.commands&permissions=0
Creator portfoliohttps://www.marksiazon.dev/

At A Glance

CapabilityCurrent statusProof or notes
Web audit flowImplemented and production deployed/audit on the stable Vercel alias
Evidence-backed reportsImplementedverdict, score, red flags, green flags, evidence cards, exports
Headless APIImplementedPOST /api/v1/audit
MCP toolsImplementedPOST /api/mcp for investigation tools
ChatSDK agentsImplementedSlack screenshot proof, Telegram delivery proof, Discord credential-ready
Vercel Workflow / WDKImplementedproduction accepted-run proof, not a completed workflow transcript
CLI, SDK, n8n, LangChainImplemented and package-orientedpackage status documented in docs/automation-integrations.md
Chrome extensionStore-ready repo packageexternal Chrome Web Store publication still required
Docker self-hostingScripts and image files presentDocker runtime required for smoke verification

The Product Flow

flowchart LR
  Input[Job post, recruiter message, screenshot, or URL] --> Claims[Claim extraction]
  Claims --> Tools[Evidence tools]
  Tools --> Signals[Company, news, jobs, local footprint, apply path]
  Signals --> Policy[Evidence-weighted safety policy]
  Policy --> Report[Safe, Caution, or High-Risk report]
  Report --> Surfaces[Web, API, MCP, chat, workflow, CLI, extension]

The score is explainable by design. HireProof shows the evidence that drove the decision instead of asking the user to trust a hidden model.

Demo In 60 Seconds

  1. Open https://hireproof.tech/audit.
  2. Paste this suspicious sample:
Remote frontend intern. PHP 80,000/week. No interview. Message us on Telegram.
  1. Run the audit.
  2. Show the verdict, score, evidence cards, red flags, and next steps.
  3. Explain the same verification core also runs through API, MCP tools, ChatSDK routes, WDK workflow, CLI, SDK, n8n, LangChain, and the Chrome extension package.

For API proof:

curl -X POST https://hireproof.tech/api/v1/audit \
  -H "Content-Type: application/json" \
  -H "x-api-key: $HIREPROOF_API_KEY" \
  -d '{"text":"Remote frontend intern. PHP 80,000/week. No interview. Message us on Telegram.","mode":"demo"}'

The public audit and lab UIs default to demo-safe mode so ordinary browsing does not spend hosted provider quota. Demo mode is fixture-based and explicitly labeled. Protected API and MCP calls require an account-issued key or private self-hosted AGENT_API_KEY; live evidence mode uses provider-backed checks when credentials are configured. Hosted demos should use the public web UI. Docker and self-hosted production installs must set a private AGENT_API_KEY before using protected API or MCP surfaces.

What HireProof Checks

  • Company presence and legitimacy signals.
  • Recent news, reputation, and scam-adjacent context.
  • Comparable legitimate jobs and salary context.
  • Local business footprint where relevant.
  • Apply-path consistency between pasted text, OCR text, URLs, and known public job pages.
  • Recruiter and contact-channel signals.
  • Screenshot OCR text. Google Vision OCR runs first, with Tesseract fallback after OCR-oriented image preprocessing when configured.
  • Source quality, freshness, and evidence coverage.

Trust Model

HireProof uses a transparent evidence-weighted safety policy.

ModeWhat it means
Live evidence modeRuns the real evidence path when model, search, and optional provider credentials are configured.
Demo fixture modeShows the same report shape with seeded fixture evidence for reliable demos and offline judging. It should not be described as live evidence.
Verified-only safer alternativesSafer alternatives appear only when comparable job evidence has a real source URL or provider-backed metadata.
Screenshot privacyScreenshot-derived reports are not publicly listed by default and are excluded from public Explore and Trends. Direct report links still work.
Operational honestyMissing providers, the SerpApi circuit breaker, queue throttles, or cache fallbacks are surfaced as boundaries instead of hidden.

Proof Posture

SurfaceSafe claimBoundary
Production web appStable public alias is available at https://hireproof.tech.Recheck live URL before final submission or public launch.
API smokeDemo API path returns a structured High-Risk report with a configured API key.Live evidence depends on configured model/search credentials.
SlackScreenshot proof exists for a real HireProof reply.Endpoint-level logs should be recaptured if judges require fresh log proof.
TelegramLive delivery proof exists with screenshot/log evidence.The final report-link screenshot should be recaptured after permalink fallback changes.
DiscordCredentials, webhook readiness, install link, and slash commands exist.Do not claim live Discord proof until a real message screenshot and matching log are captured.
WDKProduction route accepted a workflow run.Do not claim completed long-running workflow transcript until callback/result proof exists.
Chrome extensionManifest V3 package workflow, assets, listing copy, and privacy notes exist.Chrome Web Store publication requires external dashboard and Google review.
DockerDockerfile, Compose, healthcheck, and smoke script exist.Docker runtime is required for local smoke proof.

Full proof notes:

HireProof proof pack preview

Hackathon Track Coverage

HireProof is one verification core exposed through multiple surfaces.

TrackImplementationWhy it matters
v0 + MCPsNext.js app, audit workspace, evidence tools, and MCP endpoint.The clearest user-facing product flow and agent tool surface.
ChatSDK AgentsShared bot reply path plus Slack, Discord, and Telegram webhook routes.Lets job-seeker communities check suspicious posts inside chat.
Vercel Workflow / WDKWorkflow package enabled with /api/workflows/audit start route.Provides the path for durable, background investigations.

Product Surfaces

SurfacePath or packageUse case
Web app/auditJob seekers paste suspicious posts and get a report.
Headless APIPOST /api/v1/auditAgents and automations request structured verdict JSON.
MCP endpointPOST /api/mcpTool-compatible clients call investigation functions.
ChatSDK/api/webhooks/slack, /api/webhooks/discord, /api/webhooks/telegramCommunities ask the bot to check suspicious posts.
WDK route/api/workflows/auditStarts asynchronous investigation work when credentials are configured.
CLI@hireproof/cliTerminal audits, JSON output, health checks, and Shield Sentinel TUI.
SDKhireproof-sdkTyped API client for JavaScript and TypeScript projects.
LangChain@hireproof/langchainStructured audit tool for LangChain pipelines.
n8nn8n-nodes-hireproofNative automation node package.
Chrome extensionextension/ and public/downloads/hireproof-extension.zipScan selected job text or supported pages from the browser.

Developer Quick Start

npm install
cp .env.example .env.local
npm run dev

Open http://localhost:3002.

Minimum useful checks:

npm run lint
npm run build
node --test test/runtime-wiring.test.mjs

The repository is consolidated on main. The current protected-branch and production hardening proof is recorded in docs/production-hardening-proof-2026-05-20.md.

Demo fixtures work without provider keys. Live evidence mode needs model/search credentials such as AI Gateway or an OpenAI-compatible provider plus SerpApi. See docs/credentials-setup.md.

Environment Groups

GroupVariables
App and APIAPP_BASE_URL, AGENT_API_KEY, SESSION_SECRET
Model routingAI_GATEWAY_API_KEY, VERCEL_AI_GATEWAY_API_KEY, HIREPROOF_MODEL, MODEL_PROVIDER_KEY
Evidence searchSERPAPI_API_KEY
Persistence and rate limitsUPSTASH_REDIS_REST_URL, UPSTASH_REDIS_REST_TOKEN, REDIS_URL, TRUST_PROXY_CLIENT_IP_HEADERS
Hosted BYOKBYOK_ENCRYPTION_KEY
SlackSLACK_BOT_TOKEN, SLACK_SIGNING_SECRET
DiscordDISCORD_BOT_TOKEN, DISCORD_PUBLIC_KEY, DISCORD_APPLICATION_ID, DISCORD_GUILD_ID
TelegramTELEGRAM_BOT_TOKEN, TELEGRAM_WEBHOOK_SECRET_TOKEN, TELEGRAM_BOT_USERNAME
Optional provider adaptersZERNIO_API_KEY, ZERNIO_WEBHOOK_SECRET
WorkflowWORKFLOW_SECRET
Cursor (optional)CURSOR_INTEGRATION_ENABLED, CURSOR_API_KEY, CURSOR_MODEL_ID, CURSOR_RUNTIME_DEFAULT, CURSOR_WEBHOOK_SECRET, CURSOR_MAX_CONCURRENT_RUNS, CURSOR_ALLOWED_REPO_URL

Cursor integration

Cursor accelerates contributor workflows (repo health, docs drift, exploratory UI QA) from /developer and secured internal cron routes. It does not participate in public audit verdicts (/api/audit, /api/v1/audit, or MCP investigation truth paths).

  1. Copy Cursor variables from .env.example into .env.local.
  2. Set CURSOR_INTEGRATION_ENABLED=true only after CURSOR_API_KEY is configured server-side.
  3. Pin cloud runs with CURSOR_ALLOWED_REPO_URL (falls back to GITHUB_REPO_URL when unset).
  4. Use Developer portal → Cursor Agents for preset runs, or call POST /api/developer/cursor/runs (session auth + same-origin CSRF).
  5. Schedule ops jobs with x-cursor-job-secret on:
    • GET /api/internal/cursor/nightly-repo-health
    • POST /api/internal/cursor/ui-qa (body: { "baseUrl": "https://your-preview.example" })
  6. Enable Cursor Bugbot in the Cursor dashboard and require its GitHub check on protected branches (see .github/workflows/cursor-integration.yml comments).

CI runs npm run lint, npm run build, and node --test test/cursor*.test.mjs without a Cursor API key.

Architecture

HireProof technical architecture

Runtime shape:

  • Web UI streams audit progress through /api/audit.
  • External agents call /api/v1/audit.
  • MCP-compatible clients call /api/mcp.
  • Chat platforms call /api/webhooks/* and share the same reply formatter.
  • Durable background jobs start through /api/workflows/audit.
  • Reports can be shared, exported as PNG/PDF/CSV, or delivered through webhook callbacks.

Core stack:

LayerTechnology
FrameworkNext.js 16 App Router, React 19, TypeScript 6
UITailwind CSS 4, custom HireProof tokens, Framer Motion, lucide-react
AIVercel AI SDK, AI Gateway, OpenAI-compatible fallback
EvidenceSerpApi, OCR path, domain/apply-path checks, provider fallbacks
StorageUpstash Redis when configured, local JSON fallback for development
IntegrationsREST, SSE, MCP, ChatSDK adapters, Vercel Workflow / WDK
Packagingnpm workspaces, Chrome Manifest V3, Docker standalone image

CLI Proof

npx @hireproof/cli --help
npx @hireproof/cli tui
npx @hireproof/cli audit --text "Remote frontend intern. PHP 80,000/week. No interview. Telegram only." --mode demo

Local CLI:

npm run cli -- --help
npm run cli -- tui
npm run cli -- audit --text "Remote frontend intern. PHP 80,000/week. No interview. Telegram only." --mode demo

Packaging

Chrome extension:

npm run package:extension
npm run store:assets

Automation integrations:

pnpm integrations:build
pnpm integrations:test
pnpm integrations:package

Docker:

export AGENT_API_KEY="$(node -e "console.log(require('crypto').randomBytes(32).toString('hex'))")"
npm run docker:build
npm run docker:run
npm run docker:smoke

Docker smoke requires a working Docker runtime. docker:run reads AGENT_API_KEY from your shell and enables REQUIRE_BYOK_FOR_LIVE_API=true so shared placeholder keys cannot spend platform live provider credentials.

Verification

Recommended local gates:

npm run lint
npm run build
npm run audit:security
npm run test:security
node --test test/runtime-wiring.test.mjs
node --test test/byok-credentials.test.mjs
npm run package:extension
npm run store:assets
pnpm integrations:build
pnpm integrations:test
pnpm integrations:package

Production smoke checks:

$base='https://hireproof.tech'
Invoke-RestMethod -Uri "$base/api/health"
Invoke-RestMethod -Uri "$base/api/integrations/proof"
Invoke-RestMethod -Uri "$base/api/v1/audit" `
  -Method Post `
  -ContentType 'application/json' `
  -Headers @{'x-api-key'=$env:HIREPROOF_API_KEY} `
  -Body (@{
    text='Remote frontend intern. PHP 80,000/week. No interview. Message us on Telegram.'
    mode='demo'
  } | ConvertTo-Json)

Project Map

app/
+-- audit/                         Web audit flow and report pages
+-- api/audit/                     SSE audit endpoint
+-- api/v1/audit/                  Headless JSON audit endpoint
+-- api/mcp/                       MCP tool endpoint
+-- api/chat/hireproof/            ChatSDK status and reply endpoint
+-- api/webhooks/                  Slack, Discord, Telegram adapters
+-- api/workflows/audit/           WDK workflow start route
+-- developer/                     Developer portal
`-- docs/                          In-app documentation portal

components/
+-- audit/                         Audit form, result screen, charts, voice input
+-- brand/                         Brand mark and verified badge
+-- docs/                          API playground and docs components
+-- layout/                        Header, footer, command menu
+-- marketing/                     Landing-page components
+-- system/                        Theme, toast, error, confetti utilities
`-- ui/                            Shared primitive UI components

lib/
+-- schemas.ts                     Shared Zod contracts
+-- risk-scorer.ts                 Evidence-weighted risk policy
+-- serpapi.ts                     Search provider integration
+-- mcp-tools.ts                   MCP investigation tools
+-- db.ts                          Hybrid persistence
+-- auth-store.ts                  Auth, API keys, BYOK credentials
`-- generate-pdf.ts                PDF dossier and certificate output

extension/
+-- manifest.json
+-- popup.html / popup.js / styles.css
+-- content.js / content.css
+-- background.js
`-- icons/

scripts/
+-- package-extension.mjs
+-- package-integrations.mjs
+-- validate-integrations.mjs
+-- generate-extension-icons.mjs
+-- generate-chrome-store-assets.mjs
`-- smoke-docker.mjs

Documentation

Creator

HireProof was designed, built, documented, packaged, and polished as a solo global hackathon project by Mark Siazon.

License

ISC

Ver o original no GitHub

Bom para

Relacionados