mailcheck
Val Town is a collaborative website to build and scale JavaScript apps.
Deploy APIs, crons, & store data – all from the browser, and deployed in milliseconds.
Viewing readonly version of main branch: v104View latest version
Verify that email addresses belong to real people using lightweight web + LLM signals. Upload/paste lists, run concurrent checks, and export annotated results.
What it does
- Upload CSV/JSON or paste text; inline edit and delete rows
- Jobs sidebar with autosave (localStorage)
- Per‑email verification with concurrency and live row updates
- Syntax check (invalid → spam)
- Academic domain detection (institution annotation)
- Role/alias heuristic (flags generic addresses)
- Web + LLM assessments consolidated by a final judge into one decision
- Export CSV/JSON (preserves original columns +
bg_*
fields)
Statuses
- person_high
- person_low
- person_none
- spam
Requirements
- Deno 1.40+
- Groq API key
Run locally
deno run -A main.js
Open http://localhost:8000. If the server doesn’t have GROQ_API_KEY
, set a key in the UI.
Environment
GROQ_API_KEY
: Groq key (server). The UI also supports a per‑user key.
API
- POST
/api/check/background
- body:
{ email: string, systemPrompt?: string, userApiKey?: string }
- returns:
{ email, status, message, fields }
- body:
Notes
- Focuses on real‑person verification, not SMTP deliverability.
- The UI is a thin client over the API—use the endpoint directly if preferred.
Powered by Groq — get a key at https://groq.com.