雪球 MCP Server
让 AI 直接查询雪球行情、财务报表与社区观点。
通过 Model Context Protocol(MCP),将雪球数据接入 Claude Code、Claude Desktop、Cherry Studio 等 MCP 客户端。提供 ,覆盖 ,行情查询还支持指数、ETF 和可转债。
Power your agent
पब्लिशर का इंस्टॉल। PlugMCP एंडपॉइंट नहीं।
Host a copy with our keys and logs.
रजिस्ट्री में अभी कोई पैकेज्ड रिलीज़ नहीं है। रिपॉज़िटरी का README देखें.
रिमोट 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 个工具,免配置