← Back to Skills Marketplace
1233
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install edinet-mcp
Description
Analyze and compare Japanese public company financial statements (BS, PL, CF) from EDINET using company name or stock code with J-GAAP, IFRS, and US-GAAP data.
README (SKILL.md)
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 \x3Ccompany>→ find EDINET codeedinet-mcp statements -c \x3Ccode> -p \x3Cyear>→ view financial dataedinet-mcp screen \x3Ccode1> \x3Ccode2> ...→ 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
Usage Guidance
This skill appears coherent for querying EDINET. Before installing: 1) Verify the edinet-mcp package source (pip/uv registry or project repo) and review code or maintainer reputation if possible—installing third-party binaries carries risk. 2) Use a dedicated EDINET_API_KEY and avoid exposing higher-privilege credentials; rotate it if you suspect compromise. 3) Note the skill will run the edinet-mcp binary; run installs in a controlled environment (not as root) if you cannot audit the package. 4) If you want to reduce automation risk, keep disable-model-invocation in mind (the platform default allows agent-initiated use).
Capability Analysis
Type: OpenClaw Skill
Name: edinet-mcp
Version: 0.6.0
The skill bundle appears benign. It provides a tool for analyzing Japanese financial statements, requiring an `EDINET_API_KEY` for legitimate API access. The `SKILL.md` file contains standard instructions for installation and usage of the `edinet-mcp` binary, with no evidence of prompt injection attempts, data exfiltration, persistence mechanisms, or other malicious activities. All commands shown are directly related to the stated purpose of financial data analysis.
Capability Assessment
Purpose & Capability
Name/description (EDINET XBRL financial analysis) align with the declared requirements: a CLI binary named edinet-mcp and an EDINET_API_KEY. Those are expected for a tool that calls EDINET.
Instruction Scope
SKILL.md only instructs running the edinet-mcp CLI (search, statements, screen, test) against EDINET and explains parameters and rate limits. It does not ask the agent to read unrelated files, access unrelated environment variables, or exfiltrate data to unexpected endpoints.
Install Mechanism
Install uses an 'uv' package spec (uv install edinet-mcp) that will create an edinet-mcp binary. This is a standard package install path in the skill metadata, not a direct URL download; still, installing any third-party binary writes code to disk, so verify the package source before installing.
Credentials
Only EDINET_API_KEY is required, which is appropriate and expected for accessing the EDINET disclosure API. No unrelated secrets or multiple credentials are requested.
Persistence & Privilege
The skill is not configured as always:true and does not request edits to other skills or system-wide settings. It requires a binary to run but does not demand elevated or persistent platform privileges beyond normal installation.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install edinet-mcp - After installation, invoke the skill by name or use
/edinet-mcp - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.6.0
Add CLI diff command, export diff_statements, Japan Finance Data Stack links
v0.5.0
Version 0.5.0 of edinet-mcp
- No file changes detected in this release.
- Documentation and usage details remain unchanged.
v0.4.1
Version 0.4.1 of edinet-mcp
- No file changes detected in this release.
- All features and documentation remain unchanged.
v0.4.0
edinet-mcp 0.4.0 Changelog
- Added comprehensive usage guide in SKILL.md, including sample commands for searching companies and retrieving financial statements.
- Clarified statement types (income, balance sheet, cash flow) and key items for each, with Japanese and English terms.
- Noted support for all major accounting standards (J-GAAP, IFRS, US-GAAP) with 161 normalized labels.
- Explained how to interpret the period (`-p`, filing year) parameter for accurate data retrieval.
- Provided clear setup instructions, including API key requirement and installation methods.
Metadata
Frequently Asked Questions
What is Edinet Mcp?
Analyze and compare Japanese public company financial statements (BS, PL, CF) from EDINET using company name or stock code with J-GAAP, IFRS, and US-GAAP data. It is an AI Agent Skill for Claude Code / OpenClaw, with 1233 downloads so far.
How do I install Edinet Mcp?
Run "/install edinet-mcp" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Edinet Mcp free?
Yes, Edinet Mcp is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Edinet Mcp support?
Edinet Mcp is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Edinet Mcp?
It is built and maintained by ajtgjmdjp (@ajtgjmdjp); the current version is v0.6.0.
More Skills