freehire motor de búsqueda de empleo de código abierto en Go

freehire motor de búsqueda de empleo de código abierto en Go: licencia MIT, instalación según el README, límites y monitorización de la API y los trabajos.
freehire moteur recherche d'emploi open source en Go

freehire motor de búsqueda de empleo: el repositorio strelov1/freehire es un motor de búsqueda de ofertas de TI de código abierto, escrito en Go, que afirma agregar más de 3,3 millones de ofertas abiertas, tomadas directamente de las páginas de empleo de las empresas. Reúne unas 2 600 estrellas y 262 forks en la fecha de revisión, el 22 de octubre de 2026, bajo licencia MIT. El proyecto existe también como servicio alojado (freehire.me), pero su interés para este blog es otro: toda la cadena (recolección, deduplicación, indexación, API) está en el repositorio y se autoaloja.

Es, pues, un buen tema de explotación: una API web, una base de datos PostgreSQL, un motor Meilisearch, Redis y una serie de trabajos programados. Esta guía sigue el README y el código del repositorio.

Aclaración de honestidad: span.observer no ha instalado ni lanzado freehire. Los comandos proceden del README; las cifras de ofertas son las que anuncia el proyecto, no verificadas por nosotros.

freehire motor de búsqueda de empleo: qué dice el repositorio

  • Licencia y lenguaje: MIT; servidor en Go (framework Fiber), front-end SvelteKit.
  • Cifras revisadas el 22 de octubre de 2026 en la página del repositorio: unas 2 600 estrellas (la página solo muestra «2,6 k»), 262 forks, ninguna release publicada.
  • Lo que anuncia el README: una instantánea fechada el 20 de octubre de 2026 con 3 371 563 ofertas abiertas únicas, 477 323 empresas y 320 fuentes, de ellas 117 plataformas de seguimiento de candidaturas (ATS) como Workday, Greenhouse o Lever, además de 97 canales de Telegram. Son cifras del proyecto.
  • Principio: cada oferta se normaliza en un esquema único y se deduplica; los filtros (región, modo de trabajo, seniority, habilidades, salario) provienen de diccionarios mantenidos a mano, no de suposiciones de un modelo, según el README.

Más allá de la búsqueda, el README describe una capa de «candidato»: generador de CV, seguimiento de candidaturas, asistente de IA, servidor MCP y extensión de navegador. Varias de estas funciones requieren un punto de acceso LLM compatible con OpenAI que configuras tú mismo (variables LLM_BASE_URL, LLM_API_KEY, LLM_MODEL en el archivo de ejemplo).

Visita a la interfaz

La captura del README muestra la página de búsqueda: una barra de búsqueda, el número total de ofertas, filtros a la izquierda (región, modo de trabajo, especialización, seniority) y la lista de ofertas a la derecha, cada una con la empresa, el lugar, el nivel y la antigüedad del anuncio. Los nombres de empresas visibles son los del ejemplo del repositorio, y cada oferta remite, según el README, a la página de la empresa.

Captura del README de freehire: página de búsqueda de ofertas con barra de búsqueda, filtros de región, de modo de trabajo, de especialización y de seniority a la izquierda, y lista de ofertas a la derecha
Source : github.com

Instalación paso a paso

El inicio rápido del README presupone Docker; lanza todo el stack (API, front, PostgreSQL, Meilisearch, Redis, almacenamiento compatible con S3).

  1. Clonar el repositorio y situarse en la carpeta.
  2. Lanzar el stack y después probar:
    make up
    curl localhost:8080/health
    curl localhost:8080/api/v1/jobs
  3. Si el puerto 8080 está ocupado, elegir otro puerto del host:
    HIRE_HOST_PORT=8090 make up
Extracto del README de freehire: comandos make up, curl localhost:8080/health, curl localhost:8080/api/v1/jobs y HIRE_HOST_PORT=8090 make up

Las migraciones se aplican automáticamente en la primera inicialización del volumen de PostgreSQL; si modificas una migración, recrea el volumen con docker compose down -v && make up o usa make migrate. Para desarrollar, el README propone docker compose up -d db y después make run, con un archivo .env copiado de .env.example. La variable JWT_SECRET es obligatoria para que arranque el servidor; el archivo de ejemplo lleva un valor de desarrollo que hay que sustituir por un secreto aleatorio fuerte fuera de tu equipo local.

El servidor se limita a servir la API. La recolección, el enriquecimiento, la indexación y las notificaciones son trabajos de ejecución única, pensados para programarse (cron): por ejemplo go run ./cmd/ingest greenhouse para recorrer un proveedor, go run ./cmd/search-drain para ejecutarlo cada uno o dos minutos y volcar las escrituras en el índice, o go run ./cmd/reindex para reconstruir el índice de Meilisearch. Cada trabajo exige DATABASE_URL y termina con un código distinto de cero si falla: es justo lo que debe vigilar tu planificador.

Límites y puntos abiertos

  • Proyecto joven: ninguna release publicada; un repositorio muy activo (el último commit que hemos revisado es del día de la redacción), pero cuya interfaz de configuración puede cambiar deprisa. Fija un commit.
  • Datos recolectados: la herramienta explora páginas de empleo públicas y feeds de terceros. Las condiciones de uso de los sitios de origen, la protección de datos personales y los límites de frecuencia siguen siendo responsabilidad tuya si autoalojas.
  • Cifras no verificadas: el volumen de ofertas y la frescura los anuncia el proyecto.
  • Funciones de IA: dependen de un LLM que aportas tú, con costes y con datos que salen hacia el proveedor elegido. Consulta la elección de un LLM según criterios de explotación.
  • Tamaño del stack: cinco servicios como mínimo y trabajos programados, lejos de un único binario.

Observar freehire en producción

El README cita el stack de observabilidad del proyecto: Langfuse para trazar las llamadas al LLM, Prometheus (mediante el textfile collector de node_exporter) y Grafana para las métricas de la ingesta y del LLM. En el código, la configuración lee una variable METRICS_PORT: si está definida, el servidor expone /metrics en un puerto dedicado en lugar del puerto de la API, para que una regla de cortafuegos interna no deje pasar el resto de la API (comentario del archivo config.go). El servidor usa para ello la biblioteca cliente de Prometheus.

Para tu propia monitorización, tanto en Dynatrace SaaS como en Dynatrace Managed:

El repositorio no anuncia exportación de trazas de OpenTelemetry; las dependencias de OpenTelemetry presentes en go.mod figuran allí como «indirectas». No cuentes, pues, con trazas listas para usar.

Cómo comprobar que funciona

  1. curl localhost:8080/health responde; curl localhost:8080/api/v1/jobs devuelve un objeto con data y meta (formato descrito en el README), posiblemente vacío mientras no se haya recolectado nada.
  2. Tras un primer cmd/ingest y después cmd/search-drain, las ofertas aparecen en la búsqueda.
  3. Si METRICS_PORT está definido, /metrics responde en ese puerto.

Buenas prácticas

  • Sustituye JWT_SECRET y no dejes nunca el puerto de métricas abierto a Internet.
  • Programa los trabajos con un orquestador que registre el código de salida y la duración.
  • Haz copia de seguridad de PostgreSQL: es el sistema de referencia, el índice se reconstruye.
  • Para otras piezas autoalojadas, consulta el stack de IA de código abierto autoalojado; para una base Postgres del mismo espíritu, consulta Supabase.

Preguntas frecuentes

¿Hay que autoalojar o usar freehire.me?

El sitio alojado basta para buscar ofertas. El autoalojamiento tiene sentido para explotar los datos o la API, al precio de un stack que mantener.

¿Hace falta un LLM?

No para la búsqueda: las funciones que lo necesitan siguen desactivadas mientras no se definan las variables LLM_*, según el README y la documentación de las funciones.

¿Puedo añadir una empresa?

Sí: el README indica que añadir una empresa es una línea del catálogo «boards» (empresa, proveedor, identificador del tablero de ofertas), mediante el formulario del sitio o el comando cmd/add-board, y pide abrir primero una issue para una plataforma nueva.

Conclusión

freehire es un motor de búsqueda de empleo completo y abierto, interesante de leer como arquitectura: API, trabajos de ejecución única, índice y métricas separados. Queda por verificar sus cifras y tus obligaciones sobre los datos recolectados. Fuentes: repositorio strelov1/freehire.

span.observer es un blog independiente de la comunidad, no afiliado a Dynatrace LLC ni a los proyectos citados. Las marcas citadas pertenecen a sus propietarios. Las herramientas evolucionan rápido: comprueba los comandos y las opciones en su documentación oficial.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
Kronos modèle fondation pour les marchés financiers

Kronos modelo de fundación para los mercados financieros

Next Post
REA ingénierie inverse par agents IA via MCP

REA ingeniería inversa con agentes de IA mediante MCP

Related Posts