雪球 MCP Server
让 AI 直接查询雪球行情、财务报表与社区观点。
通过 Model Context Protocol(MCP),将雪球数据接入 Claude Code、Claude Desktop、Cherry Studio 等 MCP 客户端。提供 ,覆盖 ,行情查询还支持指数、ETF 和可转债。
에이전트 강화
게시자가 제공하는 설치 방식입니다. PlugMCP 엔드포인트가 아닙니다.
원격 URL인가요, 내 컴퓨터에서 실행하는 명령인가요? 두 설치 방식의 차이
PlugMCP에서 실행
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
실행게시자 제공
让 AI 直接查询雪球行情、财务报表与社区观点。
通过 Model Context Protocol(MCP),将雪球数据接入 Claude Code、Claude Desktop、Cherry Studio 等 MCP 客户端。提供 ,覆盖 ,行情查询还支持指数、ETF 和可转债。
雪球(xueqiu.com)行情、财务、资金与社区论坛数据的 MCP Server,覆盖 A 股 / 港股 / 美股,22 个工具,免配置
需要 Python 3.10+、Git,以及能访问雪球的网络。以下命令适用于 macOS / Linux,使用 uv 管理环境。
git clone https://github.com/CNQQC/xueqiu-mcp.git
cd xueqiu-mcp
uv venv --python 3.12
uv pip install -e .
macOS / Linux:
python3 -m venv .venv
.venv/bin/python -m pip install -e .
Windows PowerShell(先克隆仓库并进入项目目录):
py -3 -m venv .venv
.venv\Scripts\python.exe -m pip install -e .
Windows 下将后续命令中的 .venv/bin/xueqiu-mcp 换成 .venv\Scripts\xueqiu-mcp.exe。JSON 配置里的反斜杠需要写为 \\。
.venv/bin/xueqiu-mcp --help
此命令只检查本地命令入口。接入客户端后,可让 AI 调用 get_quote 查询行情,确认完整链路可用。
Claude Code 用户在项目目录执行:
claude mcp add xueqiu -- "$(pwd)/.venv/bin/xueqiu-mcp"
其他客户端见客户端接入。连接后即可提问:
对比贵州茅台、腾讯和苹果的最新行情,并标注各自市场与币种。
启用浏览器支持后,还需下载 Chromium:
.venv/bin/playwright install chromium
不安装浏览器也可以查询公开数据,并通过 Cookie 登录。MCP SDK 的依赖范围为 >=1.30,<3,由安装命令自动处理。
macOS 用户可以在完成安装后运行仓库脚本:
./install-claude-desktop.sh
按提示使用 Cmd+Q 完全退出 Claude。脚本会等待退出、备份配置、更新 xueqiu 条目,并重新打开 Claude;其他 MCP 配置保持原样。
macOS 桌面应用访问 Downloads / Desktop / Documents 下的项目可能受到隐私权限限制。建议在
~/.local/share/xueqiu-mcp等目录克隆并安装,然后运行脚本。
手动配置时,将以下条目合并到客户端的 mcpServers 中。macOS Claude Desktop 的配置文件为 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"xueqiu": {
"command": "/绝对路径/xueqiu-mcp/.venv/bin/xueqiu-mcp"
}
}
}
将 command 替换成真实的绝对路径,路径包含空格或中文时也保留为一个完整字符串。保存后重新启动客户端。
添加本地 stdio 服务,将命令设置为上面的可执行文件绝对路径,参数留空。支持 JSON 导入的客户端可使用同一份配置。
远程连接使用 Streamable HTTP,地址为 https://你的域名/mcp;服务端配置见服务端部署。
也可直接传中文名称,例如「贵州茅台」。get_quote 支持逗号分隔多个标的,如 600519,00700,AAPL。注意:裸代码 000001 按深市股票处理,查询上证指数请用 SH000001。
先调用 list_screener_metrics 确认指标名称,再筛选。以下为 MCP 工具调用示意:
list_screener_metrics(market="CN", keyword="市盈")
screen_stocks(market="CN", filters="pettm:0~20,dy_l:3~,mc:100000000000~")
筛选语法为 指标:下限~上限,多条用逗号分隔,边界留空表示不限。上述条件为市盈率 0–20 倍、股息率 3% 以上、市值 1000 亿元以上;_l 后缀表示最新报告期。
先搜索并核对账号,再用 user_id 限定作者。昵称可能重复,不能直接选择第一项。例如确认目标为「买股票的老木匠」后:
search_users(query="老木匠")
search_posts(query="茅台", user_id="3058599833", count=3)
get_post(post_id="上一步返回的帖子ID", with_comments=false)
search_posts 和 get_user_posts 也接受雪球主页或帖子链接作为 user_id。限定作者时会再次核对返回帖子的作者 ID,排除身份不符或未知的结果。
列表提供摘要或关键词附近的摘录,全文和列表均区分作者文字、//@ 引用和被转发帖。归纳观点前应调用 get_post 读取全文,并保留作者、日期和原帖链接;无转发标记不等于原创,单页搜索为空也不等于作者从未讨论过该主题。
共 29 个工具。不同市场和标的的可用字段取决于雪球上游接口,部分功能仅适用于 A 股。
行情、财务、选股及部分社区数据通常可以匿名查询。遇到受限接口时,先调用 login_status 检查登录态,再按工具返回的提示登录。
安装 [browser] 依赖和 Chromium 后,让 AI 调用 get_login_qrcode。工具立即返回 MCP 原生二维码图片和 5 分钟有效的临时登录网页链接,用雪球 App 扫码并确认后,后台自动接管凭证。用 login_status 确认结果。
也可在命令行登录:
.venv/bin/xueqiu-mcp login --browser
终端显示二维码,并保存到 ~/.xueqiu-mcp/login-qrcode.png。需要短信或滑块验证时,可在有图形界面的服务主机上运行窗口模式:
.venv/bin/xueqiu-mcp login --browser --window
在浏览器登录雪球,从开发者工具的 Network 中复制请求的完整 Cookie 请求头,再执行以下命令并按提示粘贴:
.venv/bin/xueqiu-mcp login --cookie
macOS 也可以从剪贴板读取,避免 Cookie 写入 shell 历史:
pbpaste | .venv/bin/xueqiu-mcp login --cookie -
.venv/bin/xueqiu-mcp status
.venv/bin/xueqiu-mcp logout
凭证默认保存在 ~/.xueqiu-mcp/cookies.json,目录权限为 0700、文件权限为 0600,采用原子写入。这是本地文件权限保护,不是加密存储。 服务启动时自动加载,XUEQIU_COOKIE 环境变量优先于本地文件,保存位置可通过 XUEQIU_COOKIE_FILE 修改。
xueqiu-mcp login 提供交互式菜单,也支持实验性的手机号密码登录:xueqiu-mcp login --phone 13800138000。密码由终端交互读取;遇到风控时请改用扫码或 Cookie。login_with_cookie(cookie=..., remember=true) 会验证 Cookie 后保存,失败时回滚。工具参数可能进入模型上下文和客户端日志,因此优先使用扫码或本地命令行。XUEQIU_COOKIE 注入凭证,或在客户端 JSON 的 env 对象中配置。不要将真实 Cookie 提交到仓库或 Issue。浏览器使用独立 Chromium profile,默认位于 ~/.xueqiu-mcp/browser,不使用日常浏览器的个人配置。空闲 300 秒后自动关闭,也可调用 browser_close 释放资源。
get_login_qrcode 会复用有效会话;refresh=true 重新生成,并让旧链接失效。browser_login 默认也立即返回二维码;显式 wait 单次最多等待 30 秒。应先向用户展示二维码,再等待扫码。browser_close 或 logout 会清理等待任务和登录标签页。127.0.0.1、使用随机端口的临时网页服务。链接只能在服务所在机器打开,用户也可用手机扫描客户端显示的二维码。remember=false 仅禁止写入 cookies.json,浏览器 profile 仍可能保留登录态。browser_close 保留登录态;默认 logout 会同时清理凭证文件和浏览器 profile。get_post 在正文为空或被标记截断时尝试浏览器补全,设置 full_text=false 可关闭这次兜底。列表摘要应先通过 get_post 查询全文;浏览器补全仍受当前账号的访问权限限制。无图形界面的服务器可以使用无头扫码模式;只有窗口模式需要 GUI。
默认使用本地 stdio。需要远程访问时,启动 Streamable HTTP 服务:
XUEQIU_TRANSPORT=streamable-http XUEQIU_HOST=0.0.0.0 XUEQIU_PORT=8000 \
.venv/bin/xueqiu-mcp
客户端连接 http://<服务器地址>:8000/mcp。服务默认启用无状态 HTTP 会话,但同一进程仍共享一个雪球账号和缓存。公网部署应通过反向代理配置 HTTPS、鉴权和限流;并发上限只控制同时在途的请求数,不是每秒请求配额。
设置外部可访问的基础地址,不包含 /mcp,可带代理路径前缀:
export XUEQIU_TRANSPORT=streamable-http
export XUEQIU_PUBLIC_BASE_URL=https://mcp.example.com/xueqiu
.venv/bin/xueqiu-mcp
临时登录链接为 https://mcp.example.com/xueqiu/login/<随机token>。反向代理需将以下请求转发到同一服务进程:
登录网页的两条 GET 路由使用短期随机 token 授权,不携带 MCP 长期 Bearer 凭证。如果代理统一鉴权,仅为这两种 GET 路径放行,继续保护 /mcp;建议关闭登录路径访问日志,避免记录 token。
扫码会话存在进程内存中。使用单 worker,或将同一会话的 MCP 与网页请求固定转发到同一进程。重启会使旧链接失效;未配置外部地址时,仅返回二维码与网页相对路径。
自定义 HTTP 入口需设置 XUEQIU_TRANSPORT=streamable-http,并使用 xueqiu_mcp.server.mcp.streamable_http_app(),以保留本项目注册的登录路由。
已有 VPS 的自动更新、健康检查与回滚流程见 部署文档。
所有配置均通过环境变量传入。
缓存按接口分级:行情 3 秒、分时 5 秒、K 线 30 秒、财报 1 小时、公司资料 6 小时、行业与选股指标 24 小时。相同请求并发到达时合并为一次上游调用。具体规则见 cache.py。
更新时先进入源码目录,再使用客户端配置指向的环境重新安装,例如:
uv pip install --python /绝对路径/客户端环境/bin/python -e .
如果源码目录受 macOS 隐私权限限制,可去掉 -e 将包安装到目标环境的 site-packages,随后重启客户端。
离线测试不需要访问雪球,浏览器相关测试使用模拟对象:
.venv/bin/python tests/test_cache.py
.venv/bin/python tests/test_auth.py
.venv/bin/python tests/test_client_social.py
.venv/bin/python tests/test_deploy.py
.venv/bin/python tests/test_browser.py
.venv/bin/python tests/test_login_flow.py
真实接口测试需要联网:
.venv/bin/python tests/test_mcp_e2e.py
.venv/bin/python tests/test_social_e2e.py
test_mcp_e2e.py 通过 stdio 执行 MCP 工具调用;test_social_e2e.py 验证昵称消歧、作者限定搜索与原帖全文。登录和浏览器离线测试使用临时凭证目录;真实 MCP 测试只覆盖不改变登录态的账号路径。
CI 运行上述六组离线测试,覆盖 Python 3.10–3.13、可选 orjson 和 MCP 1.30 兼容性。每周巡检 单独运行 test_mcp_e2e.py;失败时需同时排查代码、网络与雪球接口变化。巡检设置 XUEQIU_E2E_GEO_TOLERANT=1,容忍境外 IP 导致的股票搜索空结果,本地默认严格校验。
本地基准使用 mock 上游,不访问雪球。重点关注缓存减少的上游请求数,以及峰值并发是否符合配置;mock QPS 不代表真实服务表现。
.venv/bin/python tests/bench.py
MOCK_RTT=0 .venv/bin/python tests/bench.py
以下为项目早期记录的测试结果(A 股交易时段,约 1,500 次真实接口请求),覆盖当时的 22 个工具。原记录未注明日期、硬件和网络配置,不能视为当前版本的性能保证;延迟会随网络、上游状态与缓存命中率变化。
src/xueqiu_mcp/
├── client.py HTTP 客户端:令牌续期、连接池与 HTTP/2、并发闸门、风控识别
├── auth.py 登录:Cookie 解析与登录态识别、凭证落盘、密码登录
├── browser.py 本地浏览器:扫码登录、正文兜底渲染、profile 与空闲回收
├── login_flow.py 临时登录链接、后台扫码会话与登录网页
├── cache.py 响应缓存:分级 TTL、LRU 内存上限、并发请求合并
├── symbols.py 代码规范化(600519 → SH600519)
├── resolve.py 代码解析,中文名走搜索兜底
├── fields.py A 股字段中文映射表
├── fields_intl.py 港股 / 美股字段映射表(经会计恒等式校验)
├── screener.py 选股器指标元数据(读雪球官方接口并缓存)
├── formatting.py 数值单位换算、Markdown 表格、HTML 正文清洗
├── server.py MCP 工具注册
└── tools/
├── quote.py 行情、K 线、分时
├── finance.py 财务报表、主营构成
├── f10.py 公司资料、股东、分红
├── capital.py 资金流、两融、大宗交易
├── market.py 选股器、行业、人气榜
├── social.py 论坛:讨论、公告新闻、热帖、评论
└── account.py 账号:登录状态、扫码登录、Cookie 登录、退出登录
欢迎通过 Issues 报告问题或提出功能建议,也欢迎提交 Pull Request。
本项目采用 MIT License,是独立开源项目,非雪球官方产品。
数据来自雪球接口,可能延迟、缺失或因接口调整而不可用。仅供学习研究,不构成投资建议;使用时请遵守雪球服务条款并控制请求频率。
雪球(xueqiu.com)行情、财务、资金与社区论坛数据的 MCP Server,覆盖 A 股 / 港股 / 美股,22 个工具,免配置
도구
아직 도구 목록이 없습니다. 원격 서버는 첫 상태 확인 후에 도구 목록이 생깁니다.
FAQ
이 페이지에서 Cursor, Claude Desktop, Claude Code 또는 VS Code용 stdio 설정을 복사합니다. PlugMCP 프록시가 아니라 게시자의 설치 방식을 사용합니다.
이 레코드에는 필수 환경 변수가 등록되어 있지 않습니다.
Xueqiu은(는) stdio를 통해 로컬에서 실행됩니다.
마지막 확인: 2026-10-28. 雪球(xueqiu.com)行情、财务、资金与社区论坛数据的 MCP Server,覆盖 A 股 / 港股 / 美股,22 个工具,免配置