¿Qué hace Buscador de Empleos?
Descubre nuevas ofertas, las filtra según el perfil del candidato y reporta solo lo que es genuinamente nuevo.
Configuración
Lee desde $JOB_SEARCH_HOME/integrations.yaml:
| Necesidad | Clave |
|---|---|
Cadenas de ubicación para --where | search_locations |
| CLI del tablón estructurado | tools.board_search_cli |
| CLI opcional de LinkedIn | tools.linkedin_search_cli |
| Archivo de seguimiento para deduplicación | tracker_path |
- Categorías, palabras clave de roles y filtros:
references/search-queries.md - Datos del candidato:
$JOB_SEARCH_HOME/profile.md
Si search_locations o tools.board_search_cli está en blanco, detente y nombra la clave. No
recurras a una ciudad hardcodeada ni inventes una ruta de CLI.
Invocación
Se activa con "buscar nuevos empleos", "rastrear empleos", "nuevas posiciones", /scrape.
Argumentos opcionales:
- un área de enfoque —
/scrape platform broad— ejecutar todas las categorías prioritariasremote— filtrar estrictamente a remoto e híbridolinkedin— optar por el canal de LinkedIn (ver Paso 2b; desactivado por defecto)
Paso 0 — Cargar estado
- Leer
job_scraper/seen_jobs.json, creándolo como{"seen": {}}si no existe - Leer
tracker_pathpara empresas y roles ya contactados - Leer
references/search-queries.mdpara categorías, palabras clave y niveles de ubicación - Leer
$JOB_SEARCH_HOME/profile.mdpara fundamentar la evaluación del Paso 4
Paso 1 — Búsqueda en tablón estructurado (principal)
Para cada categoría prioritaria, ejecutar el CLI una vez por palabra clave de título de rol. Las 3 categorías principales por
defecto; todas con broad; la categoría nombrada en un área de enfoque.
python3 <board_search_cli> --keywords "<rol title>" --where "<ubicación>" --pages 2
# barrido remoto:
python3 <board_search_cli> --keywords "<rol title>" --where "All Australia" --remote --pages 2
# solo recientes:
python3 <board_search_cli> --keywords "<rol title>" --where "<ubicación>" --days 14 --pages 2
Ejecutar mediante Bash. Imprime un array JSON — analizarlo directamente. Agrupar las llamadas de palabras clave; cada una es
rápida. Usar search_locations en orden para --where.
Paso 2 — Tablones de startups y ATS (secundario, opcional)
Para roles de ingeniero fundador y etapas tempranas que el tablón principal no cubre bien, ejecutar unas pocas búsquedas web en tablones de startups y hosts ATS. Obtener una oferta solo cuando parezca una coincidencia fuerte. La búsqueda web está sesgada por región, así que verificar la elegibilidad en el país del candidato antes de presentar — muchos resultados no son locales.
Paso 2b — LinkedIn (solo con aceptación explícita)
Ejecutar solo cuando el candidato haya optado explícitamente. Automatizarlo viola los términos de la plataforma, por lo que está desactivado por defecto. Cuando se haya optado, indicar que es bajo su propio riesgo, mantener el volumen bajo y fusionar los resultados en la misma deduplicación y clasificación que el canal principal.
Si tools.linkedin_search_cli está en blanco, decir que el canal no está configurado en lugar de adivinar.
Paso 3 — Deduplicar
Para cada resultado:
- Omitir si su ID de tablón o URL, o su clave
empresa+título, ya está enseen_jobs.json - Omitir si
empresa+rolya aparece entracker_path
Paso 4 — Evaluación rápida de ajuste
Una señal, no la evaluación completa. Usar el avance, título, salario, modalidad de trabajo y viñetas devueltas por la búsqueda:
- Alto — acierta habilidades clave, ubicación o remoto funciona, y salario (si se muestra) supera el mínimo
- Medio — rol adyacente, o ubicación y salario necesitan verificación
- Bajo — brecha significativa de habilidades, o presencial fuera de las ubicaciones configuradas sin opción remota
Verificar la disciplina antes que el título. Un título senior no es una señal de la disciplina. Un rol anunciado como "Lead Engineer" o "Staff Engineer" puede ser un rol de backend o de ingeniería de aplicaciones cuyo requisito central es trabajo práctico de nivel experto en un lenguaje como Java, Spring Boot, .NET o PHP. Si el requisito central es una disciplina o lenguaje fuera del perfil documentado del candidato, calificarlo como Bajo por muy senior que sea el título, por muy familiar que sea el dominio. El contexto de pagos, banca o plataforma adyacente no convierte un rol de backend en un rol de plataforma.
Leer $JOB_SEARCH_HOME/targets.md para los stacks a excluir, y las Habilidades Clave en
profile.md para lo que realmente está comprobado. Un requisito listado en el anuncio no es evidencia de que el
candidato lo tenga.
Aplicar el filtro de ubicación desde references/search-queries.md.
Paso 5 — Almacenar
Registrar cada empleo encontrado, incluidos los omitidos:
{
"seen": {
"<ID-de-tablón-o-clave-empresa-título>": {
"title": "…", "company": "…", "location": "…", "url": "…",
"salary": "…", "work_arrangement": "…",
"first_seen": "YYYY-MM-DD", "fit": "high|medium|low",
"status": "new|skipped|evaluated"
}
}
}
Paso 6 — Presentar
## Nuevas coincidencias de empleo — YYYY-MM-DD
Se encontraron X nuevas posiciones (Y altas, Z medias, W bajas).
| # | Ajuste | Título | Empresa | Ubicación | Modalidad | Salario | URL |
|---|--------|--------|---------|-----------|-----------|---------|-----|
| 1 | Alto | … | … | … | Remoto/Híbrido | … | [Enlace](…) |
Luego 2–3 viñetas por cada coincidencia alta: por qué encaja, requisitos a verificar, banderas rojas.
Terminar preguntando si evaluar alguna en detalle o postular. Se necesita una descripción completa
antes de que el flujo de trabajo job-application-assistant pueda ejecutarse — el paso de búsqueda devuelve solo un avance,
así que obtener el detalle primero.
Paso 7 — Actualizar el rastreador
Si el candidato decide postular, agregar una fila a tracker_path.
Reglas
- Nunca inventar ofertas. Presentar solo lo que el CLI o una obtención real devolvieron.
- Siempre deduplicar contra
seen_jobs.jsonytracker_path. - Respetar los niveles de ubicación configurados. Omitir roles presenciales fuera de ellos a menos que se haya optado.
- Solo roles abiertos. Los resultados están vivos, pero omitir cualquier cosa visiblemente obsoleta.
- Obtener la descripción completa antes de evaluar o postular.
- Disciplina sobre título. Filtrar por el lenguaje principal y la disciplina en los requisitos, nunca solo por el título del puesto. Un título senior en un stack que el candidato no domina es una coincidencia Baja.
- Eficiencia. Filtrar por título, avance y salario primero; no obtener cada oferta.
- Nunca consultar LinkedIn sin una aceptación explícita.