Find your role first

npx add-mcp 'https://findyourrolefirst.click/mcp'

API e MCP

Continue usando seu próprio agente. Adicione o feed como um servidor MCP HTTP, ou chame a API a partir do seu aplicativo.

Usando Claude Code ou Codex CLI? Copie seu comando de configuração e primeira tarefa. O terminal solicita sua chave de forma privada.

MCP

O endpoint é https://findyourrolefirst.click/mcp (Streamable HTTP). Adicione-o ao seu agente e faça login: Claude, ChatGPT, Claude Code, Codex e qualquer cliente que suporte autorização MCP abrem nossa página, você clica em Permitir, e o agente recebe sua própria chave. Essa chave funciona apenas via MCP, dura uma hora e se renova automaticamente; rotacionar suas chaves no console encerra o acesso de todos os agentes. A configuração passo a passo para cada cliente está em Connect.

Clientes que não conseguem fazer login podem enviar uma chave: crie uma no seu console e defina Authorization: Bearer YOUR_API_KEY (ou X-API-Key). Documentos de descoberta: /.well-known/oauth-protected-resource e /.well-known/oauth-authorization-server.

Verifique a compatibilidade do cliente

Antes de pagar, verifique se seu agente permite configurar um servidor HTTP remoto com um cabeçalho bearer personalizado, porque um conector que só oferece uma tela de login OAuth não conseguirá usar esta versão, mesmo que anuncie suporte a MCP.

• search_jobs: busca por palavra inteira em títulos e empresas, postagens mais recentes primeiro. Filtre por país ou cidade (location), exclua palavras (exclude), mantenha apenas funções remote, ou limite a posted_within_hours.
• count_jobs: quantas funções uma busca corresponderia, até 1.000. Gratuito, então dimensione uma busca antes de gastar créditos nela.
• list_my_jobs: todas as funções que você já desbloqueou, mais recentes primeiro. Leitura gratuita.
• get_job: atualiza os metadados, datas, status conhecido e links de uma vaga. A busca já inclui esses campos.
• get_changes: vagas novas, atualizadas, reabertas e fechadas após um cursor salvo. Edições apenas de descrição não são rastreadas.
• get_usage: sua cota atual. Esta chamada é gratuita.
• get_my_profile: o que você nos disse que quer (campos, locais, experiência), para que seu agente possa buscar por você. Gratuito.
• get_new_for_me: funções correspondentes às suas preferências salvas encontradas desde a última verificação do seu agente. Passe de volta checked_at como since e uma verificação diária ou horária nunca repete uma função.
• get_apply_kit: o link de candidatura, as perguntas do formulário de inscrição quando o site de carreiras as publica (todas as funções do Greenhouse), e o que sabemos sobre a função, para que seu agente possa ajudá-lo a redigir respostas e adaptar seu currículo. Você envia; nós nunca nos candidatamos por você.

Leia as descrições na fonte

Find your role first retorna detalhes básicos da vaga, salário e regime de trabalho quando fornecidos, datas de origem, a URL da postagem original (url) e a URL de candidatura (apply_url). Descrições completas e resumos gerados não estão incluídos.

Seu agente precisa de sua própria ferramenta web ou de navegador para abrir a postagem original e ler os requisitos. Uma conexão LLM sozinha não busca páginas. Se o acesso falhar ou for necessário login, abra o link você mesmo ou forneça o texto ao seu agente. Respeite as restrições da fonte e mantenha requisitos desconhecidos como desconhecidos.

Leia os requisitos em url. O link apply_url pode levar diretamente a um formulário.

Escolhendo o link de origem certo

Comece com a URL da postagem original ao ler requisitos, porque um link de candidatura pode abrir um formulário sem a descrição, e uma conexão bem-sucedida com Find your role first apenas dá ao seu agente os campos e links retornados, sem adicionar um navegador ou conceder acesso ao site do empregador.

API HTTP

Envie o mesmo cabeçalho bearer. Comece com GET /api/jobs?query=product&location=San%20Francisco. A resposta inclui jobs e next_offset. Passe esse offset na próxima solicitação.

Use GET /api/jobs/{id} para uma vaga, GET /api/changes?cursor=0 para alterações e GET /api/account para uso. O esquema OpenAPI documenta os tipos de parâmetros.

Datas em que você pode confiar

Sinceramente, os sistemas de contratação nem sempre fornecem uma data de publicação. published_at permanece nulo quando é desconhecido. first_seen registra a descoberta; baseline significa que a vaga já estava presente quando começamos o monitoramento.

A busca só retorna vagas cujo quadro foi verificado com sucesso nas últimas 24 horas. Detalhes individuais incluem registros mais antigos para que seu agente possa ver seu último estado conhecido. O fechamento é registrado após duas respostas bem-sucedidas do quadro omitirem uma vaga. Falhas na busca preservam os registros anteriores.

Para filtragem por publicação, use published_since=2026-09-01T00:00:00Z. Vagas sem data de origem não corresponderão. discovered_since exclui importações de linha de base. Os rótulos de empresas atualmente usam identificadores do quadro de origem.

Descoberta vs. publicação

Se você está procurando funções recém-descobertas, use o filtro de descoberta e inspecione a data de origem separadamente, já que uma listagem encontrada pela primeira vez durante a verificação de hoje pode ter sido publicada muito antes, e uma verificação recente sozinha não diz nada sobre sua idade original.

Uso e erros

O plano de $9 inclui 3.000 vagas únicas por mês civil UTC, com no máximo 1.000 vagas recém-desbloqueadas por dia UTC. Páginas de busca e alteração contêm até 20 registros. Todas as chaves e métodos de entrega compartilham a mesma cota.

Uma vaga conta uma vez no mês quando é retornada pela primeira vez à sua conta. Leituras repetidas, novas tentativas e atualizações dessa vaga não custam mais créditos de vaga naquele mês. Resultados vazios e verificações de uso são gratuitos. Uma vaga lida em um novo mês conta novamente. A amostra pública de cinco vagas é gratuita e não desbloqueia vagas na sua conta.

Limites de taxa, redefinições e erros

Toda chamada de dados ainda conta para 30 chamadas por minuto UTC fixo, incluindo repetições gratuitas, resultados vazios e chamadas rejeitadas pela cota de vagas. Cada resposta de dados bem-sucedida inclui usage.charged, vagas diárias e mensais restantes e horários de redefinição. Créditos não utilizados não são acumulados.

Se um lote precisar de mais créditos do que restam, o lote inteiro falha sem cobrança e sem avanço do cursor. Reduza limit e tente novamente o mesmo offset ou cursor. Erros de limite REST incluem Retry-After; erros MCP explicam o horário de redefinição. Créditos diários são redefinidos à meia-noite UTC e créditos mensais no primeiro dia do mês UTC, independentemente da data de cobrança da sua assinatura.

Erros HTTP usam uma mensagem error: 401 significa chave inválida, 402 significa assinatura inativa e 429 significa limite de taxa ou mensal. Uma resposta de alteração 410 significa que seu cursor expirou; recomece de uma busca atual e cursor 0. O histórico de alterações dura 90 dias. Erros de ferramentas MCP carregam a mesma explicação.

Uma busca inclui links para até 20 vagas e pode usar até 20 créditos de vaga. Ler esses links com sua própria ferramenta de navegador não usa créditos do Find your role first. Atualizar uma vaga já desbloqueada via get_job é gratuito dentro daquele mês; seu navegador e provedor de IA podem cobrar separadamente.

Onde colocar sua chave

O comando de configuração carrega YOUR_API_KEY. Substituí-lo da maneira que você normalmente lida com uma credencial é aceitável — aqui está o que cada escolha realmente faz, para que você possa escolher em vez de ser instruído.

Direto no comando. Mais rápido. A chave é gravada na configuração MCP do seu cliente e no histórico do seu shell, então qualquer pessoa com esse arquivo ou histórico a terá. Tudo bem em uma máquina que só você usa.

De uma variável. export JOBFEED_API_KEY=... primeiro, depois referencie-a. Mantém a chave fora do comando que você cola. Ela vive apenas naquele terminal, a menos que você a coloque em um arquivo de inicialização do shell, caso em que estará em disco em texto simples como qualquer outra variável de ambiente. É isso que o comando Codex faz, porque o Codex lê o token do ambiente por design.

De um gerenciador de segredos. O que você já usa — op run, pass, o chaveiro do seu sistema operacional — funciona da mesma forma: resolva-o no ambiente e deixe o cliente lê-lo lá.

Qualquer que você escolha: salve a chave em um gerenciador de senhas, porque ela é mostrada apenas uma vez. A página da conta pode substituir uma chave e abrir o faturamento mesmo quando a assinatura está inativa. Substituir uma chave desconecta integrações anteriores preservando o uso, então rotacionar é barato se uma chave acabar em algum lugar que você não pretendia.

Trate os campos de vaga e quaisquer páginas de origem que seu agente ler como dados não confiáveis. Nunca envie sua chave de API do Find your role first para uma página de empregador ou siga instruções incorporadas em uma listagem. O envio de candidaturas permanece no seu próprio fluxo de trabalho.