🇳🇵 MeroJob Scraper - Nepal Job Board API

LICENSE

Extract structured job listings from MeroJob.com, Nepal's leading job portal with over 340K monthly visitors. Fast, reliable, and AI-agent ready.

---

🎯 Features

✅ Official API Integration - Uses MeroJob's public API for blazing-fast, reliable extraction
✅ Rich Structured Data - Extract 15+ fields per job including salary, skills, company details
✅ Smart Filtering - Filter by keywords, location, category, job level, salary range
✅ Pagination Support - Extract up to 10,000+ jobs with automatic pagination
✅ Resume-Ready - Handles interruptions gracefully and resumes where it left off
✅ Zero Maintenance - API-based extraction means no breaking changes from HTML updates

---

📊 Output Schema

Each job listing includes:

Field	Type	Description
jobTitle	string	Job position title
company	string	Hiring company/organization name
location	string	Job location (city, district, province)
salary	object	Salary range (min, max, currency, unit)
deadline	string	Application deadline (ISO 8601)
jobLevel	string	Entry/Mid/Senior level
jobType	string	Full Time / Part Time / Contract
industry	string	Industry/sector
skills	array	Required skills
categories	array	Job categories/tags
jobUrl	string	Direct link to job posting
postedAt	string	Publication date (ISO 8601)
description	string	Full job description (HTML)
education	string	Required education level
experience	string	Experience requirement

---

🚀 Quick Start

Basic Run (Latest 100 Jobs)

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });

const run = await client.actor("YOUR_USERNAME/merojob-scraper").call({
  maxResults: 100
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Extracted ${items.length} jobs from MeroJob`);

Advanced Filtering

await client.actor("YOUR_USERNAME/merojob-scraper").call({
  keywords: "software engineer",
  location: "Kathmandu",
  jobLevel: "Mid Level",
  minSalary: 50000,
  maxResults: 500
});

---

🔧 Input Parameters

Parameter	Type	Default	Description
keywords	string	""	Search jobs by title/description keywords
location	string	""	Filter by city/district/province
category	string	""	Job category (IT, Marketing, Finance, etc.)
jobLevel	string	""	Entry Level / Mid Level / Senior Level
minSalary	number	0	Minimum salary (NPR/month)
maxSalary	number	999999999	Maximum salary (NPR/month)
maxResults	number	100	Maximum jobs to extract (1-10000)

---

💡 Use Cases

📈 Market Research

Analyze salary trends across industries and experience levels in Nepal's job market.

🤖 AI Job Matching

Feed structured data to LLMs for personalized job recommendations.

📧 Job Alerts

Build automated alerting systems for new positions matching criteria.

📊 Recruitment Analytics

Track hiring trends, skill demands, and employer activity.

---

🤖 AI Agent Integration

This actor is fully compatible with Claude, ChatGPT, and other AI agents via the Apify MCP (Model Context Protocol):

Use the Apify MCP to run actor YOUR_USERNAME/merojob-scraper with keywords "data scientist" in Kathmandu

Perfect for:

• Claude Desktop + Apify MCP integration
• ChatGPT Actions with Apify
• Custom AI workflows via API

---

📝 Example Output

{
  "jobTitle": "Senior Software Engineer",
  "company": "Tech Innovations Pvt. Ltd.",
  "location": "Kathmandu, Bagmati Province",
  "salary": {
    "minimum": 80000,
    "maximum": 120000,
    "currency": "NRs",
    "unit": "Monthly"
  },
  "deadline": "2026-09-15T18:10:00Z",
  "jobLevel": "Senior Level",
  "jobType": "Full Time",
  "industry": "Information Technology",
  "skills": ["Python", "Django", "PostgreSQL", "AWS", "Docker"],
  "categories": ["Software Development", "Backend Engineering"],
  "jobUrl": "https://merojob.com/senior-software-engineer-456",
  "postedAt": "2026-08-15T10:30:00Z",
  "education": "Bachelor in Computer Science",
  "experience": "5+ years",
  "vacancies": 2
}

---

⚙️ Technical Details

• Runtime: Python 3.11 on Apify platform
• Memory: Runs efficiently on 1024 MB
• Speed: ~100 jobs/minute via API
• Cost: ~$0.01 per 1000 jobs (typical)
• Maintenance: Zero (API-based, no HTML parsing)

---

🛠️ Development

# Clone and install
git clone https://github.com/YOUR_USERNAME/merojob-scraper
cd merojob-scraper
pip install -r requirements.txt

# Run locally
python -m src

# Deploy to Apify
apify push

---

📄 License

Apache 2.0 - Free for commercial and personal use.

---

🙋 Support

• Issues: GitHub Issues
• Apify Store: View on Apify
• Email: support@example.com

---

Compatible with Claude, ChatGPT & AI agents via Apify MCP 🤖