{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_evv44emnvfpk","handle":"snowball-mcp","url":"https://wellknown.network/agents/snowball-mcp","links":{"self":"https://wellknown.network/agents/snowball-mcp/record.json","html":"https://wellknown.network/agents/snowball-mcp","markdown":"https://wellknown.network/agents/snowball-mcp/record.md","api":"https://wellknown.network/api/v1/agents/snowball-mcp","status":"https://wellknown.network/api/v1/agents/snowball-mcp/status","claim":"https://wellknown.network/agents/snowball-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/snowball-mcp/claim.json","badge":"https://wellknown.network/agents/snowball-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/snowball-mcp/history","tools":"https://wellknown.network/api/v1/agents/snowball-mcp/tools"},"ard":{"identifier":"urn:air::server:snowball-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"snowball-mcp","summary":"基于雪球API的MCP服务，让您通过Claude或其他AI助手轻松获取股票数据","description":"# Snowball MCP (雪球 MCP)\n\n基于雪球API的MCP服务，让您通过Claude或其他AI助手轻松获取股票数据。\n\n## 项目简介\n\n本项目基于[pysnowball](https://github.com/uname-yang/pysnowball)封装了雪球API，并通过MCP协议提供服务，使您能够在Claude等AI助手中直接查询股票数据。\n\n## 安装方法\n\n### 方式一：在线安装（推荐）✨\n\n无需克隆仓库，直接使用 `uvx` 运行：\n\n```bash\n# 设置环境变量\nexport XUEQIU_TOKEN=\"xq_a_token=xxxxx;u=xxxx\"\n\n# 直接运行\nuvx snowball-mcp\n```\n\n### 方式二：Claude Desktop / Cursor / MCPHub 配置\n\n在 MCP 客户端配置文件中添加：\n\n```json\n{\n  \"mcpServers\": {\n    \"snowball-mcp\": {\n      \"command\": \"uvx\",\n      \"args\": [\"snowball-mcp\"],\n      \"env\": {\n        \"XUEQIU_TOKEN\": \"xq_a_token=xxxxx;u=xxxx\"\n      }\n    }\n  }\n}\n```\n\n### 方式三：本地开发安装\n\n```bash\n# 克隆仓库\ngit clone https://github.com/xunzhimeng/xueqiu_mcp.git\ncd xueqiu_mcp\n\n# 使用uv安装依赖\nuv pip install -e .\n\n# 创建 .env 文件配置 token\necho 'XUEQIU_TOKEN=\"xq_a_token=xxxxx;u=xxxx\"' > .env\n\n# 运行\nsnowball-mcp\n```\n\n## 配置雪球Token\n\n关于如何获取雪球token，请参考[pysnowball文档](https://github.com/uname-yang/pysnowball/blob/master/how_to_get_token.md)。\n\n### 多 Token 配置（可选）\n\n为了分散请求压力、减少限流错误，支持配置多个 Token：\n\n```bash\n# 方式一：逗号分隔\nXUEQIU_TOKEN=\"token1,token2,token3\"\n\n# 方式二：多个环境变量\nXUEQIU_TOKEN_1=\"token1\"\nXUEQIU_TOKEN_2=\"token2\"\nXUEQIU_TOKEN_3=\"token3\"\n```\n\n多 Token 会自动轮换使用，当某个 Token 连续失败时会临时禁用并切换到下一个。\n\n## 功能特性\n\n- 获取股票实时行情\n- 获取K线数据（支持日/周/月/季/年线和分钟级数据）\n- 查询指数收益\n- 获取深港通/沪港通北向数据\n- 基金相关数据查询\n- 关键词搜索股票代码\n- 财务报表数据（利润表、资产负债表、现金流量表等）\n- 资金流向数据\n- 融资融券数据\n- 大宗交易数据\n- 机构评级和持仓数据\n\n### 无需登录的功能\n\n以下功能无需配置 Token 即可使用：\n- `suggest_stock` - 股票搜索\n- `quotec` - 基础行情\n- `pankou` - 盘口数据\n\n## 展示图\n\n![image](./images/cursor_mcp.png)\n\n![image](./images/claude_mcp.png)\n\n## 致谢\n\n本项目 fork 自 [liqiongyu/xueqiu_mcp](https://github.com/liqiongyu/xueqiu_mcp)，在此基础上进行了改进和优化。\n\n- [liqiongyu/xueqiu_mcp](https://github.com/liqiongyu/xueqiu_mcp) - 原始项目\n- [pysnowball](https://github.com/uname-yang/pysnowball) - 雪球股票数据接口的Python版本\n- [fastmcp](https://github.com/jlowin/fastmcp) - MCP服务框架\n\n## 许可证\n\n[MIT License](./LICENSE)","publisher":{"name":"xunzhimeng","url":null},"homepage":"https://github.com/xunzhimeng/xueqiu_mcp","repository":"https://github.com/xunzhimeng/xueqiu_mcp","version":"0.2.8","license":null,"protocols":["mcp"],"tags":["ai","claude","mcp","model-context-protocol","stock","xueqiu"],"pricing":null,"endpoints":[{"url":"pypi:snowball-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"snowball-mcp","registry":"pypi","observedAt":"2026-11-04T01:24:45.296Z","publishedAt":"2026-01-07T14:03:48.427289Z","latestVersion":"0.2.8"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"snowball-mcp","url":"https://pypi.org/project/snowball-mcp/","firstSeenAt":"2026-09-10T12:22:45.629Z","fetchedAt":"2026-11-04T01:22:44.859Z","normalizedAt":"2026-11-04T01:22:44.859Z"}]},"firstSeenAt":"2026-09-10T12:22:45.629Z","updatedAt":"2026-11-04T01:24:45.296Z"}