volumeleaders.com的Python客户端和MCP服务器
非官方。 本项目不隶属于、认可或与 volumeladers.com 无论如何。
Python客户端和 MCP服务器 为了 volumeladers.com 机构大宗交易数据。
将其用作 Python库 使用类型化Pydantic模型查询机构大宗交易、交易集群、交易水平等。或者将其作为 MCP服务器 让AI编码助手直接访问相同的数据。
身份验证通过从浏览器会话中提取cookie来工作（不需要API密钥）。
先决条件
在使用客户端之前，您必须在Firefox中登录volumeleaders.com。库读取您的浏览器Cookie进行身份验证（没有程序化登录）。
安装
pip install volumeleaders或与 紫外线:
uv add volumeleaders用法
from volumeleaders import VolumeLeadersClient, get_trades, get_exhaustion_scores
with VolumeLeadersClient() as client:
# Fetch institutional trades for a date range
trades = get_trades(
client,
start_date="2026-03-01",
end_date="2026-03-31",
tickers="AAPL",
)
for trade in trades:
print(f"{trade.ticker} {trade.trade} @ {trade.current}")
# Get exhaustion scores for today
scores = get_exhaustion_scores(client)
print(scores)可用端点
| 功能 | 说明 |
|---|---|
get_trades | 使用全套过滤器的机构大宗交易 |
get_trade_clusters | 集群贸易活动 |
get_trade_cluster_bombs | 大型集群事件 |
get_exhaustion_scores | 每日疲劳评分排名 |
get_earnings | 收益数据 |
get_company | 公司元数据 |
get_snapshot | 股票行情的图表快照 |
get_all_snapshots | 所有股票的价格快照 |
get_price_data | 价格/交易量条数据 |
get_chart_levels | 图表交易水平 |
get_trade_levels | 贸易水平数据 |
get_trade_level_touches | 交易层面的接触事件 |
get_institutional_volume | 机构数量 |
get_ah_institutional_volume | 下班后机构交易量 |
get_total_volume | 总体积 |
get_trade_alerts | 交易警报 |
get_trade_cluster_alerts | 贸易集群警报 |
get_alert_configs | 警报配置 |
get_watchlist_configs | 监视列表配置 |
get_watchlist_tickers | 观察名单中的票务 |
所有端点函数都接受 VolumeLeadersClient 作为第一个参数和返回类型的Pydantic模型。
MCP服务器
图书馆包括 主控程序 该服务器将VolumeLeaders数据作为AI编码助手的工具公开。有五种工具可供选择： trades, trade_clusters, trade_cluster_bombs, trade_levels，以及 trade_level_touches.
uv快速入门
无需安装：
uv run --with "volumeleaders[mcp]" volumeleaders-mcp或者，如果软件包已安装：
volumeleaders-mcp客户端配置
Claude Code (.mcp.json)
创建 .mcp.json 在您的项目根目录中。
使用紫外线：
{
"mcpServers": {
"volumeleaders": {
"type": "stdio",
"command": "uv",
"args": ["run", "--with", "volumeleaders[mcp]", "volumeleaders-mcp"]
}
}
}添加配置后，重新启动Claude Code并运行 /mcp 验证服务器是否出现。
OpenCode (opencode.json)
添加 opencode.json （或 opencode.jsonc)在您的项目根目录中。
使用紫外线：
{
"mcp": {
"volumeleaders": {
"type": "local",
"command": ["uv", "run", "--with", "volumeleaders[mcp]", "volumeleaders-mcp"]
}
}
}许可证
麻省理工学院