CLI

@databolsa/advisor-cli — a API do escritório no terminal, um comando por operação.

npm install -g @databolsa/advisor-cli
# ou sem instalar:
npx -y @databolsa/advisor-cli advisorGetMe

Configure a credencial (chave de organização criada no portal, em Config):

export DATABOLSA_ADVISOR_API_KEY=db_org_SUACHAVE
# opcional: DATABOLSA_ADVISOR_API_URL (default https://api.databolsa.com)

A chave pessoal do produto B2C não autentica aqui: ela pertence a outro realm de identidade. A CLI age sempre como a organização dona da chave.

Uso

Um comando por operação do contrato do Advisor — mesmos nomes da referência. A organização (slug ou id) é o primeiro argumento de tudo, menos das operações de conta:

databolsa-advisor --list                                   # todos os comandos
databolsa-advisor advisorGetMe                             # quem sou e onde posso agir
databolsa-advisor advisorGetOverview meu-escritorio        # panorama do escritório
databolsa-advisor advisorListClients meu-escritorio
databolsa-advisor advisorGetClient meu-escritorio <clientId>
databolsa-advisor advisorGetClientPortfolio meu-escritorio <portfolioId> --json | jq .totals
databolsa-advisor advisorListAuditLog meu-escritorio --limit 50

Escritas viram comandos do mesmo jeito — e mexem no dado real do escritório, com registro na trilha de auditoria:

databolsa-advisor advisorCreateClient meu-escritorio --name "Maria Souza" --email [email protected]
databolsa-advisor advisorCreateInvitation meu-escritorio --email [email protected] --role advisor
databolsa-advisor advisorImportClientPortfolioFile meu-escritorio <portfolioId> --file negociacao-2026.xlsx

Em uploads, --file <caminho> lê o arquivo local e preenche content_base64/filename por você.

Para agentes de código

A skill pública databolsa-advisor-cli ensina Claude Code e outros agentes a descobrir os comandos pelo contrato, tratar 404 como escopo (não como inexistência) e confirmar antes de escrever:

npx skills add databolsahq/databolsa --skill databolsa-advisor-cli --agent claude-code

Flags globais

Flag	O que faz
`--json`	saída JSON crua (sem formatação)
`--api-url <url>`	aponta para outro ambiente
`--list`	lista as operações do contrato vivo
`--help`, `--version`	o de sempre

Códigos de saída: 0 ok · 1 erro da API · 2 uso incorreto · 3 rede.

Código aberto: packages/advisor-cli.

Uso

Para agentes de código

Flags globais

On this page