edinet-mcp

What This Skill Does

The edinet-mcp skill is a specialized agent capability designed to provide direct, programmatic access to Japanese public company financial information via the Financial Services Agency (FSA) EDINET system. By normalizing XBRL data across J-GAAP, IFRS, and US-GAAP standards, it translates complex securities filings into actionable financial intelligence. This tool enables OpenClaw to perform deep analysis on income statements (PL), balance sheets (BS), and cash flow statements (CF) for any company registered on the Tokyo Stock Exchange or other Japanese markets.

Installation

To integrate this skill into your OpenClaw environment, ensure you have an API key obtained from the EDINET official portal. Run the following command in your terminal:

clawhub install openclaw/skills/skills/ajtgjmdjp/edinet-mcp

Ensure that the environment variable EDINET_API_KEY is set in your system configuration before attempting to initialize the skill. You can install the underlying package via pip install edinet-mcp or uv tool install edinet-mcp.

Use Cases

• Fundamental Analysis: Retrieve precise financial statement data to calculate valuation ratios or growth trends.
• Competitive Benchmarking: Simultaneously pull data for multiple industry competitors to compare margins, ROE, and asset structures.
• Automated Financial Reporting: Generate summaries of fiscal performance directly from source filings.
• Portfolio Screening: Compare financial health metrics across a custom list of Japanese stocks to identify high-performing companies.

Example Prompts

1. "Look up the stock code for Nintendo and retrieve its income statement for 2024."
2. "Compare the cash flow statements of Sony (E01777) and Toyota (E02144) for the most recent filing year. What are the key differences in their operating cash flow?"
3. "Screen the following companies by ROE: 7203, 6758, and 7974. Output the result in JSON format."

Tips & Limitations

• Timing: Note that the period parameter -p refers to the filing year. Because of the Japanese fiscal calendar, companies closing in March typically file their primary reports in June of the following year (e.g., FY2023 financial reports will appear under filing year 2024).
• Performance: The tool is subject to a rate limit of 0.5 requests per second. Large screening tasks (10+ companies) are performed sequentially and may take 1-2 minutes. Avoid aggressive polling to ensure API stability.
• Scope: It strictly handles public filings found on EDINET. It does not provide real-time stock price data, only historical financial statement data.