# jobdata-labs-mcp

MCP server that gives Claude, Cursor, VS Code and any other MCP client eight data tools: SEO audits, sitemap and RSS change monitoring, review sentiment, PDF/DOCX to Markdown, tech stack detection, ATS job postings and hiring signals.

Each tool runs a [jobdata labs Actor](https://apify.com/jobdata_labs) on your own Apify account and returns the results to the assistant. All tools use official APIs or public, robots.txt-respecting sources.

## Tools

| Tool | What it returns | Apify Actor |
|---|---|---|
| `seo_audit` | Per-page SEO issues and a 0-100 score: broken links, redirect chains, titles, meta descriptions, H1, canonical, noindex, slow pages | [seo-audit-crawler](https://apify.com/jobdata_labs/seo-audit-crawler) |
| `sitemap_changes` | URLs from XML sitemaps, or only pages added, updated and removed since the last call | [sitemap-change-monitor](https://apify.com/jobdata_labs/sitemap-change-monitor) |
| `rss_feed_items` | RSS/Atom items with keyword and date filters, or only new items | [rss-feed-monitor](https://apify.com/jobdata_labs/rss-feed-monitor) |
| `review_sentiment` | Sentiment score and label, topics, defect flags for reviews in 5 languages | [review-sentiment-analyzer](https://apify.com/jobdata_labs/review-sentiment-analyzer) |
| `document_to_markdown` | Markdown or text plus RAG-ready chunks from PDF, DOCX, TXT URLs | [ai-document-extractor](https://apify.com/jobdata_labs/ai-document-extractor) |
| `tech_stack` | Website technologies, email provider and SaaS tools from DNS | [tech-stack-dns-detector](https://apify.com/jobdata_labs/tech-stack-dns-detector) |
| `ats_jobs` | Job postings from Greenhouse, Lever, Ashby, SmartRecruiters, Workable, Recruitee, Personio, Teamtailor | [ats-jobs-monitor](https://apify.com/jobdata_labs/ats-jobs-monitor) |
| `hiring_signals` | Open roles, new roles, departments and change per company | [hiring-signals](https://apify.com/jobdata_labs/hiring-signals) |

Every tool also accepts `extraInput` (any other Actor input field) and `maxResults` (items returned to the assistant, default 50).

## Setup

1. Create a free [Apify](https://apify.com) account and copy your API token from Settings > API & Integrations.
2. Add the server to your MCP client.

Claude Desktop (`claude_desktop_config.json`), Cursor and similar clients:

```json
{
  "mcpServers": {
    "jobdata-labs": {
      "command": "npx",
      "args": ["-y", "github:jobdatalabs/jobdata-labs-mcp"],
      "env": { "APIFY_TOKEN": "<YOUR_APIFY_TOKEN>" }
    }
  }
}
```

Or from a local clone:

```bash
git clone https://github.com/jobdatalabs/jobdata-labs-mcp && cd jobdata-labs-mcp && npm install
APIFY_TOKEN=<YOUR_APIFY_TOKEN> node src/index.js
```

Docker:

```bash
docker build -t jobdata-labs-mcp . && docker run -i --rm -e APIFY_TOKEN=<YOUR_APIFY_TOKEN> jobdata-labs-mcp
```

No local install? Use the hosted Apify MCP server with the same tools:

```json
{
  "mcpServers": {
    "jobdata-labs": {
      "url": "https://mcp.apify.com?tools=jobdata_labs/seo-audit-crawler,jobdata_labs/sitemap-change-monitor,jobdata_labs/rss-feed-monitor,jobdata_labs/review-sentiment-analyzer,jobdata_labs/ai-document-extractor,jobdata_labs/tech-stack-dns-detector,jobdata_labs/ats-jobs-monitor,jobdata_labs/hiring-signals",
      "headers": { "Authorization": "Bearer <YOUR_APIFY_TOKEN>" }
    }
  }
}
```

## Pricing

The server is free and open source. Runs are billed by Apify per result at each Actor's price (for example $3 per 1,000 audited pages, $1.50 per 1,000 feed items). New Apify accounts include monthly free usage.

## Example prompts

- "Audit https://example.com for SEO issues and list the 10 worst pages."
- "Which pages were added to the sitemap of competitor.com since last week?"
- "Show remote backend jobs posted this week at Stripe, Notion and Linear."
- "Convert this PDF to Markdown chunks: https://arxiv.org/pdf/1706.03762"

## License

MIT