API para desarrolladores

Busca y publica empleos remotos en México desde tu aplicación, agente o LLM. Hay dos formas de integrarte: la API REST y el servidor MCP.

Autenticación

Todas las peticiones requieren una API key en el header Authorization: Bearer mr_live_.... Las keys las emite el equipo de México Remoto: pídela en contacto indicando tu correo de cuenta y el uso que le darás. Límite: 100 peticiones por minuto por key.

API REST

GET /api/v1/jobs

Lista vacantes activas. Query params: q (texto), category (slug), city, limit (máx 50, default 20), page. Scope requerido: jobs:read.

curl "https://mexicoremoto.com/api/v1/jobs?q=backend&limit=5" \
  -H "Authorization: Bearer mr_live_TU_KEY"

GET /api/v1/jobs/:id

Detalle de una vacante (el id puede ser el ObjectId o el slug). Scope: jobs:read.

POST /api/v1/jobs

Publica una vacante a nombre de tu empresa. Campos obligatorios: title, description, category (slug o nombre), min_salary y max_salary (MXN/mes). Opcionales: city, contract_type, url (para aplicar). La vacante queda activa de inmediato. Scope: jobs:write.

curl -X POST "https://mexicoremoto.com/api/v1/jobs" \
  -H "Authorization: Bearer mr_live_TU_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Backend Developer Node.js",
    "description": "Buscamos una persona con experiencia en Node y MongoDB...",
    "category": "software-development",
    "min_salary": 40000,
    "max_salary": 60000,
    "city": "Remoto",
    "contract_type": "full-time"
  }'

Servidor MCP

Si usas Claude, Cursor u otro cliente compatible con MCP, conéctalo al endpoint https://mexicoremoto.com/mcp (Streamable HTTP) con tu key en el header Authorization. Herramientas disponibles:

  • search_jobs — buscar vacantes (query, category, city, limit)
  • get_job — detalle de una vacante por id o slug
  • post_job — publicar una vacante (requiere scope jobs:write)
// Ejemplo de configuración (Claude Desktop / Cursor)
{
  "mcpServers": {
    "mexico-remoto": {
      "url": "https://mexicoremoto.com/mcp",
      "headers": {
        "Authorization": "Bearer mr_live_TU_KEY"
      }
    }
  }
}

Qué pedirle a tu agente una vez conectado (copy-paste):

Si buscas chamba

Búscame empleos remotos de backend en México que paguen arriba de $40,000 MXN usando México Remoto, y dame los links para aplicar.
Compara las 5 vacantes más recientes de diseño en México Remoto y dime cuál me conviene según mi perfil: [pega tu CV o perfil].

Si reclutas

Publica esta vacante en México Remoto: [pega la descripción del puesto, rango salarial en MXN y link para aplicar].

¿Sin API key? También hay feeds públicos: /jobs.json (JSON con las últimas 50 vacantes), /feed.xml (RSS) y /llms.txt (guía para LLMs).