jquants-mcp

核心用法

jquants-mcp 是一个面向东京证券交易所（TSE）上市公司的数据查询技能，通过官方 J-Quants API 提供四类核心功能：股票代码搜索（支持日文名称模糊匹配）、历史价格数据获取（默认30天OHLCV）、财务摘要查询（营收、利润、EPS、ROE等关键指标）以及财报发布日历。用户需先注册 J-Quants 免费账号，配置 JQUANTS_MAIL_ADDRESS 和 JQUANTS_PASSWORD 环境变量，通过 uv tool install 或 pip 安装外部 CLI 工具后即可使用。

显著优点

官方数据源权威性：直接对接日本交易所集团（JPX）官方 API，数据质量与实时性有保障，覆盖全 TSE 上市公司。 零代码门槛：纯 CLI 交互设计，无需编写程序即可完成专业级金融数据查询，适合非技术背景投资者。 结构化输出支持：所有命令均支持 --json-output 参数，便于对接 Excel、Python pandas 等分析工具进行二次处理。 合规性前置告知：文档明确标注数据仅限个人使用，附服务条款链接，降低用户法律风险。

潜在缺点与局限性

地域与语言限制：仅覆盖日本市场，股票搜索虽支持日文，但对非日语用户存在使用门槛。 功能深度不足：缺乏技术指标计算（如 MA、RSI）、可视化图表生成、批量股票对比等进阶分析功能，需用户自行处理原始数据。 依赖外部工具：核心功能完全依赖第三方 CLI 工具 jquants-mcp，该工具非本 skill 内置，版本更新、兼容性、长期维护均不受控。 无缓存机制：每次查询均实时调用 API，高频使用可能触发速率限制，且无法离线分析历史数据。

适合的目标群体

• 关注日本市场的个人投资者与量化研究爱好者
• 需要快速获取 TSE 基础数据用于 Excel 建模的财务分析师
• 学习金融数据分析、希望以真实市场数据练习的学生群体
• 已有 J-Quants 账号、不愿维护复杂爬虫的轻量级用户

使用风险

依赖项风险：jquants-mcp CLI 工具由社区维护，未经过 T1/T2 级别来源审计，存在供应链攻击或恶意代码注入可能，建议安装前审查源码。 凭据泄露风险：API 密码以明文环境变量存储，在多用户服务器或 CI/CD 环境中易泄露，需配合密钥管理服务使用。 合规风险：J-Quants 明确禁止数据再分发，若用户误将查询结果用于商业报告或公开分享，可能面临账号封禁或法律追责。 服务连续性风险：J-Quants 免费套餐存在 API 调用频次限制，且官方可能调整服务条款或终止免费 tier，影响长期可用性。