English Français العربية

io.github.pcmarts/recruiter-roles-mcp

السجل الرسمي البحث والويب

Search Recruiter Roles: live recruiter jobs, companies, sectors, locations, and market stats.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http recruiter-roles-mcp 'https://recruiterroles.com/api/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "recruiter-roles-mcp": {
            "type": "http",
            "url": "https://recruiterroles.com/api/mcp"
        }
    }
}
NPM package recruiter-roles-mcp
Claude Code 
claude mcp add recruiter-roles-mcp -e 'RECRUITER_ROLES_API_KEY=<your recruiter_roles_api_key>' -- npx -y recruiter-roles-mcp@1.0.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "recruiter-roles-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "recruiter-roles-mcp@1.0.0"
            ],
            "env": {
                "RECRUITER_ROLES_API_KEY": "<your recruiter_roles_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • RECRUITER_ROLES_API_KEY إلزامي سري Your Recruiter Roles API key (rr_live_...). Get one free at https://recruiterroles.com/api-access

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Recruiter Roles MCP server
  2. Tools
  3. Connect
  4. How it works
  5. Develop
  6. Backlink policy
  7. License

Recruiter Roles MCP server

Query the Recruiter Roles job board from any MCP-capable AI client (Claude, Cursor, ChatGPT, VS Code, …). Ask in plain language and get live recruiter and talent-acquisition jobs, company profiles, sectors, locations, and market stats — straight from the board.

Read-only. Authenticated with a free Recruiter Roles API key.

Tools

ToolDescription
search_jobsSearch & filter live jobs (sector, location, salary, remote, recency, full-text).
get_jobFull detail for one job — description, requirements, benefits, apply contact.
list_companiesBrowse recruiting agencies & employers with active job counts.
get_companyA company profile plus its active jobs.
list_sectorsAll recruiting sectors with live job counts.
list_locationsCountries, regions, and cities with live job counts.
market_statsAggregate market overview — totals, posting velocity, and breakdowns.

All tools are annotated readOnlyHint: true, destructiveHint: false, openWorldHint: false, and expose an outputSchema.

Connect

Most clients can connect directly to the hosted Streamable HTTP endpoint with your API key in the Authorization header (or as a ?key= query param for clients that can't set headers).

Cursor — ~/.cursor/mcp.json:

{
  "mcpServers": {
    "recruiter-roles": {
      "url": "https://recruiterroles.com/api/mcp",
      "headers": { "Authorization": "Bearer rr_live_YOUR_KEY" }
    }
  }
}

VS Code — .vscode/mcp.json:

{
  "servers": {
    "recruiter-roles": {
      "type": "http",
      "url": "https://recruiterroles.com/api/mcp",
      "headers": { "Authorization": "Bearer rr_live_YOUR_KEY" }
    }
  }
}

Claude / ChatGPT custom connector — add the URL with your key appended:

https://recruiterroles.com/api/mcp?key=rr_live_YOUR_KEY
Local stdio server (this npm package)

For stdio-only clients or local development. Set your API key via the RECRUITER_ROLES_API_KEY environment variable:

{
  "mcpServers": {
    "recruiter-roles": {
      "command": "npx",
      "args": ["-y", "recruiter-roles-mcp"],
      "env": { "RECRUITER_ROLES_API_KEY": "rr_live_YOUR_KEY" }
    }
  }
}

Run it directly:

RECRUITER_ROLES_API_KEY=rr_live_YOUR_KEY npx recruiter-roles-mcp

How it works

This is a thin, read-only layer over the public Recruiter Roles v1 REST API. Each tool forwards your API key to one GET /api/v1/* endpoint, so MCP usage shares the same rate limit (1,000 requests/day per key), caching, and request logging as the REST API. The server holds no database connection and no secrets of its own.

Develop

npm install
npm run build
RECRUITER_ROLES_API_KEY=rr_live_YOUR_KEY node dist/index.js

Optional: point at a different origin during development with RECRUITER_ROLES_BASE_URL (default https://recruiterroles.com).

Any page or product that publishes data obtained through this server must include a visible, crawlable link back to Recruiter Roles. Keys may be suspended if the backlink is removed.

License

MIT — see LICENSE.

الأسئلة الشائعة

ما هو io.github.pcmarts/recruiter-roles-mcp؟

Search Recruiter Roles: live recruiter jobs, companies, sectors, locations, and market stats.

كيف أثبّت io.github.pcmarts/recruiter-roles-mcp؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http recruiter-roles-mcp 'https://recruiterroles.com/api/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.pcmarts/recruiter-roles-mcp إلى مفتاح API؟

نعم. يتطلب RECRUITER_ROLES_API_KEY، وتضبطها في إعداداته.

هل io.github.pcmarts/recruiter-roles-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.pcmarts/recruiter-roles-mcp؟

ينشره pcmarts. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.