Metadata-Version: 2.4
Name: jpfin
Version: 0.12.0
Summary: Unified CLI for Japanese equity factor analysis
Project-URL: Homepage, https://github.com/ajtgjmdjp/jpfin
Project-URL: Repository, https://github.com/ajtgjmdjp/jpfin
Author: ajtgjmdjp
License-Expression: Apache-2.0
Keywords: EDINET,cli,factor,finance,japan,quant,yfinance
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business :: Financial :: Investment
Requires-Python: >=3.10
Requires-Dist: click>=8.0
Requires-Dist: japan-finance-codes>=0.2.0
Requires-Dist: japan-finance-events>=0.1.0
Requires-Dist: japan-finance-factors[all]>=0.2.1
Requires-Dist: yfinance>=0.2
Description-Content-Type: text/markdown

# jpfin

Unified CLI for Japanese equity factor analysis.

Integrates [japan-finance-factors](https://pypi.org/project/japan-finance-factors/), [edinet-mcp](https://pypi.org/project/edinet-mcp/), [stockprice-mcp](https://pypi.org/project/stockprice-mcp/), and [japan-finance-codes](https://pypi.org/project/japan-finance-codes/) into a single command.

## Install

```bash
pip install jpfin
```

## Usage

```bash
# Analyze a single ticker
jpfin analyze 7203

# Multiple tickers
jpfin analyze 7203 6758 9984

# JSON output
jpfin analyze 7203 --format json

# Specify fiscal year
jpfin analyze 7203 --year 2024
```

## Features

- **18 quantitative factors** across 5 categories (value, quality, momentum, risk, size)
- **Point-in-time (PIT) safety** — no lookahead bias
- **Auto-resolution** of ticker → EDINET code
- **Market cap** from yfinance merged into financial data
- **Table and JSON** output formats

## Environment Variables

- `EDINET_API_KEY` — Required for financial data from EDINET

## License

Apache-2.0
