LinkedIn Scraper MCP

A remote MCP server for job scraping. Runs on Cloudflare Workers, uses Apify for scraping.

Quick Start

git clone https://github.com/BlockchainHB/linkedin-scraper-mcp.git
cd linkedin-scraper-mcp
npm install

Add your Apify API key to wrangler.jsonc:

{
  "vars": {
    "APIFY_API_KEY": "your_key_here"
  }
}

Tools

Tool	Description
scrape_linkedin_jobs	Search LinkedIn for job listings
scrape_indeed_jobs	Search Indeed for job listings

Development

npm run dev     # Local server at localhost:8787
npm run deploy  # Deploy to Cloudflare Workers

Claude Code Integration

This repo includes native Claude Code support with skills and slash commands.

Slash Commands

Command	Description
/install	Interactive setup wizard for Claude Desktop or Cursor
/search-jobs <title> [location]	Quick job search
/deploy	Deploy to Cloudflare with config generation

Auto-Discovery Skill

The included skill (.claude/skills/job-scraper/) enables Claude to automatically use job scraping when you ask about jobs, hiring trends, or job market data.

Connect to Claude Desktop

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "job-scraper": {
      "command": "npx",
      "args": ["mcp-remote", "https://your-worker.workers.dev/sse"]
    }
  }
}

Connect to Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "job-scraper": {
      "command": "npx",
      "args": ["mcp-remote", "https://your-worker.workers.dev/sse"]
    }
  }
}

Usage Examples

Once connected:

• "Find remote senior React developer jobs"
• "Search for data science positions in Austin"
• "What entry-level marketing roles are at Google?"

LinkedIn Parameters

Parameter	Required	Description
jobTitle	Yes	Job title to search
location	No	Location or "Remote"
maxResults	No	1-100 (default: 10)
experienceLevel	No	Internship, Entry level, Associate, Mid-Senior level, Director, Executive
jobType	No	Full-time, Part-time, Contract, etc.
companyName	No	Array of company names

Indeed Parameters

Parameter	Required	Description
position	Yes	Job position to search
country	No	Country code (default: US)
location	No	City or region
maxItems	No	1-100 (default: 50)
parseCompanyDetails	No	Include company info (slower)

Author

@hasaamb

License

MIT