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