xueqiu
Servidor MCP de Xueqiu
Conecta los datos de cotizaciones, finanzas, flujos de capital y el foro comunitario de Xueqiu a cualquier cliente compatible con MCP (Claude Code, Claude Desktop, Cherry Studio, etc.).
Cubre acciones A / acciones de Hong Kong / acciones de EE. UU., además de índices, ETF y bonos convertibles. En total, 22 herramientas.
Características
Salida orientada a modelos de lenguaje: la API original de Xueqiu devuelve campos y valores como
ncf_from_oa,1.7205417189091E11. Este proyecto traduce más de 600 campos financieros al chino, convierte los importes a «cientos de millones / diez miles de yuanes» y reorganiza los estados financieros de varios periodos en tablas Markdown de «indicador × periodo de reporte». El modelo puede leerlos directamente y el consumo de tokens es mucho menor que con el JSON original.Campos de Hong Kong verificados: los informes financieros de Hong Kong de Xueqiu usan códigos muy abreviados como
tto,plobtx,ploashh. El mapeo al chino de este proyecto se confirmó de forma inversa usando los valores financieros reales de Tencent Holdings y las identidades contables (por ejemplo,tto - slgcost == gp,ta - tlia == teqy,nocf + ninvcf + nfcgcf == icdccceq), no se basa en suposiciones.Foro utilizable: la interfaz comunitaria está bloqueada por el control de riesgos en el dominio principal
xueqiu.com. Este proyecto usaapi.xueqiu.com, que emplea la app de Xueqiu, y no requiere inicio de sesión para leer discusiones de acciones individuales, anuncios y noticias, publicaciones populares y comentarios. El HTML del cuerpo de las publicaciones se limpia y convierte a texto plano.Sin configuración: el token anónimo se obtiene y renueva automáticamente. Funciona nada más instalarlo, sin necesidad de cookies ni registro.
Indicadores de selección de acciones sincronizados en tiempo real: la lista de indicadores del screener se lee directamente de la interfaz de metadatos oficial de Xueqiu; si Xueqiu ajusta los indicadores, este proyecto no queda desactualizado.
Capaz de soportar concurrencia en máquinas pequeñas: caché TTL por niveles + fusión de solicitudes concurrentes + multiplexación HTTP/2. En pruebas de entorno real, las consultas repetidas son 15,8 veces más rápidas, las solicitudes a Xueqiu se reducen un 90 % y la memoria residente es de unos 75 MB. Ver Rendimiento y concurrencia.
Related MCP server: mcp-stock-quote
Instalación
uv venv --python 3.12 && uv pip install -e .Si quieres que el análisis de JSON grandes (como 500 velas K) sea 2~3 veces más rápido, puedes incluir orjson:
uv pip install -e ".[fast]"Conexión con Claude Code
En el directorio del proyecto, ejecuta:
claude mcp add xueqiu -- "$(pwd)/.venv/bin/xueqiu-mcp"Conexión con Claude Desktop / otros clientes
En macOS puedes ejecutar directamente el script de instalación. Espera automáticamente a que Claude se cierre por completo (un Claude en ejecución sobrescribiría el archivo con su configuración en memoria),
hace una copia de seguridad de la configuración original y solo añade o modifica la entrada xueqiu, sin tocar los demás MCP que ya tengas:
./install-claude-desktop.shPara configuración manual, edita el archivo de configuración (en Claude Desktop está en ~/Library/Application Support/Claude/claude_desktop_config.json),
y sustituye command por la ruta absoluta de .venv/bin/xueqiu-mcp:
{
"mcpServers": {
"xueqiu": {
"command": "/绝对路径/.venv/bin/xueqiu-mcp"
}
}
}Si la ruta del proyecto contiene espacios o caracteres chinos, usa obligatoriamente la cadena de ruta absoluta completa; no la dividas en
args.
Resumen de herramientas
Búsqueda y cotizaciones
Herramienta | Descripción |
| Busca instrumentos por nombre / pinyin / código |
| Cotización en tiempo real, admite consultar varios instrumentos a la vez y mezclar mercados |
| Velas K históricas, opcionalmente con PE/PB/PS/capitalización de cada vela |
| Gráfico intradía del día o de los últimos 5 días (muestreo automático de unos 40 puntos) |
Finanzas
Herramienta | Descripción |
| Cuenta de resultados / balance / flujo de caja / indicadores principales, compatible con acciones A, Hong Kong y EE. UU. |
| Desglose del negocio principal: ingresos, costes y margen bruto por producto y región |
Información de la empresa
Herramienta | Descripción |
| Perfil de la empresa, controlador real, número de empleados, sector y conceptos temáticos |
| Evolución del número de accionistas, diez principales accionistas circulantes, tenencias institucionales |
| Historial de dividendos, ampliaciones y fechas de ex-derecho |
Flujo de capital
Herramienta | Descripción |
| Entrada neta diaria de capital principal + estructura de órdenes grandes/medianas/pequeñas del día |
| Saldo de financiación y préstamo de valores y compras netas |
| Detalle de operaciones en bloque (incluye las sucursales compradoras y vendedoras) |
Mercado y selección de acciones
Herramienta | Descripción |
| Screener de acciones, filtra y ordena por valoración / finanzas / indicadores de cotización |
| Consulta todos los indicadores admitidos por el screener (metadatos oficiales) |
| Clasificación sectorial Shenwan |
| Ranking de popularidad de Xueqiu |
Foro comunitario
Herramienta | Descripción |
| Zona de discusión de una acción, ordenable por popularidad o tiempo |
| Flujo de noticias / anuncios de la empresa |
| Discusiones populares de la portada de Xueqiu |
| Búsqueda de publicaciones en todo el sitio |
| Texto completo de la publicación + comentarios populares |
| Publicaciones recientes de un usuario |
Formato de los códigos
Mercado | Formato | Ejemplos |
Acciones A |
|
|
Hong Kong | 5 dígitos, rellenar con ceros si falta |
|
EE. UU. | Código alfabético |
|
También puedes pasar directamente el nombre en chino (por ejemplo, «贵州茅台»); la herramienta primero buscará y luego obtendrá los datos.
Ejemplos de uso
Dile directamente al modelo:
«¿Cómo están los indicadores financieros recientes de Moutai?»
«Ayúdame a filtrar acciones A con PER inferior a 20 veces, rentabilidad por dividendo superior al 3 % y capitalización superior a 100 000 millones»
«Mira cómo discute la gente en Xueqiu sobre CATL»
«Compara el margen bruto y el ROE de los últimos tres años entre Kweichow Moutai y Wuliangye»
«¿Tencent tiene algún anuncio hoy?»
La sintaxis de filtrado del screener:
filters="pettm:0~20,dy_l:3~,mc:100000000000~"Es decir, PER de 0~20 veces, rentabilidad por dividendo superior al 3 % y capitalización superior a 100 000 millones. Los límites pueden dejarse vacíos para indicar «sin límite».
Los nombres de los indicadores pueden consultarse con list_screener_metrics; el sufijo _l indica que se toma el último periodo de reporte.
Opcional: configurar tu propia cookie
La gran mayoría de funciones funcionan de forma anónima. Las pocas interfaces que requieren sesión iniciada (como el detalle del perfil de usuario) pueden configurarse con una variable de entorno:
export XUEQIU_COOKIE="从浏览器开发者工具复制的完整 Cookie"En la configuración de MCP se escribe así:
{
"mcpServers": {
"xueqiu": {
"command": "/绝对路径/.venv/bin/xueqiu-mcp",
"env": { "XUEQIU_COOKIE": "..." }
}
}
}Despliegue en un servidor
Por defecto se inicia con stdio, y un proceso solo atiende a un cliente. Para atender a varias personas y varios clientes a la vez en una misma máquina, cambia a streamable-http:
XUEQIU_TRANSPORT=streamable-http XUEQIU_HOST=0.0.0.0 XUEQIU_PORT=8000 \
.venv/bin/xueqiu-mcpEl cliente se conecta a http://<dirección>:8000/mcp. Este modo es stateless por defecto: el servidor no mantiene sesiones para los clientes,
la memoria no se acumula con el número de conexiones y también facilita la escalabilidad horizontal con varias réplicas.
La interfaz de Xueqiu no tiene una plataforma abierta oficial. Antes de exponerla a Internet, añade tu propia autenticación y limitación de velocidad, y no traslades el volumen de solicitudes de otros a Xueqiu.
Rendimiento y concurrencia
Todos los parámetros de recursos pueden reducirse con variables de entorno para adaptarse a máquinas con poca memoria:
Variable de entorno | Valor por defecto | Descripción |
| 32 | Límite superior del pool de conexiones |
| 32 | Número de solicitudes ascendentes en tránsito, sirve también como limitación de velocidad hacia Xueqiu |
| 16 | Límite de memoria de la caché de respuestas, ya convertido según los objetos analizados; ocupa aproximadamente lo que se configure |
| 1 | Poner 0 desactiva la caché |
| 1 | Poner 0 desactiva HTTP/2 |
| 15 | Tiempo de espera por solicitud (segundos) |
La caché se divide por niveles según el endpoint: cotizaciones 3 segundos, velas K 30 segundos, informes financieros 1 hora, información de empresa 6 horas, clasificación sectorial e indicadores del screener 24 horas. Cuando hay solicitudes concurrentes por los mismos datos, solo se envía una y el resto espera su resultado.
Mediciones reales
Las siguientes cifras provienen de pruebas en entorno real (llamando a las interfaces reales de Xueqiu, en horario de negociación de acciones A, con unas 1 500 solicitudes en total):
Escenario | Resultado | Condición de medición |
Latencia de llamada en frío de las 22 herramientas | Mediana 51,0 ms | 3 muestras en frío por herramienta, se toma la mediana y luego la mediana entre herramientas |
Con caché acertada | Mediana 1,84 ms | 9 muestras en caliente por herramienta |
Sobrecarga propia del proyecto | Mediana 4,4 ms | Tiempo de extremo a extremo menos el tiempo de pared ascendente, incluye codificación/decodificación MCP y formateo |
Consultas repetidas (A/B entre versión nueva y antigua) | 15,8 veces más rápido, solicitudes ascendentes -90 % | Mismo instrumento consultado 10 veces seguidas |
Concurrencia 32 | Cero fallos, P50 86 ms | Carga escalonada 1→4→8→16→32, 193 solicitudes en total |
El cuello de botella no está en este proyecto: stock.xueqiu.com tiene una mediana de 40,4 ms por solicitud, api.xueqiu.com (comunidad) 84,8 ms,
mientras que este proyecto solo representa 4,4 ms.
El beneficio principal proviene de la caché y la fusión de solicitudes, y en segundo lugar de la multiplexación HTTP/2 en ráfagas con conexiones frías. El rendimiento puro de tubería (con la caché desactivada) es prácticamente igual que antes de la optimización: no esperes que sea más rápido gracias a ello.
tests/bench.py usa un upstream mock local (criterio mock, no equivale al rendimiento real);
su propósito es la detección de regresiones, no presumir de rendimiento:
.venv/bin/python tests/bench.py # 默认模拟 30ms 网络延迟
MOCK_RTT=0 .venv/bin/python tests/bench.py # 零延迟,放大纯代码开销Claves de interpretación: presta atención a si el número de solicitudes ascendentes y el pico de concurrencia coinciden con lo esperado. El número de QPS se ve muy afectado por la sobrecarga de programación del propio mock server; en el bucle local, la caída de QPS al aumentar la concurrencia es un artefacto del entorno de pruebas, no indica un problema en el código probado.
La capa de caché tiene además un conjunto de pruebas de regresión sin red, que cubren fusión de solicitudes, propagación de cancelación, expulsión LRU y contabilidad de bytes:
.venv/bin/python tests/test_cache.pyLímites conocidos
La compuerta de concurrencia no es un limitador de velocidad. Solo restringe el «número de solicitudes en tránsito», no el número de solicitudes por unidad de tiempo. Según la latencia medida, 32 de concurrencia permiten teóricamente unas 700 req/s hacia Xueqiu. Controla el ritmo desde el lado de la llamada.
El entorno real solo se ha verificado hasta 32 de concurrencia; no hay datos reales para concurrencias más altas.
XUEQIU_CACHE_MBes una estimación algo optimista; en la práctica, el crecimiento real de memoria es de aproximadamente 1,2~1,9 veces ese valor (más alto en el caso de entradas pequeñas). En máquinas con poca memoria se recomienda poner 8.
Pruebas
.venv/bin/python tests/test_mcp_e2e.pyEste script se conecta a este servidor a través de stdio como un cliente MCP real, lista todas las herramientas y las invoca una a una (incluida la resolución de nombres en chino, índices/ETF/bonos convertibles, y los mensajes de error de validación de varios parámetros) y finalmente imprime el número de pruebas superadas.
Estructura del proyecto
src/xueqiu_mcp/
├── client.py HTTP 客户端:令牌续期、连接池与 HTTP/2、并发闸门、风控识别
├── 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 论坛:讨论、公告新闻、热帖、评论Notas
Todos los datos provienen de las interfaces públicas de Xueqiu; las cotizaciones pueden tener retraso y no constituyen ningún consejo de inversión.
Este proyecto es solo para estudio e investigación. Respeta los términos de servicio de Xueqiu y evita solicitudes de alta frecuencia.
La interfaz de Xueqiu no es una plataforma abierta oficial; los campos y la disponibilidad pueden ajustarse en cualquier momento.
Available Tools
22 toolsget_block_tradesC
大宗交易明细:成交价、折溢价率与买卖双方营业部。
Args: symbol: 股票代码 count: 取最近几笔,最多 50
Inputs: symbol (required), count. Returns: result
get_business_breakdownA
主营构成:按产品和地区拆分的收入、成本与毛利率(仅 A 股)。
Args: symbol: 股票代码 count: 取最近几个报告期,最多 8
Inputs: symbol (required), count. Returns: result
get_capital_flowA
主力资金流向:每日净流入走势,以及当日大中小单的成交结构。
Args: symbol: 股票代码 days: 回溯天数,接口最多提供约 20 个交易日
Inputs: symbol (required), days. Returns: result
get_company_profileB
公司资料:简介、主营、实控人、员工数、所属行业与概念板块(仅 A 股)。
Args: symbol: 股票代码
Inputs: symbol (required). Returns: result
get_dividendsA
历年分红送配方案与除权除息日(仅 A 股)。
Args: symbol: 股票代码 count: 取最近几次,最多 50
Inputs: symbol (required), count. Returns: result
get_financial_statementA
财务报表与核心指标,按「指标 × 报告期」排版便于跨期对比。
A 股 / 港股 / 美股都支持,字段已翻译成中文并换算单位。
Args: symbol: 股票代码 statement: indicator 主要指标 / income 利润表 / balance 资产负债表 / cash_flow 现金流量表 report_type: all 全部报告期 / Q1 一季报 / Q2 中报 / Q3 三季报 / Q4 年报 count: 取最近几期,最多 20 detail: 为 true 时输出全部科目,否则只给核心科目
Inputs: symbol (required), count, detail, statement, +1 more. Returns: result
get_hot_postsC
雪球首页热门讨论,用于了解当前全市场关注的话题。
Args: count: 条数,最多 30
Inputs: count. Returns: result
get_hot_stocksB
雪球人气榜:按用户关注热度排序的股票及热度变化。
Args: market: CN A股 / HK 港股 / US 美股 limit: 取前多少名,最多 100
Inputs: limit, market. Returns: result
get_klineB
历史 K 线,可选带上每根 K 线的 PE / PB / PS / 市值。
Args: symbol: 股票代码 period: 周期,1m/5m/15m/30m/60m/120m/day/week/month/quarter/year count: 最近多少根 K 线,最多 500 adjust: 复权方式,before 前复权 / after 后复权 / normal 不复权 with_valuation: 为 true 时附带估值指标,适合做估值分位分析
Inputs: symbol (required), count, adjust, period, +1 more. Returns: result
get_margin_tradingA
融资融券余额、融资买入与净买入(仅两融标的)。
Args: symbol: 股票代码 days: 回溯交易日数,最多 90
Inputs: symbol (required), days. Returns: result
get_minuteA
当日或近 5 日分时走势(自动抽样到约 40 个点)。
Args: symbol: 股票代码 period: 1d 当日 / 5d 近五日
Inputs: symbol (required), period. Returns: result
get_postA
按帖子 ID 取全文及热门评论。ID 可从讨论列表或热帖列表中获得。
Args: post_id: 帖子数字 ID,或完整帖子链接 with_comments: 是否附带评论 comment_count: 评论条数,最多 30
Inputs: post_id (required), comment_count, with_comments. Returns: result
get_quoteA
实时行情快照:价格、涨跌、成交、市值、PE/PB、股息率等。
支持一次查多个标的,用逗号分隔,也支持 A 股 / 港股 / 美股 / 指数 / ETF / 可转债。
Args: symbols: 一个或多个代码,如 "600519" 或 "600519,00700,AAPL" detail: 为 true 时返回全部行情字段(含质押比例、商誉占比等)
Inputs: symbols (required), detail. Returns: result
get_stock_discussionsA
个股讨论区帖子:作者、粉丝数、点赞评论数与正文。
想了解市场情绪、散户与大 V 观点时使用。
Args: symbol: 股票代码 sort: hot 按热度(高赞高评论)/ time 按最新 count: 条数,最多 30 page: 页码
Inputs: symbol (required), page, sort, count. Returns: result
get_stock_newsB
个股新闻或公告流。
Args: symbol: 股票代码 kind: news 新闻 / notice 公司公告 count: 条数,最多 30 page: 页码
Inputs: symbol (required), kind, page, count. Returns: result
get_user_postsA
查看某位雪球用户的发帖动态,用于跟踪特定作者的观点。
Args: user_id: 雪球用户数字 ID(见帖子链接 xueqiu.com/<user_id>/<post_id>) count: 条数,最多 30 page: 页码
Inputs: user_id (required), page, count. Returns: result
list_industriesA
申万行业分类列表,返回的 encode 可作为 screen_stocks 的 industry 参数。
Args: market: CN / HK / US
Inputs: market. Returns: result
list_screener_metricsA
列出选股器支持的全部指标及其中文名(雪球官方元数据)。
在使用 screen_stocks 前调用,以确认指标名的正确写法。 建议总是带上 keyword:不带时会列出全部指标,返回内容大约是带 keyword 时的 9 倍。
Args: market: CN / HK / US keyword: 按中文名或指标名过滤,如「市盈」「roe」。省略则返回全部指标
Inputs: market, keyword. Returns: result
screen_stocksA
选股器:按估值、财务、行情等指标筛选并排序股票。
filters 写成 指标:下限~上限,多条用逗号分隔,边界可留空。
例:pettm:0~20,dy_l:3~,mc:100000000000~ 表示市盈率 0~20 倍、
股息率 3% 以上、市值 1000 亿以上。
指标名请先用 list_screener_metrics 查询;_l 后缀表示取最新报告期。
Args: market: CN A股 / HK 港股 / US 美股 order_by: 排序指标,如 mc 总市值、pct 涨跌幅、pettm 市盈率 order: desc 降序 / asc 升序 limit: 每页条数,最多 100 page: 页码 filters: 筛选条件串 industry: 行业代码,用 list_industries 查询 exchange: A 股范围,sh_sz 沪深 / sh / sz / bj columns: 额外展示的指标,逗号分隔;注意会排除该指标为空的标的
Inputs: page, limit, order, market, +5 more. Returns: result
search_postsA
全站搜索雪球帖子。
Args: query: 关键词,如「宇树」「红利策略」 count: 条数,最多 30 page: 页码
Inputs: query (required), page, count. Returns: result
search_stockA
按名称、拼音或代码搜索股票,返回雪球标准代码。
当用户给的是公司名称而不是代码,且需要确认具体标的时使用。
Args: query: 名称 / 拼音首字母 / 代码,如「茅台」「gzmt」「600519」 limit: 返回条数,最多 20
Inputs: query (required), limit. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 22 tools
每个工具都针对明确不同的数据或操作,如行情、K线、财务、股东、资金流、讨论区、帖子等,没有重叠或模糊地带。即使类似概念如热门讨论和热门股票,也明确区分了对象。
全部工具采用动词+名词的蛇形命名,如get_开头和search_/screen_/list_开头,风格统一,模式可预测。没有混合camelCase或异常命名。
22个工具略多于理想的3-15范围,但考虑到服务器覆盖雪球平台的海量数据(行情、财务、社交、选股等),每个工具都有独立用途,无冗余,数量合理。
工具集覆盖了雪球的主要功能域,包括实时行情、历史K线、财务分析、股东结构、资金流向、新闻公告、讨论区、帖子搜索、选股器以及元数据查询,没有明显缺口。
Maintenance
Related MCP Connectors
China A-share data for AI agents: 57 read-only tools plus 6 tools for your own watchlist.
China A-share market data over MCP: 22 tools for quotes, K-line, financials, money flow, top-trader boards, sectors, macro, convertible bonds and factor screening. Five tools need no API key, so you can connect and try it immediately.
Access real-time and historical market data for China A-shares and Hong Kong stocks, along with ne…
China A-share screening, filings, holdings, flows and calendars as agent tools.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to query real-time A-share stock data, including quotes, fund flows, sector flows, and K-line history, without needing an API key.519MIT
- AlicenseAqualityCmaintenanceEnables AI assistants to fetch realtime stock quotes, fundamentals, and search for stocks across A-share, Hong Kong, and US markets without requiring API keys.5MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to pull live China A-share market data through 24 tools spanning real-time quotes, K-lines, five-level order books, financials, money flow, dragon-tiger lists, sector and valuation data, convertible bonds, ETFs, IPOs, macro indicators, and factor-based stock screening. Five of the tools work with no API key, while the rest require a paid key.331 npm1MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to query real-time and historical market data across A-shares, Hong Kong, US stocks, funds, futures, and options, including K-lines, technical indicators (MA/MACD/BOLL/KDJ/RSI), sector and capital-flow data. It also provides composite analysis tools, presets, and prompts for stock screening, multi-stock comparison, portfolio monitoring, and market overviews.153 npmISC