Coletor de Vagas
Descobre novas postagens, filtra-as de acordo com o perfil do candidato e relata apenas o que é genuinamente novo.
Configuração
Lê de $JOB_SEARCH_HOME/integrations.yaml:
| Necessidade | Chave |
|---|---|
Strings de localização para --where | search_locations |
| CLI estruturada do quadro | tools.board_search_cli |
| CLI opcional do LinkedIn | tools.linkedin_search_cli |
| Arquivo de rastreamento para dedup | tracker_path |
- Categorias, palavras-chave de cargo e filtros:
references/search-queries.md - Fatos do candidato:
$JOB_SEARCH_HOME/profile.md
Se search_locations ou tools.board_search_cli estiver em branco, pare e nomeie a chave. Não recorra a uma cidade codificada ou invente um caminho de CLI.
Invocação
Acionado por "encontrar novos empregos", "coletar vagas", "alguma nova posição", /scrape.
Argumentos opcionais:
- uma área de foco —
/scrape plataforma broad— executa todas as categorias prioritáriasremote— filtra estritamente para remoto e híbridolinkedin— opta pelo canal LinkedIn (consulta Etapa 2b; desligado por padrão)
Etapa 0 — Carregar estado
- Leia
job_scraper/seen_jobs.json, criando-o como{"seen": {}}se ausente - Leia
tracker_pathpara empresas e cargos já inscritos - Leia
references/search-queries.mdpara categorias, palavras-chave e níveis de localização - Leia
$JOB_SEARCH_HOME/profile.mdpara fundamentar a avaliação da Etapa 4
Etapa 1 — Pesquisa estruturada no quadro (principal)
Para cada categoria prioritária, execute a CLI uma vez por palavra-chave de cargo. Top 3 categorias por padrão; todas elas com broad; a categoria nomeada em uma área de foco.
python3 <board_search_cli> --keywords "<cargo>" --where "<local>" --pages 2
# varredura remota:
python3 <board_search_cli> --keywords "<cargo>" --where "All Australia" --remote --pages 2
# apenas recente:
python3 <board_search_cli> --keywords "<cargo>" --where "<local>" --days 14 --pages 2
Execute via Bash. Ele imprime um array JSON — analise-o diretamente. Agrupe as chamadas de palavra-chave; cada uma é rápida. Use search_locations em ordem para --where.
Etapa 2 — Quadros de startups e ATS (secundário, opcional)
Para cargos de engenheiro fundador e estágio inicial que o quadro principal sub-representa, execute algumas pesquisas web em quadros de startups e hosts ATS. Busque uma postagem apenas quando parecer uma correspondência forte. A pesquisa web é tendenciosa por região, portanto verifique a elegibilidade no país do candidato antes de apresentar — muitos resultados não são locais.
Etapa 2b — LinkedIn (apenas com aceitação explícita)
Execute apenas quando o candidato aceitar explicitamente. Automatizar viola os termos da plataforma, portanto está desligado por padrão. Quando aceito, diga que é por conta e risco, mantenha o volume baixo e mescle os resultados na mesma dedup e classificação do canal principal.
Se tools.linkedin_search_cli estiver em branco, diga que o canal não está configurado em vez de adivinhar.
Etapa 3 — Deduplicar
Para cada resultado:
- Pule se seu ID do quadro ou URL, ou sua chave
empresa+cargo, já estiver emseen_jobs.json - Pule se
empresa+rolejá aparecer emtracker_path
Etapa 4 — Avaliação rápida de adequação
Um sinal, não a avaliação completa. Use o teaser, título, salário, regime de trabalho e marcadores retornados pela pesquisa:
- Alta — atinge habilidades essenciais, localização ou remoto funciona, e salário (se exibido) ultrapassa o mínimo
- Média — cargo adjacente, ou localização e salário precisam ser verificados
- Baixa — lacuna significativa de habilidades, ou presencial fora das localizações configuradas sem remoto
Verifique a disciplina antes do título. Um título sênior não é um sinal da disciplina. Um cargo anunciado como "Lead Engineer" ou "Staff Engineer" pode ser um papel de back-end ou engenharia de aplicações cujo requisito central é trabalho prático em nível de especialista em uma linguagem como Java, Spring Boot, .NET ou PHP. Se o requisito central for uma disciplina ou linguagem fora do perfil documentado do candidato, classifique-o como Baixa por mais sênior que seja o título, por mais familiar que seja o domínio. Contexto de pagamentos, bancos ou adjacente à plataforma não transforma um papel de back-end em um papel de plataforma.
Leia $JOB_SEARCH_HOME/targets.md para as stacks a excluir e as Competências Essenciais em profile.md para o que está realmente comprovado. Um requisito listado no anúncio não é evidência de que o candidato o possui.
Aplique o filtro de localização de references/search-queries.md.
Etapa 5 — Armazenar
Registre cada emprego exibido, incluindo os pulados:
{
"seen": {
"<board-id-or-company-title-key>": {
"title": "…", "company": "…", "location": "…", "url": "…",
"salary": "…", "work_arrangement": "…",
"first_seen": "YYYY-MM-DD", "fit": "high|medium|low",
"status": "new|skipped|evaluated"
}
}
}
Etapa 6 — Apresentar
## Novas Correspondências de Vagas — YYYY-MM-DD
Encontradas X novas posições (Y alta, Z média, W baixa correspondência).
| # | Adeq. | Título | Empresa | Localização | Regime | Salário | URL |
|---|-------|--------|---------|-------------|--------|---------|-----|
| 1 | Alta | … | … | … | Remoto/Híbrido | … | [Link](…) |
Em seguida, 2–3 marcadores por correspondência alta: por que se encaixa, requisitos a verificar, bandeiras vermelhas.
Finalize perguntando se deve avaliar alguma em detalhes ou se candidatar. Uma descrição completa é necessária antes que o fluxo de trabalho job-application-assistant possa executar — a etapa de pesquisa retorna apenas um teaser, então busque o detalhe primeiro.
Etapa 7 — Atualizar o rastreador
Se o candidato decidir se candidatar, adicione uma linha a tracker_path.
Regras
- Nunca invente postagens. Apresente apenas o que a CLI ou uma busca real retornou.
- Sempre deduplique contra
seen_jobs.jsonetracker_path. - Respeite os níveis de localização configurados. Pule funções presenciais fora deles, a menos que tenha aceitação.
- Apenas funções abertas. Os resultados são ao vivo, mas pule qualquer coisa visivelmente desatualizada.
- Obtenha a descrição completa antes de avaliar ou se candidatar.
- Disciplina sobre o título. Filtre pela linguagem principal e disciplina nos requisitos, nunca apenas pelo título do cargo. Um título sênior em uma stack que o candidato não possui é uma correspondência Baixa.
- Eficiência. Filtre por título, teaser e salário primeiro; não busque cada postagem.
- Nunca consulte o LinkedIn sem uma aceitação explícita.