Varredura de portais de vagas
Configure e execute o scanner de portais para encontrar novas vagas automaticamente.
Este guia mostra como configurar o portals.yml e executar o scanner de portais para encontrar novas vagas automaticamente.
Antes de começar
Confira se você já concluiu o guia de Início rápido. Você precisa ter o cv.md e o modes/_profile.md prontos para que a varredura seja útil.
Configure o portals.yml
O portals.yml é o arquivo que controla o que o scanner procura e onde ele procura. Você o cria uma única vez a partir do modelo incluído e depois o edita para refletir os cargos que você busca.
Execute este comando na pasta do projeto:
cp templates/portals.example.yml portals.ymlAbra o portals.yml em qualquer editor de texto. Os passos abaixo explicam as três seções que você edita primeiro: o filtro de títulos, as empresas para acompanhar e as consultas de busca.
Configure o filtro de títulos
O filtro de títulos é como o scanner decide se vale a pena mostrar uma vaga para você. Ele compara o título da vaga com duas listas de palavras-chave.
Localize a seção title_filter perto do início do arquivo:
title_filter:
positive:
- "AI"
- "ML"
- "Product Manager"
negative:
- "Junior"
- "Intern"
seniority_boost:
- "Senior"
- "Staff"
- "Lead"Substitua a lista positive por palavras-chave que correspondam aos cargos que você busca. Uma vaga precisa corresponder a pelo menos uma palavra-chave dessa lista para passar. A verificação não diferencia maiúsculas de minúsculas, então "AI" também captura "ai engineer".
Substitua a lista negative por palavras-chave que eliminam uma vaga. Se qualquer uma delas aparecer no título, a vaga é ignorada, mesmo que tenha correspondido a uma palavra-chave positiva.
Deixe seniority_boost como está, a menos que você queira adicionar ou remover níveis de senioridade. Essas palavras-chave não eliminam nada: elas apenas colocam as vagas correspondentes mais acima nos resultados.
Exemplo: se você procura vagas de engenharia Rails, seu filtro pode ficar assim:
title_filter:
positive:
- "Rails"
- "Ruby"
- "Full Stack"
- "Backend"
negative:
- "Junior"
- "Intern"
- "PHP"
- "Java"
seniority_boost:
- "Senior"
- "Staff"
- "Lead"Dica
Comece com uma lista positive pequena, de três a cinco palavras-chave. Você sempre pode adicionar mais depois. Uma lista longa dificulta entender por que uma vaga passou ou foi descartada.
Adicione empresas para acompanhar
A seção tracked_companies é uma lista de empresas específicas que você quer que o scanner verifique todas as vezes. O scanner vai direto à página de vagas de cada empresa e lê as posições abertas.
Localize a seção tracked_companies perto do final do arquivo. Cada entrada tem este formato:
tracked_companies:
- name: Anthropic
careers_url: https://job-boards.greenhouse.io/anthropic
api: https://boards-api.greenhouse.io/v1/boards/anthropic/jobs
enabled: true
- name: OpenAI
careers_url: https://openai.com/careers
enabled: truePara adicionar uma empresa, copie uma entrada existente e altere os valores:
| Campo | O que colocar |
|---|---|
name | O nome da empresa como você quer que apareça nos resultados |
careers_url | A URL direta da página de vagas da empresa |
api | Opcional. A URL da API do Greenhouse, se a empresa usar o Greenhouse. Deixe de fora se não tiver certeza. |
enabled | Defina como true para incluir a empresa ou false para ignorá-la sem apagar a entrada. |
Para encontrar a careers_url de uma empresa, acesse o site da empresa, clique em Careers, Jobs ou "Trabalhe conosco" e copie a URL da página que lista as vagas abertas. É essa a URL que você deve usar.
Para desativar uma empresa sem apagá-la, defina enabled: false:
- name: Stripe
careers_url: https://stripe.com/jobs/search
enabled: falseObservação
Toda empresa em tracked_companies precisa ter uma careers_url. Sem ela, o scanner não tem página para visitar e ignora a entrada.
Revise as consultas de busca
A seção search_queries executa buscas mais amplas na web para encontrar vagas em empresas que não estão na sua lista de acompanhamento. O modelo já inclui muitas consultas prontas.
Você não precisa alterar esta seção para começar. As consultas prontas cobrem os principais portais de vagas, incluindo Greenhouse e Ashby, entre outros.
Quando você quiser personalizar, cada consulta tem este formato:
search_queries:
- name: Greenhouse — Rails Engineer
query: 'site:job-boards.greenhouse.io "Rails Engineer" OR "Ruby on Rails" remote'
enabled: truePara desativar uma consulta de que você não precisa, defina enabled: false. Para adicionar uma nova, copie uma entrada existente, dê a ela um novo name e atualize o texto de query.
Escolha o idioma das vagas (opcional)
Alguns portais de vagas publicam a mesma vaga em vários idiomas. Se você se candidata só em alguns deles, liste esses idiomas em ordem de preferência:
preferred_languages: [en]Quando uma vaga tem versões nesses idiomas, a varredura fica com a do idioma que aparece primeiro na sua lista; caso contrário, fica com a versão padrão da vaga. É uma ordem de preferência, não um filtro: nenhuma vaga é descartada, e você continua recebendo uma linha por vaga. Variantes regionais contam como um único idioma, então en-GB é en. Para definir o idioma de uma única empresa, adicione o parâmetro do próprio portal à careers_url dela: ?language=xx no Personio, ?lang=xx no Recruitee.
Execute uma varredura
Há duas formas de executar uma varredura. Use a que atende à sua necessidade.
Opção A — Execute o script diretamente
npm run scanExecute o comando na pasta do projeto. O script lê o portals.yml, consulta diretamente a API de cada empresa e grava as vagas novas em data/pipeline.md. Ele não consome tokens de IA e roda em cerca de 30 segundos.
Esta opção funciona para qualquer empresa cuja página de vagas rode em uma plataforma para a qual o scanner tem um provedor integrado: Greenhouse, Ashby e Lever, além de dezenas de outros sistemas de triagem (ATS) e portais de vagas, como Workable, Workday e SmartRecruiters. A lista completa está em SUPPORTED_JOB_BOARDS.md. Empresas sem provedor correspondente são ignoradas, e a varredura informa quantas foram.
Veja os resultados antes de salvá-los:
npm run scan -- --dry-runO comando executa a varredura completa, mas não grava nada em disco. Use-o para conferir as configurações do filtro antes de gravar os resultados.
Faça a varredura de uma única empresa:
npm run scan -- --company AnthropicSubstitua Anthropic por qualquer nome de empresa da sua lista tracked_companies. A correspondência não diferencia maiúsculas de minúsculas.
Faça a varredura dos sites de vagas da Dayforce:
Os sites de vagas da Dayforce (Ceridian), em jobs.dayforcehcm.com, bloqueiam requisições web simples, então o npm run scan não consegue lê-los. Em vez disso, um script separado abre uma sessão real de navegador para eles, o que o deixa mais lento do que a varredura principal. Liste esses portais em dayforce_boards no portals.yml, com uma entrada por empresa contendo o name e o tenant dela (o código da empresa no endereço da Dayforce); o templates/portals.example.yml mostra o formato. Depois execute:
npm run scan:dayforceAs vagas novas vão para data/pipeline.md, como na varredura principal. Adicione -- --dry-run para ver os resultados sem salvar, -- --tenant <tenant> para fazer a varredura de um único portal ou -- --debug para salvar uma captura de tela de cada portal em output/. Se um portal exibir um desafio anti-bot, o script o ignora; ele nunca tenta contorná-lo.
Opção B — Execute a varredura com IA dentro do Claude Code
Abra o Claude Code na pasta do projeto e digite:
/career-ops scanEsta versão visita a página de vagas de cada empresa diretamente, usando um navegador, então funciona até para empresas que não têm API pública. Ela também executa as search_queries do seu portals.yml para encontrar vagas em empresas que não estão na sua lista de acompanhamento.
Use esta opção quando:
- Uma empresa da sua lista usa uma plataforma para a qual o script não tem provedor, e por isso a varredura pelo script a ignora
- Você quer descobrir empresas novas, e não apenas verificar as que já conhece
- A varredura pelo script deixou passar algo que você esperava ver
Se o script deixou passar uma vaga que você mesmo encontrou, pergunte primeiro a ele por quê:
node coverage-check.mjs <url> --company "<company>" --title "<job title>"Ele lê o seu portals.yml e o histórico de varreduras sem acessar a internet, explica por que a vaga ficou de fora (a empresa não está na sua lista de acompanhamento, a entrada dela está desativada, nenhum provedor lê o site de vagas dela ou um filtro de títulos ou de localização a descartou) e propõe a única mudança que a teria encontrado. Ele nunca edita o portals.yml por você.
Dica
A Opção B consome tokens do modelo de IA e demora mais do que o script. Se esses tokens são cobrados de uma chave de API ou entram na sua assinatura depende de como a sua CLI está configurada (veja as perguntas frequentes). Para uma verificação diária rápida, a Opção A é mais ágil.
Entenda o resultado da varredura
Quando a varredura termina, você vê um resumo como este:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Portal Scan — 2026-04-13
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Companies scanned: 42
Total jobs found: 318
Filtered by title: 291 removed
Duplicates: 4 skipped
New offers added: 23
New offers:
+ Anthropic | AI Engineer | San Francisco, CA
+ ElevenLabs | Solutions Architect | Remote
...
→ Run /career-ops pipeline to evaluate new offers.Veja o que cada linha significa:
| Linha | O que ela informa |
|---|---|
| Companies scanned | Quantas empresas de tracked_companies foram verificadas |
| Total jobs found | Todas as vagas abertas encontradas nessas empresas, antes de qualquer filtro |
| Filtered by title | Vagas removidas porque o título não correspondeu ao seu title_filter |
| Duplicates skipped | Vagas que já estão no seu pipeline ou tracker e não são adicionadas de novo |
| New offers added | Vagas que passaram por todos os filtros e são novas para você |
Se New offers added for 0, procure primeiro este aviso no resultado da varredura:
⚠️ 1 target(s) returned zero jobs without a successful HTTP response: AcmeEle significa que o portal dessa empresa não chegou a responder com sucesso, então o zero não prova que não há vagas publicadas ali. A empresa é registrada como unverified_zero em data/portal-health.tsv e conta para a sequência de falhas dela. Verifique esse portal antes de mexer nos seus filtros. Um portal lento também pode esgotar o tempo antes de responder: por padrão, o scanner espera 10 segundos por requisição, e com CAREER_OPS_HTTP_TIMEOUT_MS=30000 npm run scan ele espera 30.
Se não houver esse aviso, seu filtro de títulos pode estar rígido demais. Tente adicionar uma palavra-chave à sua lista positive e execute a varredura de novo.
Para onde vão as vagas novas: cada vaga nova é adicionada como uma linha em data/pipeline.md. Essa é a lista de vagas aguardando avaliação.
Para que serve o data/scan-history.tsv: toda URL que o scanner vê, tenha sido adicionada, filtrada ou ignorada, fica registrada ali. É assim que o scanner evita mostrar a mesma vaga duas vezes em varreduras futuras. A exceção é uma vaga removida pela configuração location_filter ou max_posting_age_days do portals.yml. Ela é registrada como skipped_location ou skipped_age e pode voltar a aparecer quando você alterar essa configuração. Você não precisa editar esse arquivo.
Avalie as vagas novas encontradas na varredura
Depois que a varredura adiciona vagas novas a data/pipeline.md, sua lista de vagas pendentes, execute o comando pipeline para avaliar cada uma em relação ao seu perfil. Esta etapa usa o Claude para ler a descrição da vaga, compará-la com o seu cv.md e o seu modes/_profile.md e produzir um resumo com nota para cada vaga.
Abra o Claude Code na pasta do projeto e digite:
/career-ops pipelineO Claude lê todas as URLs pendentes em data/pipeline.md, visita cada vaga e a avalia. Os resultados chegam em lotes. Cada lote mostra uma tabela como esta:
Lote 1 concluído (Anthropic, ElevenLabs, Mistral):
| # | Empresa | Vaga | Nota | Legitimidade |
|---|---|---|---|---|
| 024 | Anthropic | AI Engineer | 4,8/5 | High Confidence |
| 025 | ElevenLabs | Solutions Architect | 4,1/5 | High Confidence — em rápido crescimento |
| 026 | Mistral AI | Product Manager | 3,2/5 | Proceed w/ Caution — vaga encerrada |
Veja o que cada coluna significa:
| Coluna | O que ela informa |
|---|---|
| # | O número do relatório. Use-o para encontrar o relatório completo em reports/. Por exemplo, o relatório 024 é reports/024-anthropic-2026-04-13.md |
| Nota | O quanto a vaga combina com o seu perfil, de 1 a 5 |
| Legitimidade | Se a vaga parece real e ativa. "High Confidence" significa que a vaga está no ar e os detalhes conferem. "Proceed w/ Caution" significa que algo acendeu um alerta: leia a observação ao lado. |
Para ler a avaliação completa de uma vaga, você tem duas opções:
- Abra o arquivo do relatório diretamente: encontre-o na pasta
reports/usando o número da tabela. - Use o dashboard: execute
./dashboard/career-dashboardna pasta do projeto para navegar por todos os seus relatórios em uma interface de terminal. Você pode filtrar por nota e por status e abrir qualquer relatório sem sair do terminal.
Próximos passos
Quando o /career-ops pipeline termina, cada vaga tem uma nota de 1 a 5. Você encontra o relatório completo de qualquer vaga na pasta reports/. A nota mostra o quanto a vaga combina com o seu perfil.
Use a nota como ponto de partida:
| Nota | Ação recomendada |
|---|---|
| 4,5 ou mais | Combina muito com você. Execute /career-ops apply imediatamente. |
| 4,0 – 4,4 | Boa aderência. Execute /career-ops apply. Você também pode executar /career-ops contacto antes, para falar com alguém da equipe antes de se candidatar. |
| 3,5 – 3,9 | Pode ir para qualquer lado. Execute /career-ops deep para saber mais antes de decidir. |
| Abaixo de 3,5 | Deixe passar, a menos que você tenha um motivo específico para se candidatar. |
Veja o que cada comando faz:
/career-ops apply: abre o formulário de candidatura e escreve respostas sob medida para o seu perfil. Ele para antes de enviar, para que você revise tudo primeiro./career-ops contacto: encontra no LinkedIn o gestor da vaga ou alguém da equipe e redige uma mensagem curta de contato para você enviar./career-ops deep: pesquisa a empresa e a vaga a fundo. Use quando você estiver em dúvida e quiser mais informações antes de decidir./career-ops tracker: mostra o status de todas as vagas no seu pipeline. Execute sempre que quiser ver em que pé as coisas estão.
Dica
Você não precisa seguir a ordem. Se uma vaga tirar 4,8, mas você nunca ouviu falar da empresa, execute /career-ops deep primeiro. Os comandos funcionam de forma independente: use o que fizer sentido para a sua situação.
Vale a pena se candidatar a esta vaga?
Decida antes de se candidatar. O career-ops dá a uma vaga uma nota de 1 a 5 com base no seu currículo e nos seus objetivos, mostra o raciocínio e deixa a decisão com você.
Candidatar-se a uma vaga
Use o career-ops para preencher formulários de candidatura com respostas sob medida para o seu perfil e para a vaga que você quer.