edinet-util-mcp-server 0.1.0.dev0__tar.gz

edinet_util_mcp_server-0.1.0.dev0/.gitignore

@@ -0,0 +1,226 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#   Usually these files are written by a python script from a template
+#   before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+*.lcov
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+# Pipfile.lock
+
+# uv
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+# uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+# poetry.lock
+# poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+# pdm.lock
+# pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+# pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi/*
+!.pixi/config.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule*
+celerybeat.pid
+
+# Redis
+*.rdb
+*.aof
+*.pid
+
+# RabbitMQ
+mnesia/
+rabbitmq/
+rabbitmq-data/
+
+# ActiveMQ
+activemq-data/
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs/Zensical documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#   JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#   be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#   and can be added to the global gitignore or merged into this file.  For a more nuclear
+#   option (not recommended) you can uncomment the following to ignore the entire idea folder.
+# .idea/
+
+# Abstra
+#   Abstra is an AI-powered process automation framework.
+#   Ignore directories containing user credentials, local state, and settings.
+#   Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#   Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore that
+#   can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#   and can be added to the global gitignore or merged into this file. However, if you prefer, you
+#   could uncomment the following to ignore the entire vscode folder
+# .vscode/
+# Temporary file for partial code execution
+tempCodeRunnerFile.py
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/
+
+# Streamlit
+.streamlit/secrets.toml
+
+# Snapshot build output (released separately, not in git)
+skill/*/data/*.sqlite
+
+# macOS
+.DS_Store

edinet_util_mcp_server-0.1.0.dev0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 GotoAI Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

edinet_util_mcp_server-0.1.0.dev0/PKG-INFO

@@ -0,0 +1,106 @@
+Metadata-Version: 2.5
+Name: edinet-util-mcp-server
+Version: 0.1.0.dev0
+Summary: A skill-style MCP server for EDINET (金融庁) API v2 disclosures
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27
+Requires-Dist: lxml>=5
+Requires-Dist: mcp<3,>=2.3
+Provides-Extra: dev
+Requires-Dist: numpy>=1.26; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Requires-Dist: scikit-learn>=1.4; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# edinet-util-mcp-server
+
+An MCP server for the [EDINET](https://disclosure2.edinet-fsa.go.jp/) API v2 (金融庁), and the
+builder of the company-profile snapshot used by the `edinet-company-profiles` skill.
+
+EDINET API v2 を使って有価証券報告書などの開示書類を扱う MCP サーバーと、上場企業のプロフィール・
+主要指標・同業他社リストをまとめたスナップショットのビルダーです。
+
+> **Unofficial.** This project is not affiliated with or endorsed by the Financial Services
+> Agency (金融庁), which operates EDINET.
+
+**Status:** work in progress (0.1.0.dev0). The server, the skill and the snapshot builder work;
+not yet published.
+
+## Layout
+
+| Path | What it is |
+|---|---|
+| `src/edinet_util_mcp_server/` | The package: the MCP server (`server`, `guideline`), filing export (`export`, `convert`), API client (`api`), code list (`codelist`), key figures from the type-5 CSV (`figures`) |
+| `tools/build_profiles.py`, `tools/snapshot/` | The snapshot builder, a development tool not shipped in the wheel |
+| `skill/edinet-company-profiles/` | The skill: `SKILL.md`, `scripts/edinet_profiles.py` (standard library only), `references/financial_diagnosis.md`, `NOTICE`; the builder writes its database to `data/edinet_profiles.sqlite` (not in git) |
+
+## The server
+
+A skill-style MCP server over stdio, with the user's own API key:
+
+| Tool | Does |
+|---|---|
+| `load_guideline` | How the tools work together, the conditions of use |
+| `list_filings` | Filings submitted between two dates (at most 31 days), filtered by company or document type |
+| `export_filing` | One filing → Markdown files: `index.md`, `figures.md`, `sections/`, `images/` |
+
+Settings (environment variables): `EDINET_API_KEY` (required) and `EDINET_OUTPUT_DIR`
+(default `~/Documents/EDINET`), the only place the server writes. Run it with
+`python -m edinet_util_mcp_server`; Kari finds the command through the `kari.mcp_servers`
+entry point.
+
+## The skill
+
+`skill/edinet-company-profiles/` is a standard `SKILL.md` folder. Copy it, with its database,
+into `~/.agents/skills/` (Kari's main app) or import it in an Agent Desk. Its script opens the
+database read-only in place:
+
+```sh
+python skill/edinet-company-profiles/scripts/edinet_profiles.py compare 5586 --peers "ABEJA,エクサウィザーズ"
+```
+
+Commands: `company`, `peers`, `compare`, `filings`, `sql`, `about` (`--json` for structured
+output).
+
+## Tests
+
+```sh
+../../.venv/bin/pytest            # offline
+EDINET_LIVE=1 ../../.venv/bin/pytest tests/test_live.py   # real API over stdio, key from .env
+../../.venv/bin/ruff check src tests tools skill
+```
+
+## Building the snapshot
+
+Put the key in `.env` at the repository root (`EDINET_API_KEY=…`; the file is ignored by git),
+then:
+
+```sh
+python tools/build_profiles.py all
+```
+
+Steps, each re-runnable on its own: `cohort` (every listed company in the EDINET code list) →
+`filings` (every cohort filing in the daily lists of the last 18 months, or `--from`..`--to`)
+→ `profiles` (key figures and listing market from each latest annual report's CSV; a company
+is covered when that report shows at least 3 fiscal years) → `peers` (top 10 per company in
+the same TSE industry, scored 0.5 × scale similarity + 0.5 × similarity of the report's
+事業の内容 and 経営方針 text) → `finish` (manifest, attribution, `VACUUM`).
+
+The builder needs the dev extras (`pip install -e ".[dev]"`, which include numpy and
+scikit-learn for the `peers` step); the server itself does not.
+
+Downloads are cached in `build/edinet-cache/`, so an interrupted run resumes and a rebuild makes
+no repeat calls. Requests go one at a time, 1 second apart, slowing down after an HTTP 429.
+
+## Data and licence
+
+The code is MIT-licensed. Data from EDINET is used under the
+[公共データ利用規約（第1.0版）](https://www.digital.go.jp/resources/open_data/public_data_license_v1.0)
+(PDL1.0). The snapshot is processed data, not the original filings:
+
+- 出典：EDINET閲覧（提出）サイト（https://disclosure2.edinet-fsa.go.jp/）、PDL1.0（https://www.digital.go.jp/resources/open_data/public_data_license_v1.0）
+- EDINET閲覧（提出）サイトの提出書類をもとに GotoAI が加工して作成

edinet_util_mcp_server-0.1.0.dev0/README.md

@@ -0,0 +1,88 @@
+# edinet-util-mcp-server
+
+An MCP server for the [EDINET](https://disclosure2.edinet-fsa.go.jp/) API v2 (金融庁), and the
+builder of the company-profile snapshot used by the `edinet-company-profiles` skill.
+
+EDINET API v2 を使って有価証券報告書などの開示書類を扱う MCP サーバーと、上場企業のプロフィール・
+主要指標・同業他社リストをまとめたスナップショットのビルダーです。
+
+> **Unofficial.** This project is not affiliated with or endorsed by the Financial Services
+> Agency (金融庁), which operates EDINET.
+
+**Status:** work in progress (0.1.0.dev0). The server, the skill and the snapshot builder work;
+not yet published.
+
+## Layout
+
+| Path | What it is |
+|---|---|
+| `src/edinet_util_mcp_server/` | The package: the MCP server (`server`, `guideline`), filing export (`export`, `convert`), API client (`api`), code list (`codelist`), key figures from the type-5 CSV (`figures`) |
+| `tools/build_profiles.py`, `tools/snapshot/` | The snapshot builder, a development tool not shipped in the wheel |
+| `skill/edinet-company-profiles/` | The skill: `SKILL.md`, `scripts/edinet_profiles.py` (standard library only), `references/financial_diagnosis.md`, `NOTICE`; the builder writes its database to `data/edinet_profiles.sqlite` (not in git) |
+
+## The server
+
+A skill-style MCP server over stdio, with the user's own API key:
+
+| Tool | Does |
+|---|---|
+| `load_guideline` | How the tools work together, the conditions of use |
+| `list_filings` | Filings submitted between two dates (at most 31 days), filtered by company or document type |
+| `export_filing` | One filing → Markdown files: `index.md`, `figures.md`, `sections/`, `images/` |
+
+Settings (environment variables): `EDINET_API_KEY` (required) and `EDINET_OUTPUT_DIR`
+(default `~/Documents/EDINET`), the only place the server writes. Run it with
+`python -m edinet_util_mcp_server`; Kari finds the command through the `kari.mcp_servers`
+entry point.
+
+## The skill
+
+`skill/edinet-company-profiles/` is a standard `SKILL.md` folder. Copy it, with its database,
+into `~/.agents/skills/` (Kari's main app) or import it in an Agent Desk. Its script opens the
+database read-only in place:
+
+```sh
+python skill/edinet-company-profiles/scripts/edinet_profiles.py compare 5586 --peers "ABEJA,エクサウィザーズ"
+```
+
+Commands: `company`, `peers`, `compare`, `filings`, `sql`, `about` (`--json` for structured
+output).
+
+## Tests
+
+```sh
+../../.venv/bin/pytest            # offline
+EDINET_LIVE=1 ../../.venv/bin/pytest tests/test_live.py   # real API over stdio, key from .env
+../../.venv/bin/ruff check src tests tools skill
+```
+
+## Building the snapshot
+
+Put the key in `.env` at the repository root (`EDINET_API_KEY=…`; the file is ignored by git),
+then:
+
+```sh
+python tools/build_profiles.py all
+```
+
+Steps, each re-runnable on its own: `cohort` (every listed company in the EDINET code list) →
+`filings` (every cohort filing in the daily lists of the last 18 months, or `--from`..`--to`)
+→ `profiles` (key figures and listing market from each latest annual report's CSV; a company
+is covered when that report shows at least 3 fiscal years) → `peers` (top 10 per company in
+the same TSE industry, scored 0.5 × scale similarity + 0.5 × similarity of the report's
+事業の内容 and 経営方針 text) → `finish` (manifest, attribution, `VACUUM`).
+
+The builder needs the dev extras (`pip install -e ".[dev]"`, which include numpy and
+scikit-learn for the `peers` step); the server itself does not.
+
+Downloads are cached in `build/edinet-cache/`, so an interrupted run resumes and a rebuild makes
+no repeat calls. Requests go one at a time, 1 second apart, slowing down after an HTTP 429.
+
+## Data and licence
+
+The code is MIT-licensed. Data from EDINET is used under the
+[公共データ利用規約（第1.0版）](https://www.digital.go.jp/resources/open_data/public_data_license_v1.0)
+(PDL1.0). The snapshot is processed data, not the original filings:
+
+- 出典：EDINET閲覧（提出）サイト（https://disclosure2.edinet-fsa.go.jp/）、PDL1.0（https://www.digital.go.jp/resources/open_data/public_data_license_v1.0）
+- EDINET閲覧（提出）サイトの提出書類をもとに GotoAI が加工して作成

edinet_util_mcp_server-0.1.0.dev0/pyproject.toml

@@ -0,0 +1,52 @@
+[project]
+name = "edinet-util-mcp-server"
+version = "0.1.0.dev0"
+description = "A skill-style MCP server for EDINET (金融庁) API v2 disclosures"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.11"
+dependencies = [
+    "mcp>=2.3,<3",
+    "httpx>=0.27",
+    "lxml>=5",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8",
+    "pytest-asyncio>=0.24",
+    "ruff>=0.6",
+    "numpy>=1.26",
+    "scikit-learn>=1.4",
+]
+
+[project.scripts]
+edinet-util-mcp-server = "edinet_util_mcp_server.server:main"
+
+# What to run, declared so a client that installs this wheel does not have to be
+# told. Kari reads this group after installing a Python Package MCP server and
+# fills its command field from it; the module is runnable with `-m`, which is
+# what that field holds.
+[project.entry-points."kari.mcp_servers"]
+default = "edinet_util_mcp_server:main"
+
+[build-system]
+requires = ["hatchling>=1.26"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/edinet_util_mcp_server"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+pythonpath = ["src", "tools"]
+markers = ["live: calls the real EDINET API (set EDINET_LIVE=1 to run)"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+
+[tool.ruff.lint.isort]
+known-first-party = ["edinet_util_mcp_server", "snapshot", "fixtures"]

edinet_util_mcp_server-0.1.0.dev0/skill/edinet-company-profiles/NOTICE

@@ -0,0 +1,16 @@
+edinet-company-profiles
+
+Code (scripts/): MIT License, Copyright (c) 2026 GotoAI Inc. See the LICENSE file of
+edinet-util-mcp-server.
+
+Data (data/edinet_profiles.sqlite): processed data derived from documents filed on
+EDINET, used under the Public Data License (Version 1.0) (公共データ利用規約 第1.0版).
+
+  出典：EDINET閲覧（提出）サイト（https://disclosure2.edinet-fsa.go.jp/）、PDL1.0（https://www.digital.go.jp/resources/open_data/public_data_license_v1.0）
+  EDINET閲覧（提出）サイトの提出書類をもとに GotoAI が加工して作成
+
+The data is processed: figures are read from the XBRL-to-CSV files of each company's
+latest annual report, peer candidates are computed, and the filing index is a
+selection of EDINET's daily document lists. It is not the original data and must not
+be presented as unaltered government data. The snapshot date is in the database's
+manifest table (`scripts/edinet_profiles.py about`).

edinet_util_mcp_server-0.1.0.dev0/skill/edinet-company-profiles/SKILL.md

@@ -0,0 +1,68 @@
+---
+name: edinet-company-profiles
+description: 日本の上場企業（約3,800社）のプロファイル・5年分の主要財務数値・同業候補・提出書類の書類管理番号を、EDINETの有価証券報告書から作った読み取り専用のデータベースで調べる。企業の概要確認、同業他社との比較、財務診断に使う。
+metadata:
+  snapshot_id: "2026-11-02"
+  source: EDINET（金融庁）、PDL1.0
+---
+
+# EDINET 企業プロファイル
+
+EDINET の有価証券報告書から作った、上場企業のデータベースと、それを引くスクリプトです。
+データは読み取り専用で、スナップショット時点（`about` で確認）までのものです。
+
+- **このスキル**：会社を探す、プロファイルと5年分の数値、同業候補、指標の比較、書類管理番号。
+- **edinet-util（MCPサーバー）**：書類そのものを読む（`export_filing`）、スナップショット後の提出を
+  探す（`list_filings`）。本文や、データベースにない数値（有利子負債、設備投資、研究開発費、
+  セグメント別）はこちらで読みます。
+
+同業比較や財務診断を頼まれたら、まず `references/financial_diagnosis.md` を読んでください。
+
+## 使い方
+
+Kari では python_run で、スキルのフォルダ（読み込み時に表示される Skill directory）の
+スクリプトを呼びます。
+
+```python
+import runpy
+profiles = runpy.run_path("<Skill directory>/scripts/edinet_profiles.py")
+status, text = profiles["run"](["compare", "5586"])
+print(text)
+```
+
+シェルが使える環境では `python scripts/edinet_profiles.py compare 5586` でも同じです。
+標準ライブラリだけで動きます。
+
+| コマンド | 返すもの |
+|---|---|
+| `company <会社>` | プロファイル（証券コード、業種、市場、決算日、会計基準）と5年分の数値 |
+| `peers <会社> [-n 10]` | 同業候補（同じ東証33業種で、規模と事業内容の文章が近い順。スコアと理由つき） |
+| `compare <会社> [--peers "A,B"] [-n 5]` | 対象と同業他社の指標表、同業中央値・差・順位、推移、注記、各社の有価証券報告書の書類管理番号 |
+| `filings <会社> [--types 120,160] [--limit 30]` | 提出書類の一覧と書類管理番号（120 有価証券報告書、160 半期報告書、180 臨時報告書） |
+| `sql "SELECT …"` | 上で足りないときの読み取り専用クエリ（表と列は `about` に） |
+| `about` | スナップショットの時点、件数、出所、表と列 |
+
+- `<会社>` は証券コード（5586、5586.T、55860）、EDINETコード（E38755）、社名の一部（漢字・カナ・
+  英語）のどれでも構いません。候補が複数あると一覧を返すので、コードで選び直してください。
+- `--json` をつけると構造化データで返ります。
+- `compare --peers` には利用者が挙げた同業他社を渡します。足りない分は同業候補の上位から順に
+  補います（`-n` が合計の社数）。比較できない会社は理由つきで「外した企業」に出ます。
+
+## 数値の読み方
+
+- 金額は円、比率は小数で保存しています（表示は百万円・%）。各社の最新期どうしの比較で、
+  決算期が違えば注記に出ます。
+- `sec_code` は EDINET の5桁（先頭4桁が普段の証券コード）です。表示は4桁にしてください。
+- 状態が `ok` 以外の会社（3期未満、有価証券報告書なし、CSVなし）は数値と同業候補がありません。
+  理由は `company` が示します。
+- スナップショットより後に提出された書類は入っていません。新しい決算が出ていそうなときは
+  `list_filings` で確かめます。
+
+## 出典の表示（必ず守ってください）
+
+スクリプトの出力の末尾に、出典・加工の表示・データ時点が付いています。この数値を使って
+回答や資料を作るときは、次の2行とデータ時点を必ず添えてください。加工したデータを、
+加工していない政府のデータであるかのように示してはいけません。
+
+- 出典：EDINET閲覧（提出）サイト（https://disclosure2.edinet-fsa.go.jp/）、PDL1.0（https://www.digital.go.jp/resources/open_data/public_data_license_v1.0）
+- EDINET閲覧（提出）サイトの提出書類をもとに GotoAI が加工して作成