Telegram bot de 60 líneas que filtra ofertas de trabajo en tiempo real

Un bot en 60 líneas de Python llega a la consola cada mañana, llama a la API de HiringIndex y envía a un chat de Telegram las vacantes publicadas en los últimos siete días.

El script se ejecuta por cron y mantiene un fichero seen.txt con los identificadores de las ofertas ya enviadas; cada anuncio se publica solo una vez. La consulta se hace a la ruta /jobs/search con un filtro mínimo:

FILTER = {
    "job_titles": ["Python Developer"],
    "remote_flag": ["true"],
    "days_ago": 7,
    "limit": 20,
}

Con esa configuración la respuesta contiene, por ejemplo, 10 860 publicaciones remotas de Python en los últimos siete días, provenientes de 2 227 empresas y con un tiempo medio de publicación de 4 días. La API devuelve rows; si se necesita contar ofertas reales, se debe usar /jobs/insights.

El bot envía cada anuncio como un mensaje HTML:

• Título en negrita
• Nombre de la empresa
• Información de país, tipo de empleo y seniority
• Fecha de publicación
• Enlace de aplicación

Los filtros son muy flexibles: se pueden cambiar a keywords, handles, ciudades, seniority o rango salarial. Por ejemplo, {"keywords": ["kubernetes"], "days_ago": 3} recupera las últimas 3 días de ofertas con esa palabra clave.

La capa de error de la API es simple: devuelve un objeto con error y message; el script solo necesita comprobar el código de estado. Si la llamada falla con 503, el script espera el tiempo indicado por Retry-After y reintenta.

El plan gratuito de HiringIndex permite 200 publicaciones y 5 llamadas a insights por mes, sin necesidad de tarjeta. Los límites se aplican a las llamadas de búsqueda; las llamadas a insights no tienen restricción de frecuencia.

Para usarlo, basta con crear un bot de Telegram, obtener su token y definir el chat ID. El script necesita las variables de entorno RAPIDAPI_KEY, TG_BOT_TOKEN y TG_CHAT_ID.

El código completo (menos la gestión de entorno) está disponible en el repositorio de RapidAPI y se ha ejecutado contra la versión 2026‑09‑13 de la API.

Este enfoque demuestra que se pueden construir alertas de empleo en tiempo real sin complejidad, con un mantenimiento mínimo y sin base de datos propia.

Por qué importa

Para equipos de reclutamiento, DevOps y arquitectos, tener acceso inmediato a las vacantes más recientes evita la latencia típica de los portales tradicionales. El bot permite integrar la información de HiringIndex en flujos de trabajo existentes y automatizar la notificación de oportunidades relevantes sin invertir en infraestructura adicional.