MCP Jobs

Un servicio de agregación de empleos sin configuración que obtiene listados de trabajo de los principales sitios web de reclutamiento.

GitHub
140

Documentación

mcp-jobs

🚀 Configuración cero ¡Servicio de agregación de empleos multiplataforma! Basado en la arquitectura MCP, admite la obtención de información de empleos desde los principales sitios de reclutamiento, listo para usar, sin necesidad de configuración.

NPM Version Node.js Version License

⚡ Inicio rápido en 30 segundos

🚀 Paso 1: Iniciar el servicio (configuración cero)

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

🤖 Paso 2: Configurar el cliente de IA

En su cliente de IA (como Cursor, Claude Desktop), agregue:

  • Nombre del servicio: mcp-jobs
  • Comando: npx -y mcp-jobs
  • Variables de entorno: dejar vacío

💬 Paso 3: Comenzar a usar

Dígale directamente al asistente de IA: "Buscar empleos de desarrollo frontend en Beijing"

¡Así de simple! 🎉 Sin registro, sin API Key, sin archivos de configuración.

🌟 Características principales

  • 🔓 Cero barreras: Sin API Key, sin registro, sin configuración
  • 📦 Listo para usar: Un solo comando para iniciar el servicio completo
  • 🔍 Búsqueda inteligente: Admite filtrado por nombre de empleo, ciudad, rango salarial, etc.
  • 🌐 Agregación multiplataforma: Obtiene datos automáticamente de múltiples sitios de reclutamiento
  • 📊 Salida estandarizada: Formato de datos unificado, fácil de procesar para modelos grandes
  • ⚡ Actualización en tiempo real: Garantiza la vigencia de la información de empleos
  • 🔧 Mejoras opcionales: Admite API Key para desbloquear funciones adicionales (completamente opcional)

📦 Métodos de instalación

🚀 Ejecución inmediata (recomendado)

Sin instalación, sin configuración, uso inmediato:

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

🔧 Instalación global (opcional)

Si necesita usarlo con frecuencia:

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

# 直接运行
mcp-jobs

📁 Instalación dentro del proyecto (opcional)

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

🎯 Instrucciones de uso

🚀 Uso básico (configuración cero)

Sin configuración, comience de inmediato:

# 启动服务
npx -y mcp-jobs

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

¡Así de simple!

🔧 Configuración avanzada (completamente opcional)

Si necesita funciones adicionales, puede configurar opcionalmente los siguientes 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               # 可选：调试模式

Descripción de configuración opcional

Elemento de configuraciónPropósito¿Obligatorio?
USERNAMENombre de usuario de autenticación básica❌ Opcional
PASSWORDContraseña de autenticación básica❌ Opcional
CRAWLER_HEADLESSModo sin cabeza del navegador (true/false)❌ Opcional
CRAWLER_TIMEOUTTiempo de espera de página (milisegundos)❌ Opcional
CRAWLER_VIEWPORT_WIDTHAncho de la ventana del navegador❌ Opcional
CRAWLER_VIEWPORT_HEIGHTAlto de la ventana del navegador❌ Opcional
CRAWLER_DEBUGModo depuración (true/false)❌ Opcional

💡 Nota importante: Todas las configuraciones son completamente opcionales. El servicio proporciona funciones principales completas sin ninguna configuración.

🤖 Configuración del cliente de IA

🚀 Configuración de Cursor (configuración cero)

Configuración mínima (recomendada)

  1. Abra la configuración de Cursor
  2. Vaya a Features > MCP Servers
  3. Haga clic en "+ Add New MCP Server"
  4. Ingrese la siguiente información:
    • Name: mcp-jobs
    • Type: command
    • Command: npx -y mcp-jobs

Método de configuración JSON

Configuración básica (lista para usar):

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

Configuración avanzada (mejoras opcionales):

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

💡 Sugerencia: Se recomienda usar la configuración básica, ¡ya proporciona funciones completas de búsqueda de empleos!

🤖 Configuración de Claude Desktop

Configuración cero:

  1. Abra Claude Desktop
  2. Haga clic en el ícono de Configuración en la esquina inferior izquierda
  3. Seleccione la opción "MCP Servers"
  4. Haga clic en "Add New Server"
  5. Ingrese la siguiente información:
    • Name: mcp-jobs
    • Type: command
    • Command: npx -y mcp-jobs
    • Environment Variables: dejar vacío (sin variables necesarias)

¡Eso es todo! Sin API Key, disponible de inmediato.

🚀 Configuración de Windsurf

Configuración básica (cero configuración):

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

🚀 Configuración de Cline

Configuración básica (cero configuración):

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

🔧 Configuración avanzada (completamente opcional)

⚠️ Nota importante: Todas las configuraciones a continuación son completamente opcionales! El servicio proporciona funciones completas sin ninguna configuración.

Si necesita personalizar el comportamiento del servicio, puede configurar opcionalmente las siguientes variables de entorno:

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

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

💡 Recordatorio: ¡Sin necesidad de configuración para usar las funciones completas de búsqueda de empleos!

🎯 Comience a usar ahora

Después de la configuración (¡solo un comando!), puede describir sus necesidades de búsqueda de empleos al asistente de IA en lenguaje natural:

💬 Ejemplos de uso

Búsqueda directa de empleos:

  • "Buscar empleos de ingeniero de desarrollo frontend en Shanghái"
  • "Encontrar puestos de analista de datos en Beijing, con más de 3 años de experiencia"
  • "Encontrar los puestos de gerente de producto con mayor salario en Hangzhou"

Obtener detalles del empleo:

  • "Obtener información detallada de este empleo: [enlace del empleo]"
  • "Analizar los requisitos y el salario de este puesto"

Análisis inteligente:

  • "Comparar los niveles salariales de empleos similares en diferentes ciudades"
  • "Resumir las habilidades más demandadas en el mercado actual"

🚀 Experiencia sin barreras: Sin necesidad de aprender llamadas API complejas, ¡use lenguaje natural directamente para obtener un servicio profesional de búsqueda de empleos!

El modelo grande llamará automáticamente al servicio mcp-jobs para obtener información relevante y mostrarle los resultados.

🔧 Depuración y desarrollo

🐛 Modo de depuración

Si necesita depurar el comportamiento del rastreador o desarrollar nuevas funciones, puede habilitar el modo de depuración:

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

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

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

⚙️ Configuración personalizada del 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

📝 Prioridad de configuración

La prioridad de configuración de mayor a menor:

  1. Configuración específica del sitio - crawlerConfig.ts configurado para sitios específicos en browserConfig
  2. Variables de entorno - configuradas a través de la variable de entorno CRAWLER_*
  3. Configuración predeterminada - valores predeterminados del sistema

🌟 ¿Por qué elegir MCP Jobs?

✅ Cero barreras reales

  • 🚫 Sin registro de cuenta - No necesita completar información personal
  • 🚫 Sin configuración compleja - Un comando para iniciar
  • 🚫 Sin necesidad de leer documentación - Interacción directa en lenguaje natural

⚡ Disponible de inmediato

  • 📦 Listo para usar, sin preparación previa
  • 🔍 Funciones completas de búsqueda de empleos
  • 🌐 Agregación de datos multiplataforma
  • 📊 Salida de datos estandarizada

🛡️ Confiabilidad y estabilidad

  • 🔄 Mecanismo de reintento automático
  • ⚠️ Manejo elegante de errores
  • 📈 Actualización de datos en tiempo real
  • 🔧 Funciones avanzadas opcionales

📋 Notas de uso

  1. Completamente gratuito - Las funciones principales no tienen costo
  2. Cumplimiento de normas - Respete los términos de uso de cada plataforma de reclutamiento
  3. Uso razonable - Se recomienda controlar la frecuencia de solicitudes para evitar acceso excesivo
  4. Requisitos del sistema - Node.js >= 16.0.0

Licencia de código abierto

MIT License

Obtener ayuda

Si encuentra algún problema durante el uso, puede obtener ayuda a través de los siguientes medios: