API y servidor MCP
Última actualización: 17 de noviembre de 2026
Todo lo que muestra el directorio también está disponible para programas y agentes de IA, gratis y sin iniciar sesión: búsqueda, perfiles con sus datos de contacto, opiniones y rankings. Esta página es pública y describe las dos puertas, que ejecutan el mismo código.
Qué hay disponible
- Una API REST en https://eltrabajito.com/api/v1 (JSON, sin llave).
- Un servidor MCP (Model Context Protocol) en https://eltrabajito.com/mcp/public, también abierto, para agentes y asistentes de IA.
- La descripción OpenAPI en https://eltrabajito.com/api/v1/openapi.json.
- Ayuda en texto plano para agentes en https://eltrabajito.com/llms.txt y una versión en Markdown de cada perfil y página de mejores (agrega .md a su dirección).
Ambas puertas son de solo lectura y devuelven los mismos datos. Escribir (agregar o editar negocios) es solo para administradores, mira la última sección.
API REST (abierta)
Envía peticiones GET; las respuestas son JSON. No hace falta token.
- GET /api/v1/businesses?query=plomero&category=plumbing&place=Heredia&minRating=4&limit=5 busca en el directorio, ordenado por calificación.
- GET /api/v1/businesses/:slug devuelve un perfil completo con sus datos de contacto.
- GET /api/v1/businesses/:slug/reviews?page=1 devuelve sus opiniones, de la más reciente a la más antigua.
- GET /api/v1/categories lista las categorías que tienen perfiles.
- GET /api/v1/categories/:categoria/top?place=Heredia devuelve los mejor calificados de una categoría.
Todas aceptan language=es o language=en. Ejemplo:
curl "https://eltrabajito.com/api/v1/businesses?query=plomero&limit=3" Servidor MCP (abierto)
Agrega https://eltrabajito.com/mcp/public como servidor MCP remoto (Streamable HTTP, sin autenticación) en cualquier asistente o agente compatible con MCP. Herramientas: search_businesses, get_business, get_business_reviews, top_rated y list_categories; todas son de solo lectura y están descritas para agentes. Documento de descubrimiento: https://eltrabajito.com/.well-known/mcp/server-card.json. El servidor también está en el registro oficial de MCP.
Para probarlo sin un cliente:
curl -X POST https://eltrabajito.com/mcp/public -H "content-type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' Datos de contacto y opiniones
Un perfil devuelve lo que el negocio hizo público: nombre, servicios, zona de servicio (redondeada a 1 km aproximadamente), teléfono, enlace de WhatsApp, correo, sitio web, páginas de Instagram, TikTok y Facebook, formas de pago, calificación y fotos. Las opiniones incluyen la calificación, el texto, la fecha y el nombre y la inicial de quien opina.
El correo es información pública, pero úsalo para atender lo que el negocio necesita y nunca para mensajes masivos no solicitados. Las calificaciones y opiniones vienen de usuarios con sesión iniciada y no están verificadas; el directorio no verifica licencias ni la calidad del trabajo. Cuando recomiendes a alguien, da la dirección del perfil para que cada persona lo compruebe.
Límites
Las lecturas se limitan por dirección (unas 60 peticiones por minuto, compartidas entre la API REST y el servidor MCP). Si te pasas recibes una respuesta 429 con el encabezado Retry-After: espera esos segundos y vuelve a intentar. Si necesitas más, escríbenos.
Administradores: escribir con un token
Agregar y editar negocios, crear enlaces de reclamo, enviar correos y acciones parecidas requieren un token que solo un superadministrador puede crear (en el área de administración, pestaña MCP). Los tokens empiezan con etm_ y se envían como Authorization: Bearer. Funcionan en el servidor MCP autenticado en https://eltrabajito.com/mcp y en la puerta REST POST https://eltrabajito.com/api/v1/admin/:herramienta, cuyo cuerpo JSON son los argumentos de la herramienta (create_business, update_business, find_businesses, create_claim_link, send_email, create_category y otras). Ambas aplican las mismas verificaciones y límites diarios. Leer nunca necesita token.
Archivos para máquinas
- https://eltrabajito.com/api/v1/openapi.json: la API REST.
- https://eltrabajito.com/.well-known/mcp/server-card.json: el servidor MCP.
- https://eltrabajito.com/llms.txt: una guía para agentes de IA.
- https://eltrabajito.com/sitemap-index.xml y https://eltrabajito.com/sitemap-providers.xml: todas las páginas públicas.
¿Dudas? Escríbenos a info@eltrabajito.com. Privacidad