Bolsai

Bolsai - MCP 服务

为 AI 助手提供巴西金融市场数据。直接从巴西市场（B3、CVM、BCB）查询股票价格、基本面、股息、FII 和宏观指标。

快速开始

1. 在 usebolsai.com 获取免费 API 密钥

2. 安装：

pip install bolsai-mcp

3. 添加到 Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "bolsai": {
      "command": "uvx",
      "args": ["bolsai-mcp"],
      "env": {
        "BOLSAI_API_KEY": "sk_your_key_here"
      }
    }
  }
}

或用于 Claude Code（.mcp.json）：

{
  "mcpServers": {
    "bolsai": {
      "command": "bolsai-mcp",
      "env": {
        "BOLSAI_API_KEY": "sk_your_key_here"
      }
    }
  }
}

工具

工具	描述	示例提示词
get_stock_quote	当前价格、日涨跌幅、52 周区间	“PETR4 的交易价格是多少？”
get_fundamentals	27+ 项指标：P/L、P/VP、ROE、利润率	“显示 VALE3 的基本面”
compare_stocks	并排比较最多 5 只股票	“比较 PETR4、VALE3 和 ITUB4”
get_dividends	股息收益率、年度摘要、派息	“BBDC4 派发了哪些股息？”
search_companies	按名称或行业查找公司	“查找在 B3 上市的银行”
get_price_history	自 1986 年以来的 OHLCV 价格，含调整数据	“PETR4 上个月的价格”
get_fii_details	FII 基本面和分配情况	“显示 HGLG11”
get_macro_indicator	SELIC、IPCA、CDI、USD/BRL	“当前 SELIC 利率是多少？”
get_financial_statements	原始 CVM 损益表、资产负债表和现金流量表	“PETR4 2024 年损益表”
screen_stocks	按指标筛选股票	“查找 DY > 8% 的股票”

对话示例

“PETR4 的交易价格是多少？”

PETR4
Price: R$ 36.19
Change: +R$ 0.53 (+1.49%)
Date: 2024-12-30
52-week: R$ 28.44 – R$ 42.15
YTD: +12.34%

“比较 PETR4 和 VALE3”

Comparison: PETR4 vs VALE3

Metric              PETR4       VALE3
─────────────────────────────────────
P/L                  4.89        5.23
P/VP                 1.12        1.45
EV/EBITDA            3.21        3.87
ROE                33.20%      27.70%
Net Margin         24.50%      23.10%
DY                 12.30%       9.90%
Price           R$ 36.19    R$ 58.42

数据覆盖范围

• 350+ 只股票 在 B3 上市
• 400+ 只 FII（房地产投资基金）
• 40 年价格历史（自 1986 年起）
• 15+ 年基本面数据（自 2010 年起）
• 27 项指标，包括 P/L、P/VP、EV/EBITDA、ROE、ROIC、利润率
• 宏观数据：SELIC、IPCA、CDI、USD/BRL
• 每日更新，数据来自官方来源（B3、CVM、BCB）

配置

环境变量	必填	默认值	描述
BOLSAI_API_KEY	是	—	来自 usebolsai.com 的 API 密钥
BOLSAI_BASE_URL	否	https://usebolsai.com/api/v1	API 基础 URL

API 层级

• 免费版：每天 200 次请求。股票报价、当前基本面、公司搜索。
• Pro（R$ 49/月）：每天 10,000 次请求。包含所有工具，包括历史数据、股息、财务数据和宏观数据。

开发

cd mcp-server
pip install -e ".[dev]"
pytest
ruff check . && ruff format .

许可证

MIT