MCP Jobs

Um serviço de agregação de vagas sem configuração que busca listagens de empregos dos principais sites de recrutamento.

GitHub
139

Documentação

mcp-jobs

🚀 Zero-configuração serviço de agregação de vagas multiplataforma! Baseado na arquitetura MCP, suporta obtenção de informações de vagas dos principais sites de recrutamento, pronto para uso, sem qualquer configuração.

NPM Version Node.js Version License

⚡ Início rápido em 30 segundos

🚀 Passo 1: Inicie o serviço (zero configuração)

# 一行命令，立即启动
npx -y mcp-jobs

🤖 Passo 2: Configure o cliente de IA

No seu cliente de IA (como Cursor, Claude Desktop), adicione:

  • Nome do serviço: mcp-jobs
  • Comando: npx -y mcp-jobs
  • Variáveis de ambiente: deixe em branco

💬 Passo 3: Comece a usar

Basta dizer ao assistente de IA: "Pesquisar vagas de desenvolvedor front-end em Pequim"

Simples assim! 🎉 Sem registro, sem API Key, sem arquivos de configuração.

🌟 Recursos principais

  • 🔓 Zero barreiras: sem API Key, sem registro, sem configuração
  • 📦 Pronto para uso: um único comando inicia o serviço completo
  • 🔍 Busca inteligente: suporte a filtros por nome da vaga, cidade, faixa salarial, etc.
  • 🌐 Agregação multiplataforma: obtém dados automaticamente de vários sites de recrutamento
  • 📊 Saída padronizada: formato de dados unificado, fácil de processar por modelos de IA
  • ⚡ Atualização em tempo real: garante a atualidade das informações das vagas
  • 🔧 Aprimoramento opcional: suporte a API Key para desbloquear recursos extras (totalmente opcional)

📦 Métodos de instalação

🚀 Execução imediata (recomendado)

Sem instalação, sem configuração, use imediatamente:

# 一行命令，立即启动
npx -y mcp-jobs

🔧 Instalação global (opcional)

Se você precisar usar com frequência:

# 全局安装
npm install -g mcp-jobs

# 直接运行
mcp-jobs

📁 Instalação no projeto (opcional)

# 安装到项目依赖中
npm install mcp-jobs
# 或使用 yarn
yarn add mcp-jobs
# 或使用 pnpm
pnpm add mcp-jobs

🎯 Instruções de uso

🚀 Uso básico (zero configuração)

Sem qualquer configuração, comece imediatamente:

# 启动服务
npx -y mcp-jobs

# 服务将自动提供以下功能：
# ✅ 职位搜索
# ✅ 职位详情获取
# ✅ 多平台数据聚合
# ✅ 标准化数据输出

Simples assim!

🔧 Configuração avançada (totalmente opcional)

Se você precisar de recursos aprimorados adicionais, pode configurar seletivamente os seguintes parâmetros:

# 可选：复制配置模板
cp .env.example .env

# 可选：编辑配置文件，取消注释您需要的功能
# USERNAME=your_username            # 可选：基础认证
# PASSWORD=your_password            # 可选：基础认证

# 可选：爬虫配置
# CRAWLER_HEADLESS=true             # 可选：无头模式 (调试时可设为 false)
# CRAWLER_TIMEOUT=30000             # 可选：页面超时时间 (毫秒)
# CRAWLER_VIEWPORT_WIDTH=1280       # 可选：浏览器视窗宽度
# CRAWLER_VIEWPORT_HEIGHT=800       # 可选：浏览器视窗高度
# CRAWLER_DEBUG=false               # 可选：调试模式

Descrição das configurações opcionais

Item de configuraçãoFinalidadeObrigatório
USERNAMENome de usuário de autenticação básica❌ Opcional
PASSWORDSenha de autenticação básica❌ Opcional
CRAWLER_HEADLESSModo headless do navegador (true/false)❌ Opcional
CRAWLER_TIMEOUTTempo limite da página (milissegundos)❌ Opcional
CRAWLER_VIEWPORT_WIDTHLargura da janela do navegador❌ Opcional
CRAWLER_VIEWPORT_HEIGHTAltura da janela do navegador❌ Opcional
CRAWLER_DEBUGModo de depuração (true/false)❌ Opcional

💡 Aviso importante: todas as configurações são totalmente opcionais. O serviço fornece funcionalidades principais completas sem qualquer configuração.

🤖 Configuração do cliente de IA

🚀 Configuração no Cursor (zero configuração)

Configuração mínima (recomendado)

  1. Abra as configurações do Cursor
  2. Vá em Features > MCP Servers
  3. Clique em "+ Add New MCP Server"
  4. Insira as seguintes informações:
    • Name: mcp-jobs
    • Type: command
    • Command: npx -y mcp-jobs

Método de configuração JSON

Configuração básica (pronto para uso):

{
  "mcpServers": {
    "mcp-jobs": {
      "command": "npx",
      "args": ["-y", "mcp-jobs"]
    }
  }
}

Configuração avançada (aprimoramento opcional):

{
  "mcpServers": {
    "mcp-jobs": {
      "command": "npx",
      "args": ["-y", "mcp-jobs"],
      "env": {
        "USERNAME": "your-username",
        "PASSWORD": "your-password"
      }
    }
  }
}

💡 Dica: recomendamos a configuração básica, que já oferece funcionalidade completa de busca de vagas!

🤖 Configuração no Claude Desktop

Configuração zero:

  1. Abra o Claude Desktop
  2. Clique no ícone de Configurações no canto inferior esquerdo
  3. Selecione a opção "MCP Servers"
  4. Clique em "Add New Server"
  5. Insira as seguintes informações:
    • Name: mcp-jobs
    • Type: command
    • Command: npx -y mcp-jobs
    • Environment Variables: deixe em branco (sem necessidade de variáveis)

Pronto! Sem API Key, disponível imediatamente.

🚀 Configuração no Windsurf

Configuração básica (zero configuração):

{
  "mcpServers": {
    "mcp-jobs": {
      "command": "npx",
      "args": ["-y", "mcp-jobs"]
    }
  }
}

🚀 Configuração no Cline

Configuração básica (zero configuração):

mcp:
  servers:
    mcp-jobs:
      command: npx
      args: ["-y", "mcp-jobs"]

🔧 Configuração avançada (totalmente opcional)

⚠️ Aviso importante: todas as configurações abaixo são totalmente opcionais! O serviço oferece funcionalidade completa sem qualquer configuração.

Se você precisar personalizar o comportamento do serviço, pode configurar seletivamente as seguintes variáveis de ambiente:

# 可选：MCP API 密钥（用于解锁高级功能）
# 可选：基础认证
# USERNAME=your-username
# PASSWORD=your-password

# 可选：自定义 MCP 服务地址

💡 Lembrete: nenhuma configuração é necessária para usar a funcionalidade completa de busca de vagas!

🎯 Comece a usar agora

Após a configuração (apenas um comando!), você pode descrever suas necessidades de busca de vagas ao assistente de IA em linguagem natural:

💬 Exemplos de uso

Busca direta de vagas:

  • "Pesquisar vagas de engenheiro de desenvolvimento front-end na região de Xangai"
  • "Encontrar vagas de analista de dados em Pequim, exigindo mais de 3 anos de experiência"
  • "Descobrir as vagas de gerente de produto com maior salário na região de Hangzhou"

Obter detalhes da vaga:

  • "Obter informações detalhadas desta vaga: [link da vaga]"
  • "Analisar os requisitos e a faixa salarial desta posição"

Análise inteligente:

  • "Comparar os níveis salariais de vagas semelhantes em diferentes cidades"
  • "Resumir as habilidades mais demandadas no mercado atual"

🚀 Experiência sem barreiras: sem necessidade de aprender chamadas de API complexas, basta usar linguagem natural para obter um serviço profissional de busca de vagas!

O modelo de IA chamará automaticamente o serviço mcp-jobs para obter informações relevantes e exibir os resultados para você.

🔧 Depuração e desenvolvimento

🐛 Modo de depuração

Se você precisar depurar o comportamento do crawler ou desenvolver novos recursos, pode ativar o modo de depuração:

# 启用可视化浏览器窗口（非无头模式）
CRAWLER_HEADLESS=false npx -y mcp-jobs

# 启用调试日志
CRAWLER_DEBUG=true npx -y mcp-jobs

# 组合使用
CRAWLER_HEADLESS=false CRAWLER_DEBUG=true npx -y mcp-jobs

⚙️ Configuração personalizada do navegador

# 自定义视窗大小
CRAWLER_VIEWPORT_WIDTH=1920 CRAWLER_VIEWPORT_HEIGHT=1080 npx -y mcp-jobs

# 增加超时时间（适用于慢速网络）
CRAWLER_TIMEOUT=60000 npx -y mcp-jobs

# 自定义用户代理
CRAWLER_USER_AGENT="Custom Bot 1.0" npx -y mcp-jobs

📝 Prioridade de configuração

A prioridade das configurações, da mais alta para a mais baixa:

  1. Configuração específica do site - definida em crawlerConfig.ts para sites específicos via browserConfig
  2. Variáveis de ambiente - definidas através da variável de ambiente CRAWLER_*
  3. Configuração padrão - valores padrão do sistema

🌟 Por que escolher o MCP Jobs?

✅ Verdadeiramente sem barreiras

  • 🚫 Sem registro de conta - sem necessidade de preencher informações pessoais
  • 🚫 Sem configuração complexa - um único comando para iniciar
  • 🚫 Sem necessidade de ler documentação - interaja diretamente em linguagem natural

⚡ Disponível imediatamente

  • 📦 Pronto para uso, sem qualquer preparação
  • 🔍 Funcionalidade completa de busca de vagas
  • 🌐 Agregação de dados multiplataforma
  • 📊 Saída de dados padronizada

🛡️ Confiável e estável

  • 🔄 Mecanismo de nova tentativa automática
  • ⚠️ Tratamento elegante de erros
  • 📈 Atualização de dados em tempo real
  • 🔧 Recursos avançados opcionais

📋 Avisos de uso

  1. Totalmente gratuito - os recursos principais não exigem nenhum custo
  2. Conformidade - respeite os termos de uso de cada plataforma de recrutamento
  3. Uso razoável - recomendamos controlar a frequência de solicitações para evitar acesso excessivo
  4. Requisitos do sistema - Node.js >= 16.0.0

Licença de código aberto

MIT License

Obter ajuda

Se você encontrar algum problema durante o uso, obtenha ajuda através dos seguintes canais: