Naukri MCP Server

An MCP-based Naukri job search assistant that scrapes recent job postings, processes them, tracks previously seen jobs, and exports new opportunities to Excel with direct Naukri application links.

Features

• Naukri job scraping

• Multiple roles

• Multiple locations

• Freshness filtering

• Experience filtering

• Duplicate detection

• Previously seen job tracking

• Application status tracking

• Match score

• Priority

• Excel export

• Direct Naukri application links

• Claude Desktop MCP integration

Related MCP server: trackly-cli

Requirements

• Windows / macOS / Linux

• Python 3.10+

• Git

• uv

• Playwright

• Chromium

• Claude Desktop

Installation

1. Clone

git clone https://github.com/pcsuper50/Naukri-mcp-server.git

cd Naukri-mcp-server

2. Install dependencies

uv venv

uv pip install -r requirements.txt

3. Install Playwright browser

uv run playwright install chromium

4. Create configuration

Copy:

config.example.py

to:

config.py

Update your:

• name

• experience

• skills

• target roles

• preferred locations

• excluded roles

Test the scraper

uv run python scraper.py --roles "GenAI Engineer" --locations Pune --days 3 --max-pages 1

If the scraper is working you should see:

CARDS|20

and matched jobs.

Full search

uv run python scraper.py --roles "GenAI Engineer" "AI ML Engineer" "LLM Engineer" "Machine Learning Engineer" "RAG Engineer" "Production Support" "L2 Support" "Application Support" --locations "Pune" "Bangalore" "Hyderabad" "Noida" "Gurgaon" "Remote" "Indore" "Ahmadabad" --days 3 --max-pages 5 --min-exp 1 --max-exp 6

Claude Desktop Setup

Open the Claude Desktop configuration file.

Use content:

claude_desktop_config.example.json

as the template.

Replace:

C:\PATH\TO\Naukri-mcp-server

with your actual project path.

Save the configuration and restart Claude Desktop.

Daily Workflow

Step 1

Run the scraper from VS Code[Fill your experience and role accordingly]:

uv run python scraper.py --roles "GenAI Engineer" "AI ML Engineer" "LLM Engineer" "Machine Learning Engineer" "RAG Engineer" "Production Support" "L2 Support" "Application Support" --locations "Pune" "Bangalore" "Hyderabad" "Noida" "Gurgaon" "Remote" "Indore" "Ahmadabad" --days 3 --max-pages 5 --min-exp 1 --max-exp 6

Wait until scraping completes.

Step 2

Open:

CLAUDE_PROMPT.md

Copy the prompt into Claude Desktop.

Claude will:

1. Process jobs

2. Calculate statistics

3. Export new jobs to Excel

4. Retrieve new jobs

5. Display direct application links

Output

Generated files are stored locally inside:

naukri/

Examples:

naukri_latest_jobs.xlsx processed_jobs.json

These files are intentionally excluded from Git.

Troubleshooting

No jobs found

Run a smaller test:

uv run python scraper.py --roles "GenAI Engineer" --locations Pune --days 3 --max-pages 1

Claude cannot connect

Check:

1. uv is installed

2. project path is correct

3. Claude Desktop config is valid

4. Claude Desktop was restarted

5. Chromium was installed

License

MIT