核心功能与用法
jquants-mcp 是一款面向东京证券交易所（TSE）上市股票的数据查询工具，基于日本交易所集团（JPX）官方 J-Quants API 构建。用户可通过命令行完成以下四类核心操作：
1. 股票搜索：支持按 4 位股票代码或日文公司名检索，返回代码、名称、交易所板块等基础信息。
2. 行情数据：获取指定股票的日 K 线数据（Open/High/Low/Close/Volume），默认返回近 30 日，支持自定义起止日期。
3. 财务摘要：提取营收、净利润、EPS、ROE 等关键财务指标，便于快速横向对比。
4. 财报日历：查询未来 30 天内的业绩发布日期，支持自定义时间区间。
使用流程遵循「搜索 → 行情 → 财务 → 日历」的标准工作流，输出支持结构化 JSON，便于对接量化分析或自动化脚本。
显著优点
- 官方数据源：直接对接 JPX 旗下 J-Quants，数据权威性高，覆盖全 TSE 上市股票。
- 轻量化 CLI：纯命令行交互，无需编写代码即可获取数据，适合快速验证和脚本集成。
- 多格式输出：支持人类可读表格与机器友好的 JSON 双模式。
- 免费账户可用：J-Quants 提供免费注册层级，降低个人投资者使用门槛。
潜在局限与风险
- 个人使用限制：J-Quants 服务条款明确禁止数据再分发，商业用途或向第三方提供数据存在合规风险。
- 认证依赖：需配置邮箱与密码环境变量，密钥管理不当可能导致账户泄露。
- 地域与语言限制：搜索功能对日文关键字支持更佳，英文或拼音检索体验可能受限。
- 速率与配额：免费 API 存在调用频率与数据量限制，高频或大规模回测可能触发限流。
适合人群
- 关注日本股市的量化研究员与个人投资者
- 需要自动化获取 TSE 基本面与行情数据的开发者
- 希望快速验证日本公司财务数据的分析师
常规风险提示
- 合规风险：严格遵守「个人使用 only」条款，避免将数据写入公开数据库或商业产品。
- 账户安全：建议将凭证存放于本地环境变量或密钥管理工具，禁止硬编码于代码仓库。
- 数据时效性：API 返回的财务数据存在滞后，重大事件前后需交叉核对官方披露。