Neura Market
ajtgjmdjp/edinet-mcp logo

ajtgjmdjp/edinet-mcp

Free

EDINET API 集成，解析日本企业 XBRL 财务报告，提供 161 个标签、26 个财务指标和多公司筛选功能。

FreeFree tier
Type
Open Source
Visit Website GitHub (40 stars)

About ajtgjmdjp/edinet-mcp

edinet-mcp is an open-source EDINET XBRL parsing library and MCP server that provides programmatic access to Japan's EDINET financial disclosure system. It normalizes XBRL filings across accounting standards (J-GAAP, IFRS, US-GAAP) into canonical labels and exposes them as an MCP server for AI assistants. Key capabilities include searching over 5,000 listed Japanese companies, retrieving annual/quarterly/semiannual and extraordinary reports, automatic normalization (e.g., 'stmt["売上高"]' works regardless of accounting standard), bilingual label support (Japanese and English), financial metric calculations (ROE, ROA, profit margins), year-over-year comparisons, multi-company screening (up to 20 companies), cross-period diff with change amounts and growth rates, and narrative section extraction (business risks, MD&A, etc.). The tool is fully free and local, requires only a free EDINET API key, and is Apache-2.0 licensed.

Key Features

Search over 5,000 listed Japanese companies
Retrieve annual, quarterly, semiannual, extraordinary, and large shareholding reports
Automatic XBRL normalization across J-GAAP, IFRS, and US-GAAP
Bilingual labels (Japanese and English) for financial statements
Financial metrics: ROE, ROA, profit margins, year-over-year comparisons
Multi-company screening (up to 20 companies)
Cross-period diff with change amounts and growth rates
Narrative section extraction (business risks, MD&A, management policies)
MCP server with 10 tools for AI assistants
Parse XBRL into Polars/pandas DataFrames (BS, PL, CF)

Pros & Cons

Pros
  • Fully free and open source (Apache-2.0)
  • No usage caps – only EDINET’s own rate limits apply
  • Runs locally – data never leaves your machine
  • Works across accounting standards (J-GAAP, IFRS, US-GAAP)
  • Bilingual output (Japanese and English) supported
  • High-throughput batch parsing capability (references Rust iXBRL engine)
  • Active development with Docker support and Python package
Cons
  • Requires a free EDINET API key to use
  • Limited to Japanese EDINET financial data only
  • Python environment or Docker setup needed
  • No graphical user interface – primarily for developers and AI assistants
  • Documentation mostly in Japanese; English docs may be less complete

Best For

Analyze Japanese company financials with AI assistantsCompare financial metrics across multiple companiesTrack changes in financial statements over timeExtract narrative risk disclosures from filingsAutomate financial data pipelines for Japanese equities

FAQ

How do I get an API key?
Register for free at the EDINET website and set the API key as an environment variable (EDINET_API_KEY).
What accounting standards are supported?
J-GAAP, IFRS, and US-GAAP. The tool normalizes labels across all three.
Is edinet-mcp free?
Yes, it is fully free and open source under the Apache-2.0 license. There are no paid tiers or usage caps beyond EDINET's own rate limits.
Can I use it with Claude Desktop?
Yes, edinet-mcp provides an MCP server that can be connected to Claude Desktop and other AI tools that support the MCP protocol.
How do I run edinet-mcp?
Install via pip or uv using 'pip install edinet-mcp' or use the Docker image 'ghcr.io/ajtgjmdjp/edinet-mcp serve'.