
Fundamentals & Valuation
edinet-mcp
edinet-mcp is a CLI-driven Skill for retrieving and analyzing Japanese public company financial statements from EDINET (金融庁). It discovers companies by name or 証券コード, extracts XBRL-based income statements (PL), balance sheets (BS), and cash flow statements (CF), and normalizes 161 labels across J-GA
Overview
edinet-mcp is a CLI-driven Skill for retrieving and analyzing Japanese public company financial statements from EDINET (金融庁).
edinet-mcp is a CLI-driven Skill for retrieving and analyzing Japanese public company financial statements from EDINET (金融庁). It discovers companies by name or 証券コード, extracts XBRL-based income statements (PL), balance sheets (BS), and cash flow statements (CF), and normalizes 161 labels across J-GAAP, IFRS, and US-GAAP to enable cross-standard comparisons. Key features include company search, period-to-period XBRL diff, multi-company screening and sorting by metrics (ROE, profit margins, etc.), and output in JSON or CSV for downstream analysis. Typical use cases are investor screening, financial analyst modeling, accounting reviews, and research into trends or cash-flow patterns. The core advantage is automated normalization and programmatic access to EDINET filings, speeding comparative analysis and reducing manual reconciliation work.
Skill.md
How this skill works
edinet-mcp is a CLI-driven Skill for retrieving and analyzing Japanese public company financial statements from EDINET (金融庁). It discovers companies by name or 証券コード, extracts XBRL-based income statements (PL), balance sheets (BS), and cash flow statements (CF), and normalizes 161 labels across J-GA
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
# 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
# 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)
# 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
edinet-mcp test
Statement types
| Type | Japanese | Key items |
|---|---|---|
income_statement | 損益計算書 (PL) | 売上高, 営業利益, 純利益 |
balance_sheet | 貸借対照表 (BS) | 総資産, 純資産, 負債 |
cash_flow_statement | CF計算書 | 営業CF, 投資CF, 財務CF |
Workflow
edinet-mcp search <company>→ find EDINET codeedinet-mcp statements -c <code> -p <year>→ view financial dataedinet-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_KEYenvironment variable - Free API key: https://disclosure2dl.edinet-fsa.go.jp/
- Python package:
pip install edinet-mcporuv tool install edinet-mcp
Best used for
When to use it
edinet-mcp is a CLI-driven Skill for retrieving and analyzing Japanese public company financial statements from EDINET (金融庁). It discovers companies by name or 証券コード, extracts XBRL-based income statements (PL), balance sheets (BS), and cash flow statements (CF), and normalizes 161 labels across J-GA

01 · PRE-MEETING
Prepare a decision brief
Turn scattered evidence into a structured case before an investment committee meeting.

02 · TEAM WORKFLOW
Standardize handoffs
Create consistent research outputs across analysts, portfolio managers, and agents.

03 · LIVE UPDATE
Refresh the thesis
Update scenarios after a new catalyst, KPI release, or earnings result.
Community notes
Built to improve with use.
Feedback will appear here as this skill is used and reviewed.
Discover more
Related skills
View allIndustry Primer
Analyze an industry's structure, profit pools, key players, supply chain, and regime drivers. Use when starting research on an industry, mapping market structure, or framing sector-level opportunity…
Bear Case Builder
Stress test consensus with bearish counter-narratives, failure modes, and probability-severity analysis. Use when building downside cases, short theses, or risk scenarios against a bullish narrative.
Business Model Comp Matching
Match a company to the right peer set by business model, revenue mix, margin structure, and economics. Use when standard comp sets are misleading or when the user asks for more precise peer selection.