Edinet Db

EDINET DB MCP 服务

面向日本 EDINET DB 的远程 MCP 服务——为约 3,800 家日本上市公司提供结构化财务数据，通过 HTTPS 提供服务，并采用 OAuth 2.0 多租户身份验证。

• 🌐 端点：https://edinetdb.jp/mcp
• 🔐 身份验证：OAuth 2.0（或 API 密钥）
• 👥 用户：9,000 多名注册开发者、分析师和学术研究人员
• 📅 开始投入生产使用的时间：2026-03-01
• 🇯🇵 首个面向日本上市公司申报文件的远程 MCP 服务（根据作者截至 2026-02 月末的研究）

功能介绍

EDINET DB 提供从日本监管申报文件（金融厅的 EDINET）以及公开开放数据（经济产业省的 gBizINFO、国税厅法人登记簿、Wikidata）中提取的结构化财务和企业数据。通过 Claude Desktop、Claude Code、Cursor、Codex CLI 或任何兼容 MCP 的客户端连接，即可使用自然语言查询公司财务、HR／多元化披露、供应链、专利、高管资料和企业历史。

两种连接方式

	远程（推荐）	本地 stdio 服务（本仓库）
端点	https://edinetdb.jp/mcp	在你的计算机上运行
工具	75 个	13 个核心工具
身份验证	OAuth 2.0 或 API 密钥	API 密钥（EDINETDB_API_KEY）
设置	添加一个 URL	npx、node 或 Docker

远程服务是完整产品，无需安装任何内容。本仓库中的本地 服务是一个小巧、依赖少的 stdio 客户端，通过同一个公开 REST API 提供服务，适用于无法使用可流式传输 HTTP 的客户端，或更愿意自行运行 进程的用户。

快速开始 — 远程

Claude Desktop（自定义连接器）

1. 打开 Claude Desktop → Settings → Custom Connectors
2. 添加连接器：
   • 名称：EDINET DB
   • URL：https://edinetdb.jp/mcp
   • 身份验证：OAuth 2.0（发现地址：https://edinetdb.jp/mcp/.well-known/oauth-authorization-server）
3. 使用你的 edinetdb.jp 账户登录（可在 https://edinetdb.jp/signup 免费注册）

Claude Code

claude mcp add edinetdb https://edinetdb.jp/mcp --transport http

Cursor

.cursor/mcp.json：

{
  "mcpServers": {
    "edinetdb": {
      "url": "https://edinetdb.jp/mcp",
      "transport": "streamable-http"
    }
  }
}

Codex CLI

codex mcp add edinetdb https://edinetdb.jp/mcp

快速开始 — 本地 stdio 服务

在 https://edinetdb.jp/developers 获取免费 API 密钥，然后：

EDINETDB_API_KEY=your-key npx -y github:edinetdb/edinet-db-mcp

Claude Desktop / Cursor / 任何 stdio 客户端：

{
  "mcpServers": {
    "edinetdb": {
      "command": "npx",
      "args": ["-y", "github:edinetdb/edinet-db-mcp"],
      "env": { "EDINETDB_API_KEY": "your-key" }
    }
  }
}

从源代码构建：

git clone https://github.com/edinetdb/edinet-db-mcp && cd edinet-db-mcp
npm ci && EDINETDB_API_KEY=your-key node server.js

使用 Docker（必须指定 -i——传输方式为 stdio）：

docker build -t edinet-db-mcp .
docker run -i --rm -e EDINETDB_API_KEY=your-key edinet-db-mcp

环境变量	必需	默认值	用途
EDINETDB_API_KEY	是，调用工具时必需	—	你的 EDINET DB API 密钥。不提供密钥也可以使用列表工具。
EDINETDB_BASE_URL	否	https://edinetdb.jp/v1	REST API 基础 URL。
EDINETDB_TIMEOUT_MS	否	30000	每个请求的超时时间，单位为毫秒。

本地服务中的工具（13）

每个工具都是一个 REST 端点的类型化封装。工具集经过有意精简：每个工具对应用户实际会提出的一个问题，不会有两个工具处理相同的内容。

工具	可回答的问题
search_companies	将名称或证券代码解析为 EDINET 代码
get_company	一家公司的完整简介
get_financials	多年的财务报表序列
get_segments	哪个业务部门创造收入
get_earnings	最新季度业绩和公司预测
get_disclosures	公司提交了哪些文件，以及提交时间
get_text_blocks	已提交的业务概况、风险因素和 MD&A
get_directors	董事会成员名单、任期和持股情况
get_shareholders	哪些人持有该公司 5% 以上的股份
search_shareholders	某位投资者持有的所有股份
screen_companies	按数值标准筛选市场
get_ranking	某项指标的全市场排名表
compare_peers	将一家公司与其所在行业进行基准比较

如需完整功能，包括 IR 文件、知识图谱策略、KPI 跟踪、关注列表、仪表板和已保存的分析，请使用远程服务；该服务提供下方列出的全部 75 个工具。

远程服务中的工具（75）

公司与财务

• get_company — 公司简介和最新财务数据（来源为 XBRL，不使用大模型）
• get_financials — 多年财务时间序列
• get_analysis — 基于规则的财务健康评分（0-100）和关键指标摘要
• compare_companies — 对 2-10 家公司的同一财年数据进行并列比较
• get_industry_benchmark — 行业中位数和 P25/P75 四分位数
• get_fair_value — 确定性、非投资建议性质的估值模型估算
• get_segments — 业务部门收入、营业收入、资本支出和资产
• get_detailed_expenses — 来自损益表附注的销售、一般及管理费用明细
• get_order_backlog — 新接订单、未交订单、产量和销量
• get_earnings — 季度业绩快报（決算短信），按时间从新到旧排列
• get_earnings_calendar — 预定的业绩公告日期

搜索与筛选

• search_companies — 按名称、证券代码、行业或健康评分搜索
• search_companies_batch — 一次调用查询多家公司
• screen_companies — 使用 AND 逻辑筛选 100 多项指标
• get_ranking — 按财务、人力资本或 ESG 指标对公司进行排名
• search_corporate_master — 国税厅法人编号数据库（活跃法人超过 580 万家）
• get_corporate_profile — 按 13 位法人编号查询简介，无论是否上市
• get_events — 从申报文件、业绩和持股中汇总并规范化的公司事件
• get_appearances — 反向查询：公司出现在其他公司申报文件中的情况

申报文件：全文与结构化提取

• get_text_blocks — 年度证券报告中的原始全文
• get_text_blocks_structured — 从上述章节中预先提取的结构化数据点
• get_compensation_text — 董事和高管的薪酬披露
• get_company_history — 以结构化事件形式呈现的公司历史时间线（沿革）

股东

• get_shareholders — 大量持股报告（大量保有報告書），按申报方集团列出最新报告
• search_shareholders — 某申报方持有了哪些公司股份
• get_shareholder_history — 申报方与发行方之间的持股时间序列
• get_shareholder_transactions — 60 天收购／处置表中的交易级明细
• get_activist_positions — 当前活跃股东在整个市场中的持仓
• get_shareholder_categories — 按股东类别划分的所有权情况（所有者別状況）
• get_major_shareholders — 前 10 大主要股东快照
• get_cross_shareholdings — 按发行方列出的政策持股（政策保有株式） 企业关系图
• get_directors — 董事和公司审计员（役員一覧）
• get_director_compensation — 按高管类别细分薪酬
• get_parent_company / get_parent_companies — 已披露的母公司和反向声明的母公司
• get_subsidiaries — 合并子公司和权益法核算的关联公司（関係会社の状況）
• get_gleif_subsidiaries — GLEIF Level 2 中的合并子公司
• get_related_party_transactions — 关联方交易（関連当事者との取引）
• get_main_customers — 已披露的主要客户（主要販売先）关系图

资产与设施

• get_real_estate — 土地、建筑物和投资性房地产的账面价值
• get_facilities — 主要设施的具体信息（主要な設備の状況）

IR 文档与知识图谱

• get_ir_documents — IR PDF：综合报告、中期计划、可持续发展报告
• get_ir_pdf_url — IR PDF 的签名下载 URL
• list_ir_document_types — 可用的 IR 文档类型 slug
• search_ir_sections / get_ir_sections_by_company — 按章节搜索 IR 内容
• search_qa_sections — 来自业绩说明会的问答内容
• search_ir_kpis / get_ir_kpis_by_company — 来自中期计划和综合报告的数值 KPI
• search_kg_strategies — 从多家公司提取的战略实体
• search_kg_kpi_commitments — 已承诺的数值目标
• get_kg_company_summary — 单家公司的知识图谱摘要
• get_kg_kpi_track_record — KPI 承诺、观察结果和修订记录
• find_peer_strategies — 主题相近的同业战略

关注列表、仪表板与通知

• get_watchlist / add_to_watchlist / remove_from_watchlist — 个人关注列表
• dashboard_list_modules / dashboard_get_feed / dashboard_add_module / dashboard_remove_module / dashboard_update_params — 仪表板模块和实时信息流
• subscribe_notifications / list_notification_subscriptions / unsubscribe_notifications — 电子邮件摘要

已保存的分析

• save_analysis / list_my_analyses / run_analysis / delete_analysis — 可重新运行的命名分析

数据质量反馈

• report_data_issue / report_financial_data_issue — 标记错误或缺失的数据
• get_data_issue — 查看已提交报告的状态
• request_data / list_my_data_requests — 请求完全缺失的数据

文档

• get_documentation — 内嵌帮助、工具目录和方法说明

数据来源

来源	覆盖范围	许可
EDINET（FSA Japan）	年度证券报告、季度报告、大股东报告	公共部门开放数据
gBizINFO（METI）	公司基本属性、专利、补贴、政府采购	兼容 CC BY 4.0（政府標準利用規約 第2.0版）
Corporate Number Publication Site（NTA）	法人编号、3 项基本信息	公共数据利用规约 第1.0版
Wikidata	官方网站 URL	CC0
AI 生成内容（公司历史叙述等）	始终标注，并附来源事件 ID、时间戳和免责声明	—

我们不再分发需交易所授权的数据（实时股价、TDnet）。完整说明请参阅 https://edinetdb.jp/docs/data-sources。

定价

方案	价格（日元/月）	API/MCP 请求数/天
Free	¥0	100
Pro	¥4,980	1,000
Developer（原名 Business，于 2026-09-03 更名）	¥29,800	10,000
Business（组织）/ Enterprise	联系我们	自定义
Academy	经认可的研究人员免费	自定义

详情：https://edinetdb.jp/pricing

与类似项目的定位

EDINET DB 以托管式、经 OAuth 身份验证的多租户远程 MCP 服务运行，同时也在此代码库中提供本地 stdio 客户端，供希望自行运行该进程的用户使用。该服务自 2026-03-01 起投入生产环境，注册用户超过 9,000 人。

语言

• 日语（主要），英语（次要，持续扩展）
• 工具接受日语和英语查询，响应语言遵循 MCP 客户端的 Accept-Language

许可与条款

• 数据：参见上方“数据来源”表格；每个字段都带有 source 属性
• 服务：遵循 https://edinetdb.jp/terms
• 不代表任何政府机构的官方背书

链接

• 🌐 服务：https://edinetdb.jp
• 📚 文档：https://edinetdb.jp/docs/api
• 🔌 MCP 指南：https://edinetdb.jp/docs/mcp-guide
• 📊 数据质量 SLA：https://edinetdb.jp/docs/data-quality
• 🐛 问题反馈：https://github.com/edinetdb/edinet-db-mcp/issues
• ✉️ 联系方式：[email protected]

---

由 Cabocia Inc. 运营——为 AI Agent 时代构建数据基础设施。