Gradely MVP

Scrape remote software jobs, enrich contacts, and stage outreach in one pass.

This repo now ships a Next.js shell plus a runnable TypeScript pipeline that pulls jobs from RemoteOK and We Work Remotely, enriches a hiring contact, and stores the resulting prospect in Postgres.

Sources

2

RemoteOK JSON + WWR programming RSS

Database

1

`prospects` table in Postgres

Entry Point

npm run pipeline

Scrape, enrich, outreach stub, persist

Quick Start

$ npm install

$ npm run pipeline

Optional send mode:

$ PIPELINE_SEND_OUTREACH=true npm run pipeline

Local app shell:

$ npm run dev

Architecture

  • /scraper aggregates job postings and filters for software engineering roles.
  • /enrichment returns a hiring contact, using a deterministic stub unless a provider is wired in.
  • /outreach generates a personalized message and only sends when SMTP config and the send flag are both present.
  • /db initializes and upserts into a Postgres `prospects` table.

Notes

We Work Remotely search HTML is Cloudflare-protected in a plain server fetch, so the scaffold uses their programming RSS feed and applies software-role filtering in code.

The default run is safe: it enriches with stub contacts and marks outreach as stubbed unless explicit delivery configuration is provided.