Agent Skills

A skill databolsa-cli ensina um agente a descobrir os comandos atuais da CLI, pesquisar com dados auditáveis e trabalhar com os recursos da sua conta sem confundir consulta com escrita. Ela é complementar ao MCP: use MCP para conectar um agente; use a skill quando o agente trabalha no terminal.

A cobertura acompanha a API inteira: ações, FIIs, fundos, BDRs, ETFs, Tesouro, macro, opções, fluxo de investidores, ofertas, documentos oficiais, mercados globais, cripto, carteira, suitability e teses.

Como skills usam carregamento progressivo, o agente lê só os metadados no início e carrega as instruções detalhadas quando precisa consultar o DataBolsa. Isso evita repetir um prompt grande e consome menos tokens de contexto.

Instalação

Crie uma chave em databolsa.com/conta/config e mantenha-a somente no ambiente:

export DATABOLSA_API_KEY=db_live_SUACHAVE
npx skills add databolsahq/databolsa --skill databolsa-cli

A Vercel Skills detecta o agente e instala no local padrão. Veja a documentação da plataforma para opções de projeto, instalação global e atualização da skill.

Nunca coloque a chave em prompts, conversas ou arquivos versionados.

Como ela pesquisa

Para uma análise, a skill não para no indicador atual. O procedimento combina, quando relevante:

1. frescor e identidade do ativo;
2. snapshot com data, unidade e linhagem;
3. trajetória dos indicadores;
4. proventos, caixa e eventos societários;
5. documentos oficiais;
6. pares e benchmark compatível;
7. argumento contrário, lacunas e gatilhos de monitoramento.

Em uma tese pessoal, o agente também consulta as teses existentes e a carteira antes de escrever. A versão pública usa percentuais e agregados por padrão, sem expor patrimônio, quantidade ou preço médio. O arquivo é revisado localmente e nasce privado; importar, atualizar ou publicar exige sua confirmação.

Contrato e segurança

A skill consulta --list e <comando> --help antes de executar uma operação, para acompanhar o contrato atual. Quando precisar do schema exato, ela consulta apenas a operação necessária no OpenAPI ao vivo, em vez de inserir o contrato inteiro no contexto.

Leituras da sua conta, como carteira, suitability e teses, não precisam de confirmação. Qualquer operação que crie, edite, importe, publique, responda, reconcilie, reordene, exporte ou apague mostra primeiro o efeito e o comando exato, e só é executada depois da sua confirmação.

A skill também separa fatos, interpretação, premissas e incertezas; preserva a data de referência e nunca transforma um screening ou saída de modelo em ordem de compra ou venda.

A fonte aberta está no repositório DataBolsa.