Indeed Skills

indeed-skills: Habilidades da API de vagas do Indeed para agentes de IA

Habilidades de agente para dados ao vivo de vagas do Indeed. Três habilidades plug-and-play que dão a Claude, ChatGPT, Cursor ou qualquer loop de agente personalizado uma API de vagas: pesquise anúncios do Indeed por palavra-chave e localização, obtenha detalhes normalizados de cargos e consulte salários, descrições, informações da empresa e benefícios pela API REST RolesAPI. Se você procura uma alternativa de API do Indeed ou de dados do Indeed que retorne JSON limpo, esta é a forma mais rápida de conectar dados de vagas a um agente de IA.

Comece gratuitamente. Obtenha uma chave (100 créditos no cadastro, sem cartão de crédito) e você estará pesquisando vagas ao vivo pelo seu agente em menos de dois minutos.

Biblioteca padrão Python pura. Sem dependências. Licença MIT-0.

Instalação

# OpenClaw (via ClawHub)
npx clawhub@latest install indeed-full

# Hermes Agent
hermes skills install skills-sh/nikhonit/indeed-skills/skills/indeed-full

# Generic agent skills (Claude Code, Cursor, Cline)
npx skills add nikhonit/indeed-skills

Troque indeed-full por indeed-search ou indeed-salary para instalar uma variante focada.

Habilidades neste repositório

Habilidade	O que faz	Custo em créditos
indeed-full	Kit completo: pesquisa de anúncios, detalhes completos do cargo por chave de vaga ou URL colada, faixas de salário, descrição, empresa e benefícios, verificação de conta	1 crédito por chamada
indeed-search	Pesquisa leve: anúncios por palavra-chave e localização, além de predefinições para publicados hoje, esta semana e somente remoto	1 crédito por página de resultados
indeed-salary	Consultas somente de salário por chave de vaga ou URL do Indeed colada	1 crédito por consulta

Instale indeed-full para agentes que precisam de ampla cobertura. Instale as variantes focadas quando quiser uma superfície mínima de ferramentas.

Início rápido

1. Cadastre-se em rolesapi.com e crie uma chave em rolesapi.com/app/keys. O plano gratuito inclui 100 créditos, sem cartão de crédito.
2. Exporte a chave e execute um script:

export ROLESAPI_KEY="rk_live_..."
python3 skills/indeed-search/scripts/search_listings.py "registered nurse" "Chicago, IL"

Saída real, reduzida a um dos 35 resultados:

{
  "data": [
    {
      "job_key": "7dcf172c8d7fc756",
      "title": "Nursing",
      "company": { "name": "Golden Healthcare Services Inc" },
      "location": "Olympia Fields, IL 60461",
      "employment_type": "Full-time",
      "salary": { "min": 30, "max": 45, "period": "hour", "currency": "USD", "source": "employer" },
      "posted_at": "2026-06-26",
      "url": "https://www.indeed.com/viewjob?jk=7dcf172c8d7fc756"
    }
  ],
  "meta": { "count": 35 },
  "request_id": "a18e4ef88ad4b00b"
}

Alimente qualquer job_key nos scripts de detalhes:

python3 skills/indeed-full/scripts/get_role.py 7dcf172c8d7fc756
python3 skills/indeed-salary/scripts/get_salary.py 7dcf172c8d7fc756

Passo a passo completo: início rápido do rolesapi.com.

Funciona com

• Claude Code / Claude Skills: coloque uma pasta de habilidade no diretório de habilidades e o Claude a detecta pelo SKILL.md.
• ChatGPT e GPTs personalizados: chame os scripts a partir de um interpretador de código ou envolva-os como ações.
• Cursor, Cline e outros agentes de codificação: os scripts são ferramentas CLI simples, então qualquer agente que execute Python pode usá-los.
• Qualquer loop de agente: cada script é uma CLI independente, sem stdin, que imprime JSON, fácil de chamar a partir de Node, Go ou Rust.
• Opção sem instalação: a RolesAPI oferece um servidor MCP hospedado em https://api.rolesapi.com/mcp. Aponte seu cliente MCP para ele e ignore os scripts completamente.

Também há um llms.txt (e llms-full.txt) se você quiser entregar toda a superfície da API a um modelo.

O que você recebe

Objetos de cargo normalizados em mais de 60 edições nacionais do Indeed: título, empresa com avaliação, localização, tipo de emprego, salário (mínimo, máximo, moeda, período, informado pelo empregador vs. estimativa), benefícios, descrição completa, data de publicação e URL canônica. Cada resposta é um envelope de { "data": ..., "request_id": "..." }. Consulte a documentação da API de cargos, a documentação da API de pesquisa, a documentação da API de anúncios e a especificação OpenAPI.

Para trabalho em volume, a API também oferece pesquisa assíncrona e enriquecimento em lote de até 500 anúncios por vaga, com eventos de conclusão entregues via webhooks assinados.

Autenticação

Defina a variável de ambiente ROLESAPI_KEY com sua chave da RolesAPI (formato rk_live_...).

export ROLESAPI_KEY="rk_live_..."

Obtenha uma chave gratuita: 100 créditos no cadastro, sem cartão de crédito. A mesma chave funciona para estas habilidades, o servidor MCP hospedado e chamadas REST diretas.

Preços

Plano	Preço	Créditos	Limite de taxa
Gratuito	$0	100 (uma vez no cadastro)	20/min
Mensal	$5/mês	1.000/mês	200/min
Anual	$54/ano	12.000 antecipados	300/min

Um crédito equivale a um detalhe de cargo ou uma página de resultados de pesquisa. Chamadas com falha não são cobradas. Preços completos: rolesapi.com/pricing.

Perguntas frequentes

Como obtenho vagas do Indeed em JSON? Cadastre-se em rolesapi.com, exporte ROLESAPI_KEY e chame GET /v1/listings?keyword=...&location=... (ou execute search_listings.py deste repositório). Você recebe resumos JSON normalizados de cargos com chaves de vaga para chamadas de detalhes posteriores.

Existe uma API gratuita de vagas do Indeed? O plano gratuito da RolesAPI inclui 100 créditos no cadastro, sem cartão de crédito, suficientes para 100 pesquisas ou consultas de cargos. Planos pagos começam em $5/mês por 1.000 créditos.

Quanto custa? 1 crédito por detalhe de cargo ou página de resultados de pesquisa. $5/mês por 1.000 créditos, ou $54/ano por 12.000. Chamadas com falha não são cobradas.

Funciona fora dos Estados Unidos? Sim. Passe --country (por exemplo, gb, de, in) para pesquisar qualquer uma das mais de 60 edições nacionais do Indeed.

Posso obter o salário de um anúncio específico do Indeed? Sim. GET /v1/roles/{job_key}/salary retorna mínimo, máximo, moeda, período e se o valor veio do empregador ou de uma estimativa. A habilidade indeed-salary encapsula exatamente isso e também aceita uma URL do Indeed colada.

Meu agente pode usar isso sem instalar nada? Sim. Aponte um cliente MCP para o servidor hospedado, https://api.rolesapi.com/mcp, e as mesmas ferramentas de pesquisa e cargos estarão disponíveis sem instalação.

Esta é uma API oficial do Indeed? Não. A RolesAPI é um produto independente. Consulte o aviso legal abaixo.

Problemas e contribuições

Consulte CONTRIBUTING.md. Relatórios de segurança: SECURITY.md.

Licença

MIT Sem Atribuição. Faça fork, publique, sublicencie. Sem necessidade de atribuição.

Aviso legal

A RolesAPI é um produto independente e não é afiliada, endossada ou patrocinada pelo Indeed. Indeed é uma marca registrada de seu proprietário.