databolsa

# DataBolsa [](https://github.com/databolsahq/databolsa/actions/workflows/ci.yml) [](https://github.com/databolsahq/databolsa/releases) [](LICENSE) [](https://www.npmjs.com/package/@databolsa/sdk) [](https://www.npmjs.com/package/@databolsa/cli) [](https://www.npmjs.com/package/@databolsa/mcp) 🌐 **[databolsa.com](https://databolsa.com)** — a plataforma ao vivo · [referência da API](https://databolsa.com/docs) SDK TypeScript, CLI e servidor Model Context Protocol open source para a API do DataBolsa — dados do mercado financeiro brasileiro (ações, FIIs, BDRs, Tesouro Direto, índices e indicadores macroeconômicos), com a fonte e a data de referência em cada resposta. Licenciado sob **Apache-2.0**. ## Pacotes | Pacote | O que é | | --- | --- | | `packages/sdk` | Cliente TypeScript tipado (fetch nativo); tipos gerados do contrato OpenAPI. | | `packages/cli` | CLI sobre a API — um subcomando por operação do contrato. | | `packages/mcp` | Servidor Model Context Protocol que expõe os dados como ferramentas para agentes. | O contrato OpenAPI da API fica em [`api/openapi.yaml`](api/openapi.yaml). ## Início rápido ```bash npm i @databolsa/sdk # ou: npx -y @databolsa/cli --help # ou: npx -y @databolsa/mcp (config de MCP em databolsa.com/desenvolvedores) ``` Uma API key gratuita fica disponível em [databolsa.com](https://databolsa.com). Checagem de tipos de tudo: `bun run typecheck`. ## Contribuindo Veja o [CONTRIBUTING.md](./CONTRIBUTING.md). Issues e pull requests são bem-vindos.