Varredura de portais de vagas

Este guia mostra como configurar o portals.yml e executar o scanner de portais para encontrar novas vagas automaticamente.

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.yml

Abra o portals.yml em qualquer editor de texto. O arquivo tem três seções. Os passos abaixo explicam cada uma delas.

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"

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: true

Para adicionar uma empresa, copie uma entrada existente e altere os valores:

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: false

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: true

Para 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.

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 scan

Execute 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-run

O 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 Anthropic

Substitua Anthropic por qualquer nome de empresa da sua lista tracked_companies. A correspondência não diferencia maiúsculas de minúsculas.

Opção B — Execute a varredura com IA dentro do Claude Code

Abra o Claude Code na pasta do projeto e digite:

/career-ops scan

Esta 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

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:

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: Acme

Ele 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.

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 pipeline

O 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):

Veja o que cada coluna significa:

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-dashboard na 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:

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.