内容
# 数据宝
[](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)** — 实时平台 · [API 参考](https://databolsa.com/docs)
DataBolsa API 的开源 TypeScript SDK、CLI 和 Model Context Protocol 服务器 — 提供巴西金融市场数据(股票、房地产投资基金、BDRs、国债、指数和宏观经济指标),每个响应中包含来源和参考日期。
在 **Apache-2.0** 下许可。
## 软件包
| 软件包 | 描述 |
| --- | --- |
| `packages/sdk` | 类型化的 TypeScript 客户端(原生 fetch);从 OpenAPI 合同生成的类型。 |
| `packages/cli` | API 的命令行界面 — 每个操作对应一个子命令。 |
| `packages/mcp` | Model Context Protocol 服务器,负责向代理暴露数据。 |
API 的 OpenAPI 合同位于 [`api/openapi.yaml`](api/openapi.yaml)。
## 快速开始
```bash
npm i @databolsa/sdk
# 或:npx -y @databolsa/cli --help
# 或:npx -y @databolsa/mcp (MCP 配置参见 databolsa.com/开发者)
```
在 [databolsa.com](https://databolsa.com) 上可获得免费的 API 密钥。
全部类型检查:`bun run typecheck`.
## 贡献
参见 [CONTRIBUTING.md](./CONTRIBUTING.md)。欢迎提交 issues 和 pull requests。