jquants-mcp

通过 J-Quants API 访问 JPX 股票市场数据 — 搜索股票、获取每日 OHLCV 价格、财务摘要（收入、利润、每股收益、股本回报率）以及东京证券交易所 (TSE) 上市公司的收益日历。日本股票价格数据。

# J-Quants: JPX Stock Market Data

Access Tokyo Stock Exchange (TSE) listed stock data via the official J-Quants API. Search stocks, get daily OHLCV prices, financial summaries, and earnings announcement calendar.

**Important: This tool is for personal use only.** Data redistribution is prohibited by J-Quants Terms of Service. https://jpx-jquants.com/termsofservice

## Use Cases

- Search for TSE-listed stocks by code or company name
- Get daily OHLCV price data for any stock
- Retrieve financial summaries (revenue, profit, EPS, ROE)
- Check upcoming earnings announcement dates
- Compare financial metrics across companies

## Commands

### Search stocks
```bash
# By stock code
jquants-mcp search 7203

# By company name (Japanese)
jquants-mcp search トヨタ

# JSON output
jquants-mcp search ソニー --json-output
```

### Get stock prices
```bash
# Default: last 30 days
jquants-mcp price 7203

# With date range
jquants-mcp price 7203 --start-date 2024-01-01 --end-date 2024-12-31

# JSON output
jquants-mcp price 7203 --json-output
```

### Get financial data
```bash
jquants-mcp financials 7203
jquants-mcp financials 6758 --json-output
```

### Get earnings calendar
```bash
# Default: next 30 days
jquants-mcp calendar

# With date range
jquants-mcp calendar --start-date 2024-04-01 --end-date 2024-06-30
```

### Test connectivity
```bash
jquants-mcp test
```

## Workflow

1. `jquants-mcp search <company>` → find stock code
2. `jquants-mcp price <code>` → get price history
3. `jquants-mcp financials <code>` → get financial data
4. `jquants-mcp calendar` → check earnings dates

## Setup

- Requires `JQUANTS_MAIL_ADDRESS` and `JQUANTS_PASSWORD` environment variables
- Free account registration: https://jpx-jquants.com/
- Python package: `pip install jquants-mcp` or `uv tool install jquants-mcp`

## Terms of Service

By using this tool, you agree to the J-Quants Terms of Service.
Data is for personal use only — redistribution is prohibited.

---

## 中文说明

# J-Quants：JPX 股票市场数据

通过官方 J-Quants API 访问东京证券交易所（TSE）上市股票数据。搜索股票、获取每日 OHLCV 价格、财务摘要以及收益公告日历。

**重要：此工具仅供个人使用。** J-Quants 服务条款禁止数据再分发。https://jpx-jquants.com/termsofservice

## 使用场景

- 通过代码或公司名称搜索 TSE 上市股票
- 获取任意股票的每日 OHLCV 价格数据
- 检索财务摘要（收入、利润、EPS、ROE）
- 查看即将到来的收益公告日期
- 跨公司比较财务指标

## 命令

### 搜索股票
```bash
# 按股票代码
jquants-mcp search 7203

# 按公司名称（日语）
jquants-mcp search トヨタ

# JSON 输出
jquants-mcp search ソニー --json-output
```

### 获取股票价格
```bash
# 默认：最近 30 天
jquants-mcp price 7203

# 带日期范围
jquants-mcp price 7203 --start-date 2024-01-01 --end-date 2024-12-31

# JSON 输出
jquants-mcp price 7203 --json-output
```

### 获取财务数据
```bash
jquants-mcp financials 7203
jquants-mcp financials 6758 --json-output
```

### 获取收益日历
```bash
# 默认：未来 30 天
jquants-mcp calendar

# 带日期范围
jquants-mcp calendar --start-date 2024-04-01 --end-date 2024-06-30
```

### 测试连通性
```bash
jquants-mcp test
```

## 工作流程

1. `jquants-mcp search <company>` → 查找股票代码
2. `jquants-mcp price <code>` → 获取价格历史
3. `jquants-mcp financials <code>` → 获取财务数据
4. `jquants-mcp calendar` → 查看收益日期

## 设置

- 需要 `JQUANTS_MAIL_ADDRESS` 和 `JQUANTS_PASSWORD` 环境变量
- 免费账户注册：https://jpx-jquants.com/
- Python 包：`pip install jquants-mcp` 或 `uv tool install jquants-mcp`

## 服务条款

使用此工具即表示你同意 J-Quants 服务条款。
数据仅供个人使用 — 禁止再分发。