Xueqiu MCP Server

Bindet Xueqiu-Daten zu Kursen, Finanzen, Kapitalflüssen und der Community-Foren in jeden MCP-fähigen Client ein (Claude Code, Claude Desktop, Cherry Studio usw.).

Abgedeckt werden A-Aktien / Hongkong-Aktien / US-Aktien, dazu Indizes, ETFs und Wandelanleihen. Insgesamt 22 Tools.

Eigenschaften

• Für LLMs optimierte Ausgabe: Die rohen Xueqiu-Schnittstellen liefern Felder und Werte wie ncf_from_oa oder 1.7205417189091E11. Dieses Projekt übersetzt 600+ Finanzfelder ins Chinesische, rechnet Beträge in „Milliarden / Zehntausend Yuan" um und transponiert mehrperiodige Finanzberichte in Markdown-Tabellen im Format „Kennzahl × Berichtszeitraum" – Modelle können das direkt lesen, und der Token-Verbrauch ist weit geringer als beim rohen JSON.

• Hongkong-Felder verifiziert: Die Hongkong-Finanzberichte von Xueqiu verwenden stark abgekürzte Codes wie tto, plobtx, ploashh. Die chinesische Zuordnung dieses Projekts wurde anhand der tatsächlichen Finanzzahlen von Tencent Holdings über buchhalterische Identitäten rückwärts bestätigt (z. B. tto - slgcost == gp, ta - tlia == teqy, nocf + ninvcf + nfcgcf == icdccceq) – nicht geraten.

• Forum nutzbar: Die Community-Schnittstelle wird auf der Hauptdomain xueqiu.com von der Risikokontrolle blockiert. Dieses Projekt nutzt die von der Xueqiu-App verwendete Domain api.xueqiu.com – ohne Login lassen sich Aktien-Diskussionen, Ankündigungen/News, heiße Beiträge und Kommentare lesen. Der HTML-Code von Beitragstexten wird zu reinem Text bereinigt.

• Keine Konfiguration nötig: Anonyme Tokens werden automatisch abgerufen und erneuert. Nach der Installation sofort nutzbar – kein Cookie, keine Registrierung erforderlich.

• Aktienauswahl-Kennzahlen in Echtzeit synchronisiert: Die Kennzahlenliste des Aktienfilters wird direkt von der offiziellen Xueqiu-Metadaten-Schnittstelle gelesen. Wenn Xueqiu Kennzahlen anpasst, wird dieses Projekt nicht veraltet.

• Bewältigt Last auf kleinen Maschinen: Gestufter TTL-Cache + Zusammenführung paralleler Anfragen + HTTP/2-Multiplexing. In realer Umgebung gemessen: wiederholte Abfragen 15,8× schneller, 90 % weniger Anfragen an Xueqiu, residenter Speicher ca. 75 MB. Details unter Leistung und Parallelität.

Related MCP server: AgentSkills MCP

Installation

uv venv --python 3.12 && uv pip install -e .

Für eine 2–3× schnellere Verarbeitung großer JSON-Daten (z. B. 500 K-Linien) kann orjson mitgenommen werden:

uv pip install -e ".[fast]"

Anbindung an Claude Code

Im Projektverzeichnis ausführen:

claude mcp add xueqiu -- "$(pwd)/.venv/bin/xueqiu-mcp"

Anbindung an Claude Desktop / andere Clients

Unter macOS kann direkt das Installationsskript ausgeführt werden. Es wartet automatisch, bis Claude vollständig beendet ist (ein laufendes Claude überschreibt die Datei mit seiner In-Memory-Konfiguration), sichert die ursprüngliche Konfiguration und ändert/ergänzt nur den Eintrag xueqiu, ohne andere vorhandene MCPs anzutasten:

./install-claude-desktop.sh

Bei manueller Konfiguration wird die Konfigurationsdatei bearbeitet (bei Claude Desktop unter ~/Library/Application Support/Claude/claude_desktop_config.json), und command wird durch den absoluten Pfad von .venv/bin/xueqiu-mcp ersetzt:

{
  "mcpServers": {
    "xueqiu": {
      "command": "/绝对路径/.venv/bin/xueqiu-mcp"
    }
  }
}

Wenn der Projektpfad Leerzeichen oder chinesische Zeichen enthält, unbedingt den vollständigen absoluten Pfad als String verwenden und nicht in args aufteilen.

Tool-Übersicht

Suche und Kurse

Finanzen

Unternehmensdaten

Kapitalseite

Markt und Aktienauswahl

Community-Forum

Codeschreibweise

Es kann auch direkt der chinesische Name übergeben werden (z. B. „贵州茅台"), das Tool sucht dann zuerst und holt danach die Daten.

Verwendungsbeispiele

Dem Modell direkt sagen:

• „Wie sind die aktuellen Finanzkennzahlen von Moutai?"

• „Filtere mir A-Aktien mit KGV unter 20, Dividendenrendite über 3 % und Marktkapitalisierung über 100 Milliarden"

• „Schau, wie man auf Xueqiu über CATL diskutiert"

• „Vergleiche Bruttomarge und ROE von Kweichow Moutai und Wuliangye der letzten drei Jahre"

• „Hat Tencent heute irgendwelche Ankündigungen?"

Die Filtersyntax des Aktienfilters:

filters="pettm:0~20,dy_l:3~,mc:100000000000~"

Das heißt KGV 0–20, Dividendenrendite über 3 %, Marktkapitalisierung über 100 Milliarden. Grenzen können leer bleiben für „unbegrenzt". Kennzahlenamen können mit list_screener_metrics abgefragt werden, das Suffix _l bedeutet „letzter Berichtszeitraum".

Optional: Eigenes Cookie konfigurieren

Die allermeisten Funktionen funktionieren anonym. Für die wenigen Schnittstellen, die einen Login-Zustand benötigen (z. B. Nutzerprofil-Details), kann eine Umgebungsvariable konfiguriert werden:

export XUEQIU_COOKIE="从浏览器开发者工具复制的完整 Cookie"

In der MCP-Konfiguration schreibt man dann:

{
  "mcpServers": {
    "xueqiu": {
      "command": "/绝对路径/.venv/bin/xueqiu-mcp",
      "env": { "XUEQIU_COOKIE": "..." }
    }
  }
}

Bereitstellung auf einem Server

Standardmäßig startet es über stdio, ein Prozess bedient nur einen Client. Um auf einer Maschine mehrere Personen/Clients gleichzeitig zu bedienen, auf streamable-http umstellen:

XUEQIU_TRANSPORT=streamable-http XUEQIU_HOST=0.0.0.0 XUEQIU_PORT=8000 \
  .venv/bin/xueqiu-mcp

Der Client verbindet sich mit http://<Adresse>:8000/mcp. Dieser Modus ist standardmäßig zustandslos – der Server hält keine Sitzungen für Clients, der Speicher wächst nicht mit der Verbindungszahl, und horizontale Skalierung über mehrere Repliken ist einfach.

Xueqiu hat keine offizielle offene Plattform. Vor öffentlicher Freigabe bitte selbst Authentifizierung und Raten-Limits ergänzen und nicht die Anfragelast anderer auf Xueqiu abwälzen.

Leistung und Parallelität

Alle Ressourcenparameter können über Umgebungsvariablen gesenkt werden, passend für Maschinen mit wenig Speicher:

Der Cache ist nach Endpoint gestuft: Kurse 3 Sekunden, K-Linien 30 Sekunden, Finanzberichte 1 Stunde, Unternehmensdaten 6 Stunden, Branchenklassifikation und Filterkennzahlen 24 Stunden. Bei parallelen Anfragen zu denselben Daten wird nur eine Anfrage hinausgeschickt, die übrigen warten auf deren Ergebnis.

Messwerte

Die folgenden Zahlen stammen aus Messungen in realer Umgebung (gegen echte Xueqiu-Schnittstellen, während der A-Aktien-Handelszeiten, insgesamt ca. 1.500 Anfragen):

Der Engpass liegt nicht in diesem Projekt: stock.xueqiu.com hat einen Median von 40,4 ms pro Anfrage, api.xueqiu.com (Community) 84,8 ms, während dieses Projekt selbst nur 4,4 ms ausmacht.

Der Gewinn kommt hauptsächlich von Cache und Anfrage-Zusammenführung, an zweiter Stelle von HTTP/2-Multiplexing bei Kaltverbindungs-Bursts. Der reine Pipeline-Durchsatz (Cache aus) ist ungefähr gleich wie vor der Optimierung – nicht erwarten, dass es dadurch schneller wird.

tests/bench.py testet gegen einen lokalen Mock-Upstream (Mock-Maßstab, entspricht nicht der realen Leistung), der Zweck ist Regressionserkennung, nicht Leistungsbehauptung:

.venv/bin/python tests/bench.py            # 默认模拟 30ms 网络延迟
MOCK_RTT=0 .venv/bin/python tests/bench.py # 零延迟，放大纯代码开销

Bewertungshinweis: Auf die Upstream-Anfragezahl und die Spitzenparallelität achten, ob sie den Erwartungen entsprechen. Die QPS-Zahl wird stark vom Scheduling-Overhead des Mock-Servers selbst beeinflusst; dass QPS bei steigender Parallelität auf der lokalen Loopback-Verbindung sinkt, ist ein Artefakt der Testumgebung und bedeutet nicht, dass der getestete Code fehlerhaft ist.

Die Cache-Schicht hat zusätzlich eine Gruppe von netzwerkfreien Regressionstests, die Anfrage-Zusammenführung, Abbruch-Weitergabe, LRU-Verdrängung und Byte-Buchführung abdecken:

.venv/bin/python tests/test_cache.py

Bekannte Grenzen

• Das Parallelitäts-Gate ist kein Raten-Limiter. Es begrenzt nur die „gleichzeitig in Bearbeitung befindlichen Anfragen", nicht die Anfragen pro Zeiteinheit. Nach den gemessenen Latenzen erlaubt 32 Parallelität theoretisch ca. 700 req/s gegen Xueqiu. Bitte das Tempo aufruferseitig selbst steuern.

• In realer Umgebung nur bis 32 Parallelität verifiziert, für höhere Parallelität gibt es keine realen Daten.

• XUEQIU_CACHE_MB ist eine eher optimistische Schätzung; gemessen beträgt das reale Speicherwachstum etwa das 1,2–1,9-Fache dieses Werts (bei vielen kleinen Einträgen eher höher). Für Maschinen mit wenig Speicher werden 8 empfohlen.

Tests

.venv/bin/python tests/test_mcp_e2e.py

Dieses Skript verbindet sich als echter MCP-Client über stdio mit diesem Server, listet alle Tools auf und ruft jedes einzeln real auf (inkl. chinesischer Namensauflösung, Indizes/ETFs/Wandelanleihen sowie Fehlermeldungen der Parameterprüfungen) und gibt am Ende die Anzahl der bestandenen aus.

Projektstruktur

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    论坛：讨论、公告新闻、热帖、评论

Hinweise

• Alle Daten stammen aus öffentlichen Xueqiu-Schnittstellen, Kurse können verzögert sein, stellen keine Anlageberatung dar.

• Dieses Projekt dient nur dem Lernen und der Forschung. Bitte die Nutzungsbedingungen von Xueqiu einhalten und hochfrequente Anfragen vermeiden.

• Die Xueqiu-Schnittstelle ist keine offizielle offene Plattform; Felder und Verfügbarkeit können sich jederzeit ändern.