edinet-mcp

# EDINET: Japanese Financial Statement Analysis Search Japanese public companies and analyze their financial statements via EDINET (金融庁 電子開示システム). Supports income statements (PL/損益計算書), balance sheets (BS/貸借対照表), and cash flow statements (CF/キャッシュ・フロー計算書) with 161 normalized labels across J-GAAP, IFRS, and US-GAAP. ## Use Cases - Look up any Japanese public company by name or stock code (証券コード) - Retrieve and compare income statements across companies - Analyze balance sheet composition and trends - Review cash flow patterns (operating, investing, financing) - Compare financials across different accounting standards (J-GAAP/IFRS/US-GAAP) - Screen multiple companies by ROE, profit margins, and other metrics ## Commands ### Search companies ```bash # Search by company name (Japanese or English) edinet-mcp search トヨタ edinet-mcp search ソニー # Search by stock code edinet-mcp search 7203 --limit 5 --json-output ``` ### Financial statements ```bash # Income statement for Toyota (E02144), filed in 2024 edinet-mcp statements -c E02144 -p 2024 -s income_statement --format json # Balance sheet edinet-mcp statements -c E02144 -p 2024 -s balance_sheet --format json # Cash flow statement edinet-mcp statements -c E02144 -p 2024 -s cash_flow_statement --format json # All statements as CSV edinet-mcp statements -c E02144 -p 2024 --format csv ``` ### Screen companies (compare metrics) ```bash # Compare Toyota, Sony, Honda by financial metrics edinet-mcp screen E02144 E01777 E02529 # Sort by ROE edinet-mcp screen E02144 E01777 E02529 --sort-by ROE # JSON output edinet-mcp screen E02144 E01777 --format json ``` ### Test connectivity ```bash edinet-mcp test ``` ### Statement types | Type | Japanese | Key items | |---|---|---| | `income_statement` | 損益計算書 (PL) | 売上高, 営業利益, 純利益 | | `balance_sheet` | 貸借対照表 (BS) | 総資産, 純資産, 負債 | | `cash_flow_statement` | CF計算書 | 営業CF, 投資CF, 財務CF | ## Workflow 1. `edinet-mcp search <company>` → find EDINET code 2. `edinet-mcp statements -c <code> -p <year>` → view financial data 3. `edinet-mcp screen <code1> <code2> ...` → compare multiple companies ## Important - The `-p` (period) parameter is the **filing year**, not the fiscal year. March-end companies file in June of the next year: FY2023 data → `-p 2024`. - 161 normalized labels across J-GAAP / IFRS / US-GAAP. - Results include 当期 (current) and 前期 (prior) periods. - Rate-limited to 0.5 req/sec by default. Screening 10 companies takes ~1-2 minutes. - Maximum 20 companies per screen request. ## Setup - Requires `EDINET_API_KEY` environment variable - Free API key: https://disclosure2dl.edinet-fsa.go.jp/ - Python package: `pip install edinet-mcp` or `uv tool install edinet-mcp`