career-ops-scanner

AI-powered job intelligence that runs itself. Built for Waleed Ballag — ESL Instructor, Academic Supervisor (15 theses), Arabic↔English Translator (Legal/Academic) from Libya. Finds worldwide remote roles across 30+ sources, scores with 4-bucket + AI 5-dimension evaluation, and delivers via Telegram + Email + Excel + Live Dashboard + REST API.

For anyone: Fork, set 4 secrets, and get 3× daily scans forever — no servers to manage.

🏗️ Architecture

See ARCHITECTURE.md for deep dive, data flow, and scoring formulas.

🚦 Quick Start

1) GitHub Actions (zero servers)

• Fork this repo
• Settings → Secrets and variables → Actions → New repository secret:

• Actions → CareerOps Job Scan → Run workflow (manual trigger) — watch it scan 5k+ jobs

⚙️ Configuration (config.py)

All tuning via env (see .env.example):

Fetcher tiers: Tier 1 (Greenhouse 34, Lever, Remotive, RemoteOK, WWR, Jobicy API, Arbeitnow, Himalayas API) always on; Tier 2 (+ Nodesk, YayRemote etc); Tier 3 (+ MENA/freelance). Controlled by CAREEROPS_TIER_CAP.