disclosures

disclosures

AI エージェントと TypeScript 向けの企業開示調査 — 21 の管轄ルート（20 の国別ルートと EU 集約）にわたる 26 の公式情報源から、届出書類、インサイダー、所有者、財務情報、所有権の連鎖を取得します。

disclosures は、無料のオープンソースの Model Context Protocol サーバーであり、TypeScript ライブラリでもあります。「NVIDIA の取締役は誰ですか？」、「Samsung Electronics の株式を 5% 保有しているのは誰ですか？」、「Vale の直近 3 年分の年次決算を見せてください」 といった質問に回答し、すべての回答を公式の原資料にリンクします。

• 安定した 10 個のツール、21 の管轄ルート — 中核となる 6 つのツールは jurisdiction を介して振り分けられます。OwnershipChain はグローバルに対応し、専門ツール 3 つで届出書類、担保権、個人単位の検索を扱います。対応範囲が拡大しても、ツール名は変わりません。
• 公式情報源のみ — SEC EDGAR、GLEIF、Companies House、FCA NSM、filings.xbrl.org、OpenDART、EDINET、cninfo、SZSE、BSE、TWSE、CVM、BaFin、info-financiere、recherche-entreprises、HKEXnews、ACRA、DBD、AFM、IDX、Bursa Malaysia、KAP、DFM、PSE EDGE、ASX、ASIC。
• 誠実さを設計に反映 — 実際の情報源へのリンクのみを提示し、空の結果や捏造した結果ではなく「ここでは未対応」と明示して回答し、「届出がないことは、存在しない証拠にはならない」という注意事項も明確に示します。
• ランタイムをバンドル — Node 18 以降で使える JavaScript ファイル 1 つ。MCP SDK と Zod はパッケージ依存関係として宣言されているため、TypeScript の利用者はパブリック API で使用される型を受け取れます。

クイックスタート

Node 18 以降が必要です。SEC を利用する米国向けの呼び出しでは、EDGAR の公平なアクセスに関するポリシーに従い、内容が分かる User-Agent が必要です。API キー不要の米国以外のルートでは、User-Agent がなくても実行できます。

npx -y disclosures

Claude Code

claude mcp add --transport stdio disclosures \
  --env DISCLOSURES_USER_AGENT="Your Organization [email protected]" \
  -- npx -y disclosures

Claude Desktop

claude_desktop_config.json に追加します（Settings → Developer → Edit Config）：

{
  "mcpServers": {
    "disclosures": {
      "command": "npx",
      "args": ["-y", "disclosures"],
      "env": {
        "DISCLOSURES_USER_AGENT": "Your Organization [email protected]"
      }
    }
  }
}

Cursor

Claude Desktop と同じ mcpServers ブロックを ~/.cursor/mcp.json（またはプロジェクトごとの .cursor/mcp.json）に追加します。

VS Code（Copilot / MCP）

.vscode/mcp.json に追加します：

{
  "servers": {
    "disclosures": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "disclosures"],
      "env": {
        "DISCLOSURES_USER_AGENT": "Your Organization [email protected]"
      }
    }
  }
}

[mcp_servers.disclosures]
command = "npx"
args = ["-y", "disclosures"]
env = { DISCLOSURES_USER_AGENT = "Your Organization [email protected]" }

同じサーバーは、ホスト型またはネットワーク経由のデプロイ向けに、MCP のストリーマブル HTTPトランスポートにも対応しています。--http を渡してください（フラグを指定しない場合は、引き続き stdio がデフォルトです）。

disclosures --http --port 8080          # or: node dist/server.mjs --http

• デフォルトでは 127.0.0.1 にバインドします。ポートは --port、それがなければ PORT 環境変数、どちらもなければ 8080 が使用されます。ホストと、指定された Origin ヘッダーは、サーバーの許可リストと一致している必要があります。ループバック以外にバインドするには、ベアラートークンと明示的に許可されたホストが必要です。
• MCP エンドポイント：POST /mcp（トランスポートはストリーマブル HTTP の GET／DELETE ハンドシェイクにも応答します）。ステートレスで実行されます。セッション ID はなく、リクエストごとに新しいサーバーインスタンスが作成されます。
• ヘルスチェック：GET /healthz → 200 {"name","version","tools"}。
• stdio モードと同様に、診断情報は stderr のみに出力されます。

ストリーマブル HTTP 対応の MCP クライアントから http://127.0.0.1:8080/mcp に接続してください。

ホスト型サービスでは、デプロイ環境のシークレット設定を通じて DISCLOSURES_HTTP_TOKEN を指定し、次のように設定してください。

DISCLOSURES_HTTP_ALLOWED_HOSTS="disclosures.example.com" \
DISCLOSURES_HTTP_ALLOWED_ORIGINS="https://disclosures.example.com" \
DISCLOSURES_DOWNLOAD_DIR="/var/lib/disclosures/downloads" \
  disclosures --http --host 0.0.0.0 --port 8080

リバースプロキシで TLS を終端し、設定済みの Host ヘッダーを保持して、クライアントが Authorization: Bearer <token> を送信するようにしてください。許可するホストはポートを含む正確なオーソリティで、クライアントがポートを送信する場合はポートも含める必要があります。カンマ区切りの値に対応しています。Origin はデフォルトで、許可されたホストに対する http:// の Origin になります。TLS 終端の背後では、HTTPS の Origin を明示的に設定してください。ブラウザー以外のクライアントでは、Origin を指定しないリクエストもサポートされます。ヘルスエンドポイントは Host／Origin をチェックしますが、トークンは必要ありません。

ライブラリとしてデプロイする場合は、同じポリシーを適用する runHttpServer({ bearerToken, allowedHosts, allowedOrigins, downloadDirectory }) を使用してください。HTTP ダウンロードは常にサーバー管理下のディレクトリに保存されます（デフォルトではプライベートな一時ディレクトリ）。output_path に指定できるのはファイル名のみです。stdio／ライブラリのダウンロードでは、明示的なローカルパスを使用できます。すべてのモードで、既存のファイルやシンボリックリンクへの上書きは拒否されます。パスを省略すると、一意のプライベートな一時ファイルが作成されます。

クライアントの設定を変更した後、クライアントを再起動して、次のように試してください。

「disclosures を使って、Apple の取締役一覧と最新の Form 4 の取引状況を確認してください。」 「NVIDIA の株式を 5% 以上保有しているのは誰ですか？届出書へのリンクを表示してください。」 「韓国の Samsung Electronics を特定し、最新の年次財務情報を表示してください。」 「Apple Operations India の上位にある GLEIF の所有関係チェーンは何ですか？」

10 個のツール

6 つのコアツールは、jurisdiction を介してすべての管轄区域ルートに振り分けられます。OwnershipChain はグローバル対応で、管轄区域に依存しません。CompanyDocument が受け付けるのは US、GB（デフォルト）、JP、KR、FR、HK、CN、IN、TR、AE、PH、AU です。PersonAppointments が受け付けるのは US、GB（デフォルト）、DE、FR、AU です。CompanyCharges は Companies House 専用で、jurisdiction は受け付けません。

company 入力はすべて、会社名または各地域の識別子を受け付けます。ティッカー、CIK、LEI、ISIN（US／グローバル）、Companies House 番号（GB — スコットランドおよび北アイルランドの SC／NI 接頭辞を含む）、OpenDART の corp／stock code（KR）、EDINET／証券／法人コード（JP）、A 株または HK コード（CN）、BSE scrip（IN）、TWSE 上場コード（TW）、CVM 登録コード（BR）、BaFin-Id または ISIN（DE）、SIREN／ISIN／LEI（FR）、4 桁または 5 桁の HKEX 株式コード（HK）、シンガポール UEN（SG）、13 桁の法人登録番号（TH）、AFM 登録簿の発行体名または LEI（NL）、4 文字の IDX ティッカー／kode emiten（ID）、4 桁の Bursa 株式コードまたは発行体名（MY）、BIST 株式コード（TR）、DFM 発行体シンボル（AE）、PSE ティッカーシンボルまたは数値の PSE 企業 ID（PH）。jurisdiction: "US" | "GB" | "EU" | "KR" | "JP" | "CN" | "IN" | "TW" | "BR" | "DE" | "FR" | "HK" | "SG" | "TH" | "NL" | "ID" | "MY" | "TR" | "AE" | "PH" | "AU" を指定します（デフォルトは US）。

対応範囲一覧

✅ 対応 · ⚠️ 部分対応（FR CompanyOwners：しきい値を超えた際の通知に対応。PDF のテキストレイヤーから、保有者、方向、しきい値、通知後の保有率をベストエフォートで構造化抽出します。最新の数件のみが対象です。スキャンされた PDF、標準外の PDF、古い通知はリンクのみのリストになります · HK CompanyOwners：キー不要の CCASS 株式保有検索で取得できるのは、参加者／カストディアンレベルの保有情報（カストディアン銀行、ブローカー、HKSCC Nominees、CSDC）であり、受益者情報ではありません。SFO Part XV Disclosure of Interests 登録簿は CAPTCHA で保護されているため、手動検索用のリンクを掲載します · HK CompanyFinancials：発行体の最新の決算発表 PDF から主要数値を抽出します。最新発表のみが対象です。標準的な発行体は問題なく抽出できますが、複雑なセグメント別／複数列の財務諸表は部分的に解析され、ページ数不足や財務諸表の欠落がある場合は PDF リンクに切り替わります · CN CompanyFinancials：発行体の最新の定期報告書 PDF にある「主要会計データ」表から主要数値を抽出し、報告書に記載された単位（元／千元／万元／百万元）から人民元の整数値に正規化します。最新の報告書のみが対象です。文字化け（オブジェクトストリーム）した報告書、上限を超えるサイズの PDF、主要データ表の欠落がある場合は PDF リンクに切り替わります · CN CompanyOwners：発行体の最新の定期報告書から「上位10名の株主」表を解析します。実際の大株主データですが、列の順序が不規則で発行体によって異なるため、値をヒューリスティックに判定し、確実に照合できた行のみを出力します。公表時点のスナップショットであり、最新の登録簿ではなく、UBO の追跡にも対応しません · CN CompanyInsiders：取引所によって対応が異なります。SZSE のコード（0/3xxxxx）では、キー不要の SZSE 構造化 董監高 株式変更フィードを使用します。一方、SSE のコード（6xxxxx）では、最新の年次報告書に掲載された公表時点の 董監高 役員名簿に切り替わり、氏名と役職のみを返します） · ID はボット対策で保護されたホスト（www.idx.co.id）経由で提供されます。アダプターはブラウザー相当のヘッダーを送信し、それらが通過する環境では動作します。エッジ側で拒否された場合は、「ホストがこのリクエストをブロックしました — ブラウザー経由の fetchFn を注入してください」という明示的な注記を返します。発行体の結果が空であることを示すものではなく、結果がない場合も黙って見落とすことはありません · TR CompanyFilings は意図的に非対応（—）としています。KAP は BIST のディレクトリとすべての開示ページ／PDF をキー不要で提供していますが、Next.js の再構築によってデータレイヤーが kapsitebackend.mkk.com.tr に移動し、このホストは公開インターネットから名前解決できません。開示 ID で指定できるものは動作しますが、一覧の取得はできません（企業ごとの通知ページは 200 を返しますが、サーバー側でレンダリングされるのは空のシェルで、通知一覧は到達不能なホストから取得されます）。そのため、このツールは理由を説明し、一覧を捏造するのではなく発行体の KAP ページを案内します · PH CompanyFinancials は部分対応です。PSE EDGE が提供するのは、独自の 17-A フォームに含まれる主要な財務諸表（貸借対照表＋損益計算書、通貨は PHP）であり、完全な監査済み財務諸表はレポートの PDF 添付ファイルに記載されています · — 対応していない法域であることを正直に説明し、空の結果や捏造した結果は返しません NL CompanyOwners／CompanyInsiders は完全にサポートされていますが、ファイル全体の AFM 登録簿エクスポートを読み込みます（サーバー側のフィルタリングはありません。実質的持株エクスポートは約 108 MB です）。セッション中の最初の呼び出しには約 20～30 秒かかりますが、その後は発行体ごとに 24 時間キャッシュされるダイジェストにより、残りの呼び出しは数ミリ秒で処理されます。リクエストごとにデプロイする場合は、AdapterOptions.cache（例：FileCache）を指定してください。

⚠️ ASX と PSE EDGE は制限付きの情報源であり、デフォルトではネットワークアクセスの前に無効化されています。 利用規約により使用や再配布が制限されており、自動開示サービスと相容れない場合があります。AU.md と PH.md を確認し、ご利用の状況で当該情報源を使用する権利がある場合に限り、DISCLOSURES_ACKNOWLEDGE_ASX_TERMS=1 および／または DISCLOSURES_ACKNOWLEDGE_PSE_TERMS=1 を設定してください。ASIC の CC-BY オーストラリア企業登録簿および資格剥奪登録簿は、ASX の利用規約への同意なしで引き続き利用できます。有効化した場合、応答には情報源固有の利用規約に関する通知が含まれます。法的助言ではありません。

各管轄区域の詳細なリファレンスページ（データソース、認証情報、受け付ける識別子、インテントごとの動作、注意事項）は docs/jurisdictions/ にあります。

データソースと認証情報

米国およびグローバルの検索は、User-Agent だけで利用できます。上流で許可されている場合、米国以外の情報源はキーなしで利用できます。キーが必要なものも少数ありますが、すべて無料です。検索する管轄区域に必要なキーだけを指定してください。それ以外はキーがなくても引き続き動作します。また、認証情報が不足している場合は、設定すべき変数名を明示したわかりやすいエラーが返されます。

# Required (SEC fair-access policy — your name/org and contact email)
export DISCLOSURES_USER_AGENT="Your Organization [email protected]"

# Optional, per jurisdiction
export COMPANIES_HOUSE_API_KEY="..."   # GB
export OPENDART_API_KEY="..."          # KR
export EDINET_API_KEY="..."            # JP document search
export DBD_API_KEY="..."               # TH company-name search (by-number is keyless)

# Restricted sources: set only after reviewing the source terms.
export DISCLOSURES_ACKNOWLEDGE_ASX_TERMS=1
export DISCLOSURES_ACKNOWLEDGE_PSE_TERMS=1

互換性のため、SEC_EDGAR_USER_AGENT をフォールバックとして使用できます。DISCLOSURES_USER_AGENT が優先されます。

TypeScript ライブラリとして使用する

同じパッケージを stdio を起動せずにインポートできます。各アダプターは { fetchFn?, env?, cache? } を注入できるため、組み込みや決定論的なテストが可能です。

import { createTools } from "disclosures";

const tools = createTools({
  env: { DISCLOSURES_USER_AGENT: "Your Organization [email protected]" },
});

const resolve = tools.find((tool) => tool.name === "CompanyResolve")!;
const result = await resolve.handler({ company: "NVDA" });

ハンドラーが例外をスローすることはありません。すべての失敗は、読みやすい MCP 形式の結果として返されます。Markdown ではなく正規化済みの生レコードを使いたい場合は、個々のアダプターも名前空間（secEdgar、gleif、companiesHouse、openDart、edinet、cninfo、szse、bseIndia、fcaNsm、xbrlFilings、twseOpenApi、cvmOpenData）としてエクスポートされています。

import { FileCache, createTools } from "disclosures";

const tools = createTools({
  env: { OPENDART_API_KEY: process.env.OPENDART_API_KEY },
  cache: new FileCache("/var/cache/disclosures"), // TTL-aware, survives restarts
});

import { gleif } from "disclosures";

gleif.isIsin("US0378331005");                               // true — validates the check digit
const issuer = await gleif.resolveLeiByIsin("US0378331005"); // → issuer's GLEIF Entity (with .lei)
const isins = await gleif.getIsinsForLei("HWUPKR0MPOU8FGXBT394"); // → every ISIN for that LEI

import { createDisclosuresServer } from "disclosures";

const server = createDisclosuresServer(); // McpServer with all ten tools registered

AI クライアント向けに設計

レスポンスは、MCP クライアントが実際に利用する方法を考慮して設計されています。

• Markdown を優先したレンダリング。 すべての結果は GitHub Flavored Markdown のテキストブロック 1 つで構成されます。見出し、コンパクトなパイプテーブル（JSON のように行ごとに繰り返さず、ヘッダーは一度だけ記載）、実際のソースリンク、補足事項が含まれます。LLM リーダーにとってトークン効率のよい形式です。
• 連鎖処理のための構造化出力。 データを含むツールは、Markdown の事実情報を反映した MCP の structuredContent も返します。そのためクライアントは文章を解析せずに呼び出しを連鎖できます。CompanyResolve は識別子一式を含む候補を順位付けして返し、CompanyFilings と登記情報はすぐに使える transactionId を、PersonAppointments は officerId を持つ人物を返します。また、CompanyInsiders、CompanyOwners、CompanyFinancials（会計期間末でラベル付けされた概念ごとの事実情報）、OwnershipChain、PrivateRaises、CompanyCharges も対象です。いずれにも sourceJurisdiction が付与されています。OwnershipChain は MCP の outputSchema も宣言します。一方、複数管轄を扱うツールは正直な検索不一致をテキストのみで返す経路を維持しているため、宣言済みスキーマなしで構造化データを追加で出力します。
• 次のステップを示す末尾のヒント。 連鎖可能な出力は、次に呼び出すツールとパラメーターを示す一行の _Next: …_ ヒントで終わります。
• ツールアノテーション。 すべてのツールが openWorldHint と idempotentHint を宣言します。ローカルファイルに書き込む pdf モードを持つ CompanyDocument を除き、すべて readOnlyHint も宣言するため、クライアントは並列処理を行い、確認プロンプトを省略できます。
• ページ分割された文書テキスト。 CompanyDocument の xhtml モードでは、text_offset を使って 50,000 文字単位で読み込みます。長い開示書類も先頭で切り詰められることなく、最後まで読み取れます。
• 信頼できない内容のフェンス処理。 提出者が作成した抽出テキストは、固定の <<<BEGIN/END UNTRUSTED DOCUMENT TEXT>>> センチネルで囲まれます（文書内にある類似文字列は無効化されます）。これにより、クライアントはプログラムで隔離できます。
• 管轄リソース。 サーバーは disclosures://jurisdictions と disclosures://jurisdictions/{code} の MCP リソースを公開し、各管轄の情報源、認証情報、受け付ける識別子、注意事項を説明します。ツール呼び出しを失敗させずに要件を確認できます。

誠実性と対象範囲

これらのツールが正確に報告するのは公開情報です。KYC、UBO、または株主構成表を扱う製品ではありません。

• 情報がないことは、存在しない証拠ではありません。 Form Dが見つからなくても、その企業が非公開で資金調達をしたことがないとは限りません。PSCが見つからなくても、支配者が存在しない証拠にはなりません。ECCTAの本人確認フィールドが空欄でも、役員の本人確認が未実施である証拠にはなりません。
• GLEIFの親会社情報が示すのは会計上の連結関係であり、議決権による支配、市場開示上の所有権、または最終受益所有権ではありません。
• Schedule 13D/13Gは、5％の基準値に達した届出者を特定するものであり、完全かつ常に最新の資本構成表ではありません。
• Section 16のインサイダー情報は、最近のForms 3/4/5を反映したもので、現在の全員を網羅していない場合があります。
• 届出書は修正、再提出、遅延、または別のXBRL概念でタグ付けされる場合があります。リンク先の原資料で確認してください。
• ここに記載された情報は、法律、投資、会計、または財務に関する助言ではありません。

解決できなかった場合は、「Could not find…」というプレーンテキストが返されます。設定、上流サービス、レート制限に関するエラーは、修正方法を示すフラグ付きエラーとして返されます。すべてのリンクは実際にアクセス可能なソースURLです。

ドキュメント

開発

開発にはBunが必要です。公開済みの成果物はNode 18+で実行されます。

bun install --frozen-lockfile
bun audit                            # complete dependency graph
bun --no-env-file run typecheck       # pinned TypeScript compiler
bun --no-env-file run test            # full offline suite — no live HTTP
bun --no-env-file run build           # bundle and declarations
bun --no-env-file run test:stdio      # freshly built stdio integration
bun --no-env-file run test:runtime    # stdio and HTTP on the active Node runtime
bun --no-env-file run test:package    # isolated npm install and strict consumer compilation

ローカルの環境ファイルを読み込んではならない自動化では、クリーンなチェックアウトでパッケージマネージャーのコマンドを実行してください。Bunのインストール／監査コマンドは、実行時の--no-env-fileフラグを無視します。PRではNode 22でオフラインゲート全体を実行します。リリース検証ではさらに、Node 18/20/22/24とライブプロバイダーを確認します。バージョン、セキュリティ、公開の各ゲートについては、公開手順を参照してください。

デフォルトのテストスイートはネットワークに一切接続しません。ルーティングされたfetchスタブは、一致しないリクエストがあると例外をスローします。別個のライブエンドツーエンドテストスイートでは、実際のNode成果物をビルドし、MCP stdio経由で実行して、.env.localに設定されている認証情報を使用します。

bun run test:live       # missing jurisdiction keys are reported as skips
bun run test:live:all   # strict: require User-Agent + GB/KR/JP keys

ライブテストのアサーションは、変動しやすい件数や日付ではなく、識別情報、識別子の形式、ソースホスト、レスポンス構造を確認するため、データの変化に対応できます。一時的な失敗は1回再試行され、呼び出しには時間制限が設けられ、診断情報からは設定済みのキーがマスキングされます。ライブテストのファイルには.live.tsというサフィックスを付けているため、通常のbun testでは検出されません。詳しくはテストの方針を参照してください。簡易チェック用に、小規模なbun run smoke:live SEC/GLEIF診断も引き続き利用できます。

stdioのルール： サーバーはJSON-RPC用にstdoutを確保します。console.logはMCPトランスポートを破損させるため、コントリビューター向けの診断情報はstderrに出力してください。

現在の未対応範囲

対応範囲は既存のツールセットに追加する形で拡大します。インドで今後深掘りする対象は、直近四半期のBSE株式保有状況iXBRL/XMLからのCompanyOwnersです。年次報告書PDFの所有者一覧表は、対象文書の形式が不規則すぎるため、意図的に解析していません。10月20日のソース確認では、最新情報の探索が現在ブロックされており、旧エンドポイントからは古いデータが提供されることが確認されました。そのため、最新のデータ群が検証されるまで、所有者情報には対応しません。その他の未対応範囲は、空のデータとして表すのではなく、国・地域ごとに記載しています。提案や問題の報告はGitHubで歓迎します。

ライセンス

Apache-2.0。Copyright Carrotly AI.