hhxg A-share Market Data

Dữ liệu thị trường cổ phiếu hạng A Trung Quốc, công cụ sàng lọc cổ phiếu và nghiên cứu qua MCP từ xa. Yêu cầu đăng ký trả phí. Chỉ phục vụ nghiên cứu, không phải lời khuyên đầu tư.

Máy chủ MCP được lưu trữ

npx add-mcp 'https://hhxg.top/mcp/rpc'

Cài vào Claude Code, Codex, Cursor và nhiều công cụ khác

Tài liệu

能做什么

功能一句话可以这样问
数据目录 discover_data列出站内有哪些数据集、字段含义与取数方式。「站里有哪些和龙虎榜有关的数据?」
通用取数 query_dataset按数据集取数:选列、按日期或区间回溯、按股票代码取。「拉最近一个月的融资融券余额。」
券商研报 / 公告 / 新闻检索 search_documents券商研报、机构调研纪要、公告、新闻、董秘问答统一检索,最长回看 90 天。「最近一周固态电池有哪些研报和公告?」
读单篇 get_document读检索结果里某一篇的摘要或分节内容(券商研报仅摘要)。「把第 2 篇的要点讲一下。」
条件选股与策略预设 screen_stocks按指标条件筛全市场,支持两个指标互相比较,也可直接用策略预设。「筛出收盘价站上 20 日线且放量的股票。」
个股诊断 diagnose_stock一只股票的行情、资金、异动与题材归属证据。「诊断一下 600519。」
连板晋级预测 predict_lianban_promotion估计连板股次日晋级的概率。「今天的 3 连板明天晋级概率多大?」
盘中实时 get_realtime交易时段约 1 分钟一帧:涨跌停池、个股最新价与指标、按盘中值筛选。「现在涨停多少家?炸板率多少?」

另有只读资料(数据集说明、投资日历、知识库)与现成的提问套路(每日复盘 / 个股诊断 / 板块轮动),含参数的完整清单见 /mcp/info 。

Max 会员专属 AI 接入只对 Max 会员开放(Max 月付 ¥99/30 天起,含商用许可)。价格与各档权益对比见 会员页 。

三步接入

1. 选客户端

选你在用的 AI 客户端(已核对 15 个客户端的写法),后两步只显示所选客户端的做法。

推荐 国产 国际 其他

2. 生成 AI 接入 Token

登录 Max 会员后生成一个 AI 接入 Token,MCP 与 REST 数据 API 共用;支持授权登录的客户端可以跳过这一步,按第 3 步直接授权。

直接授权,免 Token :这个客户端支持授权登录——按第 3 步连接时会跳到恢恢量化, 用会员码登录并授权(Max 权益),完成后自动回到客户端。每个授权占 1 个 Token 名额, 显示在下方列表里( OAuth · 客户端名 ),可随时撤销;名额满时再授权会自动替换最早的一个授权 (手工 Token 不受影响)。

3. 复制配置并验证

把所选客户端的配置片段复制到它的配置位置(生成 Token 后会自动填进片段),再按下面的验证方法确认接通。

安装在 DSH 的插件安装入口输入这个 GitHub 地址

https://github.com/Niceck/dsh-hhxg-market

插件把 Token 写进 profile 的 cordis.patch.yml,保存后重启 DSH 生效

# ~/.dsh/profiles/<profile>/cordis.patch.yml
- update:
    - id: hhxg-market
      config:
        mcpToken: "<您的Token>"
# 从终端启动 DSH 也可以不改文件:export HHXG_MCP_TOKEN="<您的Token>"
# 不装插件、原生 MCP 直连:https://hhxg.top/mcp/rpc,请求头 Authorization: Bearer <您的Token>

DSH 暂不提供本插件的设置界面,Token 只能写配置文件或环境变量(从图形界面启动的 DSH 不一定继承 shell 环境变量)。

命令行安装

npm

dsh plugin --profile web add @hhxg/dsh-hhxg-market

GitHub

dsh plugin --profile web add github:Niceck/dsh-hhxg-market

国内网络下载慢,可先执行 npm config set registry https://registry.npmmirror.com 切到 npmmirror 镜像(全局生效,改回官方源: npm config delete registry )。

实测: 我把选股条件直接「说」给 AI,它不但筛完全市场,还自己设计了 5 套策略

DeepSeek 官方文档

验证:在客户端里问一句「今天涨停多少家?」,能返回带日期的数据即接通。

用命令行验证(MCP Inspector)

npx @modelcontextprotocol/inspector https://hhxg.top/mcp/rpc \
  --header "Authorization: Bearer <您的Token>"

能列出工具清单即连接正常;完整清单见 /mcp/info 。

支持的客户端

下面每个 AI 客户端连的都是同一个 MCP server、用同一个 AI 接入 Token;标「直接授权」的可以不填 Token,按授权登录连接。

  • DeepSeek Harness DeepSeek · 插件 · 用 Token怎么配:把 Token 写进 profile 的 cordis.patch.yml,保存后重启 DSH 生效 DeepSeek Harness 接入教程
  • Kimi Code CLI 月之暗面 · CLI · 用 Token怎么配:~/.kimi-code/mcp.json(项目级.kimi-code/mcp.json) Kimi Code CLI:看配置
  • CodeBuddy Code 腾讯 · CLI / IDE · 用 Token怎么配:~/.codebuddy/.mcp.json(或下面一条命令) CodeBuddy Code 接入教程
  • WorkBuddy 腾讯 · 桌面智能体 · 用 Token怎么配:设置 → MCP → 添加 MCP Server WorkBuddy:看配置
  • Trae 字节跳动 · IDE · 用 Token怎么配:AI 设置 → MCP → 添加 → 手动配置 Trae 接入教程
  • Qoder / 通义灵码 阿里云 · IDE · 用 Token怎么配:MCP 面板 → 手动添加(Qoder CN 即新版通义灵码) Qoder / 通义灵码:看配置
  • Qwen Code 阿里云 · CLI · 用 Token怎么配:~/.qwen/settings.json(或 qwen mcp add --transport http) Qwen Code:看配置
  • iFlow CLI(心流) 阿里 · CLI · 用 Token怎么配:终端执行(写入 ~/.iflow/settings.json) iFlow CLI(心流):看配置
  • Comate 百度 · IDE · 用 Token怎么配:~/.comate/mcp.json(项目级.comate/mcp.json) Comate:看配置
  • OpenClaw 开源 · 智能体网关 · 用 Token怎么配:终端执行,再到 Settings → MCP 给该 server 填请求头 OpenClaw:看配置
  • claude.ai Anthropic · 网页 / 桌面 · 直接授权(免 Token)怎么配:设置 → 连接器 → 添加自定义连接器,地址填下面一行,点「连接」 claude.ai:看配置
  • Claude Code Anthropic · CLI · Token 或直接授权怎么配:终端执行(写入 ~/.claude.json) Claude Code 接入教程
  • Codex CLI OpenAI · CLI · 用 Token怎么配:~/.codex/config.toml + 环境变量 Codex CLI:看配置
  • Cursor Anysphere · IDE · 用 Token怎么配:~/.cursor/mcp.json(项目级.cursor/mcp.json) Cursor 接入教程
  • Gemini CLI Google · CLI · 用 Token怎么配:~/.gemini/settings.json Gemini CLI:看配置
  • 其他 MCP 客户端 扣子 / MiniMax Agent / Cline / Windsurf 等 · 通用 · 用 Token怎么配:任何支持远程 Streamable HTTP 且可填自定义请求头的客户端 其他 MCP 客户端:看配置

脚本取数

REST 数据 API · 适合脚本批量取数与 CSV 直链

不经 AI 客户端、想用脚本直接拉 JSON 时用 REST 接口 GET /api/data/<scope> :用的是上面同一个 AI 接入 Token,放在 Authorization: Bearer 请求头里。

curl -H "Authorization: Bearer <您的Token>" \
  https://hhxg.top/api/data/snapshot

统一信封 { success, scope, description, fetched_at, source, data } ( source : news_live = 服务器直出、 static = 站点静态文件);带月度归档的 scope 加 ?month=YYYYMM 返回 CSV 直链; GET /api/data/index 列出全部 scope。完整契约见 OpenAPI 规范 。

通过授权登录(OAuth)连接的客户端令牌不能用于脚本取数,请生成 AI 接入 Token。

端点范围(共 23 个 scope)

scope内容月度归档计划更新
snapshot日报快照:赚钱效应/题材/连板天梯/游资/行业/焦点新闻聚合—交易日 20:22 起重算,预计 20:30 前更新完成(北京时间)
hotmoney近 7 日游资龙虎榜席位明细—交易日 20:22 起重算,预计 20:30 前更新完成(北京时间)
news近 7 日财经快讯(含 AI 利好/利空分类,支持?sentiment=利好|利空|中性|未分类 过滤)—每天 06:10–23:10 每小时采集,线上按发布窗口刷新(北京时间)
dongmi近 30 日董秘问答全量(?month=YYYYMM 取月度归档 CSV)是交易日 20:22 起重算,预计 20:30 前更新完成(北京时间)
theme-concepts题材概念成分股映射(每交易日更新)—交易日 20:22 起重算,预计 20:30 前更新完成(北京时间)
margin近 7 日融资融券余额与净买入(?month=YYYYMM 取月度归档 CSV)是交易日 09:05 采集上一交易日数据并发布(北京时间)
sentiment近 7 日市场情绪指标—交易日 20:22 起重算,预计 20:30 前更新完成(北京时间)
strategy最新量化策略选股结果—交易日 20:22 起重算,预计 20:30 前更新完成(北京时间)
themes-ranking最新题材热度排名—交易日 20:22 起重算,预计 20:30 前更新完成(北京时间)
northbound近 7 日北向资金流向—交易日 20:22 起重算,预计 20:30 前更新完成(北京时间)
breadth近 7 日大盘宽度(涨跌家数/涨停/跌停/赚钱效应)时序—交易日 20:22 起重算,预计 20:30 前更新完成(北京时间)
funds近 7 日行业/板块资金流(主力净流入/流出排名)—交易日 20:22 起重算,预计 20:30 前更新完成(北京时间)
etfETF 全景榜:规模 / 成交额 / 涨幅 / 行业 ETF 排名(?month=YYYYMM 取日线月度归档 CSV)是交易日 20:22 起重算,预计 20:30 前更新完成(北京时间)
chipwork筹码工程:筹码集中度排名、获利盘比例高/低、行业筹码概览—交易日 20:22 起重算,预计 20:30 前更新完成(北京时间)
stock-indicators个股技术指标榜:MACD/KDJ/RSI 等多维度排序与共振信号—交易日 20:22 起重算,预计 20:30 前更新完成(北京时间)
concept-chain题材概念链:每日热点概念的链式传导路径 + 龙头/分歧/补涨股映射—交易日 20:22 起重算,预计 20:30 前更新完成(北京时间)
indicator-resonance多指标共振信号:MA / MACD / RSI / 量能多周期同向信号股—交易日 20:22 起重算,预计 20:30 前更新完成(北京时间)
risk-alerts风险警报:暴跌 / 出货 / 九转见顶 / 高换手下跌 4 类预警—交易日 20:22 起重算,预计 20:30 前更新完成(北京时间)
resonance跨 KB 共振信号:技术 / 资金 / 题材 / 情绪同时确认的标的—交易日 20:22 起重算,预计 20:30 前更新完成(北京时间)
strategy-full策略历史全统计:胜率 / 月度分布 / TOP winners&losers(多策略对比)—交易日 20:22 起重算,预计 20:30 前更新完成(北京时间)
community-sentiment社区情绪:综合情绪指数(情绪周期 + 股吧文本 + 热股榜涨跌)+ 社区热议个股 + 股吧热帖—每天 09:00 / 12:00 / 21:00 采集,线上随发布窗口刷新(工作日 9 / 15 / 22 点、周末 9 / 15 / 21 点,北京时间)
moneyflow个股资金流月度归档:无参返回可用月份索引,?month=YYYYMM 取当月 CSV是交易日 20:22 起重算,预计 20:30 前更新完成(北京时间)
blocktrade大宗交易月度归档:无参返回可用月份索引,?month=YYYYMM 取当月 CSV是交易日 20:22 起重算,预计 20:30 前更新完成(北京时间)

帮助

额度与限制 · Token 安全 · 插件升级 · 许可边界

有哪些额度与限制?

  • REST 数据 API:Max 300 请求/分钟,按会员计、多个 Token 共享;超限返回 429 并带 retry_after_seconds 。
  • AI 客户端里的工具另有按工具计的额度,超限时工具会直接说明。
  • Token:Max:只签发一种「AI 接入 Token」(MCP 与数据 API 共用),最多 5 个并存(可命名),有效期至会员到期,续费后重新生成即可延长;可单个撤销,数分钟内生效;此前生成的数据 API token 到期前仍有效。
  • 历史数据:两融 / 董秘问答 / 个股资金流 / 大宗交易 / ETF 日线有月度归档,其余为最新快照或近 7–30 日窗口。
  • 不提供策略回测与分钟 K 线。

Token 泄露怎么办?

在第 2 步的 Token 列表里点「撤销」,数分钟内生效,再生成一个新的换上。

直接授权和手工 Token 有什么区别?

权限完全相同,都占 Token 名额、都能在列表里撤销。直接授权(OAuth)的令牌到期后由客户端按标准流程刷新,不用复制粘贴;手工 Token 一次生成、有效期至会员到期,适合不支持授权登录的客户端,或服务器 / CI 上长期运行的场景。

以前的数据 API token 还能用吗?

能,到期前继续有效,可在「脚本取数」里查看和撤销。现在不再单独签发:AI 接入 Token 同样能调 REST 接口,一个 Token 两边通用。

旧版 DSH 插件怎么升级?

0.7.0 之前的插件有一部分工具直接调用已于 2026-11-08 下线的公开接口,会报「数据不存在」;0.2.x 用到的旧工具名也已于 2026-10-27 下线(按旧名调用返回 TOOL_NOT_FOUND 并附替代写法)。按第 3 步重新安装一次即可升级到最新版,Token 配置不用改。

数据什么时候更新?

交易日 20:22 起重算,预计 20:30 前更新完成(北京时间);新闻 每天 06:10–23:10 每小时采集,线上按发布窗口刷新(北京时间);社区情绪 每天 09:00 / 12:00 / 21:00 采集,线上随发布窗口刷新(工作日 9 / 15 / 22 点、周末 9 / 15 / 21 点,北京时间);两融 交易日 09:05 采集上一交易日数据并发布(北京时间)。每个响应带 fetched_at ; source 标明这份数据从哪来: news_live 是服务器直出(数据更新后即可取到,不等站点重新发布), static 是站点静态文件(随站点发布更新)。不指定日期时返回最新一份数据,按日期取历史数据时指定非交易日会提示没有该日数据。

和 Tushare 这类原始数据接口有什么区别?

本站提供的是加工过的衍生数据:龙虎榜席位统计、连板天梯与晋级率、异动分层、题材热度、AI 分类新闻、日报快照等,可直接进 Agent 或看板;原始日线与财务数据请用上游接口。

AI 投研助手、自定义 API 和 AI 接入有什么区别?

三者都是 Max 权益。AI 投研助手用站方模型,在 AI 投研页 直接提问;自定义 API 自带模型令牌,在 AI 投研页驱动 Agent 调站内工具,不占站内次数;AI 接入把同一套工具接进你自己的 AI 客户端。

Pro 能用 AI 接入吗?

不能。盘后复盘数据(T 日收盘定版)、全部会员工具、CSV 导出与历史回看;不含盘中实时选股、AI 投研、自定义 API(自带模型令牌)与 MCP / 数据 API;仅限本人研究。各档权益对比见 会员页 。

许可边界

相关入口: AI 投研助手 · 数据目录 · OpenAPI 规范 · llms.txt