API

AI Agents CLISkill ClawHub

CLI de currículo para agentes de IA

Gere, adapte e leia currículos e cartas de apresentação profissionais em PDF pela linha de comando. Feita para agentes de IA como OpenClaw e Claude Code criarem documentos prontos para a candidatura.

ClawHubopenclaw skills install useresume
npmnpm install -g @useresume/cli
🦞
📝
🚀
🎯
💫
useresume — terminal
$ useresume credentials:test
{ "success": true, "data": { "api_credits": 96, "expires_at": null } }
$ useresume resume:create --input resume.json
{ "success": true, "data": { "file_url": "https://..." } }
$ useresume resume:create-tailored --input tailored.json
{ "success": true, "meta": { "credits_used": 5 } }
$ useresume resume:parse --file ./cv.pdf --parse-to json
{ "success": true, "data": { "name": "Jane Doe", ... } }

Comece em segundos

Escolha a instalação que combina com seu fluxo de trabalho: ClawHub para o OpenClaw ou npm para qualquer agente com acesso ao shell.

terminal
# Instale a skill publicada do OpenClaw
$ openclaw skills install useresume
# Ou instale a CLI diretamente
$ npm install -g @useresume/cli
# Defina sua chave de API
$ export USERESUME_API_KEY=ur_your_key_here
# Verifique suas credenciais
$ useresume credentials:test
{ "success": true, "data": { "api_credits": 30, "expires_at": null } }
# Gere seu primeiro currículo
$ useresume resume:create --input resume.json
{ "success": true, "data": { "file_url": "https://..." }, "meta": { "credits_used": 1 } }

Feita para automação

Cada decisão de design prioriza a leitura por máquinas. Entra JSON, sai JSON, e códigos de saída diferentes de zero em caso de falha.

Pronta para agentes de IA

Cada comando devolve JSON estruturado no stdout. Os agentes leem a resposta diretamente: sem scraping, sem regex, sem surpresas.

Entrada e saída em JSON

Entrada por arquivos JSON, saída em JSON no stdout. Erros, sucesso e metadados seguem o mesmo contrato, com que os agentes podem contar.

Currículo + carta

Gere currículos, cartas de apresentação e versões adaptadas de ambos. Converta documentos existentes em dados estruturados ou markdown.

29 modelos, 32 cores

Escolha entre 29 modelos de currículo, 11 modelos de carta de apresentação, 32 cores de destaque, 9 fontes e 16 cores de fundo.

Vários idiomas

Gere documentos em 9 idiomas: inglês, espanhol, francês, alemão, italiano, português, holandês, polonês e lituano.

PDF em segundos

Os currículos ficam prontos em 1 a 2 segundos. As versões adaptadas usam IA para otimizar o conteúdo para uma vaga específica.

Referência de comandos

Oito comandos cobrem todo o ciclo do documento: criar, adaptar, ler e acompanhar.

ComandoCréditos
resume:create1
resume:create-tailored5
resume:parse4
cover-letter:create1
cover-letter:create-tailored5
cover-letter:parse4
run:get0
credentials:test0

Como os agentes usam

Um fluxo completo típico: encontrar a vaga, montar o currículo, adaptá-lo com IA, baixar o PDF e se candidatar.

1

Encontre a vaga e copie a descrição

O agente encontra uma vaga à qual o candidato quer se candidatar e extrai o texto da descrição da vaga.

# O agente coleta ou recebe o anúncio da vaga
{ "title": "Senior Engineer", "company": "Acme", "description": "We are looking for..." }
2

Monte o JSON do currículo

Organize a experiência, as competências e a formação do candidato no esquema JSON da UseResume, ou converta um PDF existente.

$ useresume resume:parse --file ./cv.pdf --parse-to json
{ "success": true, "data": { "name": "Jane Doe", "experience": [...] } }
3

Adapte à descrição da vaga

Envie os dados do currículo e a descrição da vaga para a IA. Ela reescreve os tópicos, reordena as competências e otimiza para ATS.

$ useresume resume:create-tailored --input tailored.json
{ "success": true, "data": { "file_url": "https://cdn..." } }
4

Baixe o PDF e candidate-se

Pegue o PDF na URL retornada e envie a candidatura. O agente também pode gerar uma carta de apresentação no mesmo fluxo.

# Baixe o currículo adaptado
$ curl -o resume.pdf "$FILE_URL"
# Opcional: gere também uma carta de apresentação
$ useresume cover-letter:create-tailored --input cl.json

Feita para o OpenClaw

A skill publicada no ClawHub dá ao OpenClaw o caminho de instalação, os requisitos de execução e o contrato de comandos de que ele precisa para usar a UseResume com segurança.

Descoberta pela skill

Depois que a skill é instalada, o OpenClaw lê os metadados doSKILL.mdincluído, verifica as variáveis de ambiente e o binário necessários e carrega os fluxos recomendados para gerar, adaptar e ler currículos e consultar execuções.

  • Publicada no ClawHub como a skill useresume
  • Instale com openclaw skills install useresume
  • O SKILL.md declara USERESUME_API_KEY e o binário useresume
  • Os metadados de instalação apontam para @useresume/cli no npm
  • Todos os comandos devolvem JSON no stdout, com saída diferente de zero em caso de falha
  • Funciona melhor no OpenClaw, mas roda em qualquer lugar com comandos de shell + JSON
SKILL.md
---
name: useresume
description: Generate professional PDF resumes...
metadata: {"openclaw":{"requires":{"env":
["USERESUME_API_KEY"],"bins":
["useresume"]},...}}
---
# Install rules, commands,
# schemas, workflows...

Perguntas frequentes

Respostas rápidas para desenvolvedores e criadores de agentes que integram a CLI da UseResume.

O que é a CLI da UseResume?

A CLI da UseResume (@useresume/cli) é uma ferramenta de linha de comando que usa a API da UseResume. Com ela, agentes de IA como OpenClaw, Claude Code e scripts de automação próprios geram, adaptam e leem currículos e cartas de apresentação profissionais em PDF, sempre com saída em JSON estruturado.

Como os agentes do OpenClaw encontram esta skill?

Instale a skill publicada com openclaw skills install useresume. Depois disso, o OpenClaw lê o SKILL.md incluído para entender os comandos, as variáveis de ambiente necessárias e os fluxos recomendados.

A CLI funciona com o Claude Code e outros agentes?

Sim. Qualquer agente de programação ou ambiente de automação que execute comandos de shell e leia JSON pode usar a CLI. O OpenClaw tem a instalação mais simples, pela skill publicada, mas o pacote npm funciona em qualquer lugar com acesso ao shell.

Quanto custa?

Você ganha 30 créditos de API grátis ao criar sua conta. Criar um currículo ou uma carta de apresentação custa 1 crédito, adaptar custa 5 créditos e ler um documento custa 4 créditos. Consultar o status de uma execução e testar as credenciais é grátis.

Quais modelos e estilos estão disponíveis?

29 modelos de currículo, 11 modelos de carta de apresentação, 32 cores de destaque, 9 fontes, 16 cores de fundo e 9 idiomas de documento. Tudo configurável no arquivo JSON de entrada.

Posso ler um currículo existente e adaptá-lo?

Sim. Use resume:parse para extrair dados estruturados de um PDF existente e depois envie esses dados com a descrição da vaga para resume:create-tailored. Esse é o fluxo mais comum entre os agentes.

Instale a skill e deixe seu agente fazer o trabalho.

Obtenha uma chave de API, instale useresume pelo ClawHub ou npm e deixe a criação, a adaptação e a análise de currículos com seu fluxo do OpenClaw.