📡 SSC Job Radar

AI-powered job scanner for Staff Selection Commission (SSC) notifications

Never miss a government job you're eligible for! SSC Job Radar scans the latest SSC.gov.in notices, uses AI to identify job postings, and tells you exactly which ones match your profile.

---

✨ Features

Feature	Description
🔍 Smart Scanning	Automatically fetches latest notices from SSC.gov.in
📄 PDF Analysis	Extracts and analyzes content from notification PDFs
🤖 AI Classification	Google Gemini AI identifies job postings vs exam schedules, results, etc.
✅ Eligibility Match	Checks if YOU qualify based on age, qualification, gender & category
💡 Recommendations	Personalized advice for each job posting
🔒 Cloud Ready	Uses residential proxy to work seamlessly on Apify cloud

---

🚀 Quick Start

1. Get Your Gemini API Key

Get a free API key at Google AI Studio

2. Configure Your Profile

Fill in your details:

• Age
• Gender
• Highest Qualification (10th / 12th / Graduate / Post-Graduate)
• Category (General / OBC / SC / ST / EWS)

3. Run the Actor

Click Start and let the AI scan for jobs you can apply to!

---

📥 Input

Parameter	Type	Required	Description
geminiApiKey	string	✅	Your Google Gemini API key
userAge	integer	✅	Your current age (18-65)
userGender	enum	✅	Male or Female
userQualification	enum	✅	10th, 12th, Graduate, Post-Graduate
userCategory	enum	✅	General, OBC, SC, ST, EWS
maxNotices	integer	❌	Max notices to scan (default: 20, max: 100)

---

📤 Output

Each result includes:

{
  "title": "Constable (GD) in CAPFs Examination 2025",
  "datePosted": "5 Dec 2025",
  "pdfUrl": "https://ssc.gov.in/api/attachment/...",
  "noticeType": "JOB_RECRUITMENT",
  "isJobPosting": true,
  "canApply": true,
  "recommendation": "You meet all eligibility criteria. Apply before the deadline!"
}

Dataset Views

• All Notices - Every notice scanned
• Job Postings Only - Filtered to actual job recruitments
• Jobs You Can Apply To - Only eligible jobs for your profile

---

🎯 Notice Types Detected

Type	Description
JOB_RECRUITMENT	New job vacancy announcement
EXAM_SCHEDULE	Exam dates and slot booking
RESULT_ANNOUNCEMENT	Exam results and cut-offs
ADMIT_CARD	Hall ticket availability
VACANCY_UPDATE	Updated vacancy count
GENERAL_NOTICE	Other announcements

---

💻 Local Development

# Clone and install
git clone <your-repo>
cd ssc-job-radar
npm install

# Create input file
echo '{"geminiApiKey": "YOUR_KEY", "userAge": 25, "userGender": "Male", "userQualification": "Graduate", "userCategory": "General"}' > storage/key_value_stores/default/INPUT.json

# Run locally
apify run

---

🛡️ How It Works

┌─────────────────┐     ┌──────────────┐     ┌─────────────────┐
│   SSC.gov.in    │────▶│  Playwright  │────▶│  PDF Parsing    │
│   Notice Board  │     │  Browser     │     │  (pdf-parse)    │
└─────────────────┘     └──────────────┘     └────────┬────────┘
                                                       │
                                                       ▼
┌─────────────────┐     ┌──────────────┐     ┌─────────────────┐
│   Your Results  │◀────│  Eligibility │◀────│   Gemini AI     │
│   (Dataset)     │     │  Check       │     │  Classification │
└─────────────────┘     └──────────────┘     └─────────────────┘

---

📝 License

MIT

---

🙋 Support

Found a bug or have a suggestion? Open an issue

---

Built with ❤️ for government job seekers in India