Cnmv Filings

@pipeworx/cnmv-filings

CNMV（Comisión Nacional del Mercado de Valores）の公開登録簿から取得した、スペイン上場企業の規制対象開示情報と年次財務報告書です。ESEF 報告書パッケージも含まれます。開示情報は登録から数分以内に掲載されます。コミュニティの ESEF インデックスのように、数か月後まで待つ必要はありません。

Pipeworx の一部です。AI エージェントを 1875 件以上のライブデータソースに接続する MCP ゲートウェイです。これは独立した非公式の連携機能であり、上流プロバイダーとは提携しておらず、承認も受けておらず、公開もされていません。

ツール

• cnmv_search_filings(date_from?, date_to?, nif?, isin?, company?, feed?, limit?) 公開期間（マドリードの暦日。開始日と終了日を含み、既定では過去 7 日間）で開示情報を検索します。発行体を指定して絞り込むこともできます。「Otra información relevante」（決算、年次・半期報告書の通知、自社株買い、ガバナンス）と「Información privilegiada」（内部情報）を対象に、最新の情報から返します。各行には、企業名、NIF、カテゴリー、タイトル、登録番号、マドリード時間の published_at、文書 URL が含まれます。total_count は指定期間の正確な件数です。
• cnmv_annual_reports(nif? | isin? | company?, limit?) は、発行体の年次財務報告書登録情報を返します。会計年度末、公開日、監査人、監査意見、個別および連結報告書へのリンク、さらに ESEF 報告書パッケージ URL（ZIP。.xbri という名前の場合もあり、iXBRL 報告書とタクソノミファイルを格納。FY2020 以降）が含まれます。
• cnmv_find_issuer(company? | isin?) は、企業名またはスペインの ISIN から、CNMV の登録簿で使われている NIF を特定します。

このパックが存在する理由

esef-filings は filings.xbrl.org をプロキシします。2026-09-23 時点で、このインデックスには FY2024 のスペインの報告書が 113 件あった一方、FY2025 は 1 件でした。CNMV は、インデックスが情報を集約する一次ソースです。同日に計測したところ、Técnicas Reunidas の FY2025 年次財務報告書は、マドリード時間の 2026-02-26 21:25 に登録されており、ESEF ZIP（5.5 MB、LEI 213800JEZBUPZKWJGF49）は cnmv_annual_reports が返す URL からダウンロードできました。登録簿で最新の OIR 行は、同日に照会した時点で 19:48 のものでした。

⚠️ 呼び出し側が知っておくべきこと

1. これは文書インデックスであり、XBRL ファクト API ではありません。 ESEF パッケージの解析は行いません。esef_package_url は、下流のパイプラインで取り込めるように用意されています。
2. 発行体のキーはスペインの NIF です（例：A-28092583。ハイフンなしで A39000013 のように記載されることもあります）。ISIN と LEI は登録簿のキーではありません。isin は CNMV の ISIN 登録簿を通じて解決されます。この登録簿には、スペインで発行された証券のみが記載されています。マドリードに上場している外国の発行体は N… で始まる NIF を持ち、スペインの ISIN はありません。そのため、該当する場合は company または nif を使ってください。
3. 名前検索では複数の事業体が一致することがあります。 「banco santander」では、BRL-000356 のようなコードを持つ外貨建て上場銘柄を含め、6 件が一致します。このパックは最も近い国内の名称を選び、残りを issuer_candidates に一覧表示します。名前が曖昧な場合は、候補を確認してください。
4. タイムスタンプはソースのマドリード現地時間です。published_at には +01:00/+02:00 のオフセットが含まれます。published_local は元の文字列です。

認証

キーは不要です。アカウントも API キーも必要ありません。すべて cnmv.es で公開されています。

データソース

• https://www.cnmv.es/portal/otra-informacion-relevante/resultado-oir.aspx?fechaDesde=DD/MM/YYYY&fechaHasta=DD/MM/YYYY[&nif=…][&page=N] は「Otra información relevante」登録簿です。1ページあたり10件で、page は 0 始まりです。
• https://www.cnmv.es/portal/informacion-privilegiada/resultado-ip.aspx は 「Información privilegiada」登録簿で、同じパラメーターを受け取ります。
• https://www.cnmv.es/portal/consultas/ifa/listadoifa.aspx?id=0&nif=… は 1発行体の年次財務報告登録簿です。
• https://www.cnmv.es/portal/Consultas/BusquedaPorEntidad は事業体名の 検索ページ（ASP.NET のポストバック）です。
• https://www.cnmv.es/portal/ancv/isin?isin=… は ISIN 登録簿です。
• https://www.cnmv.es/webservices/verdocumento/ver?t=…|e=… はドキュメントの ダウンロードハンドラー（PDF／ZIP）です。テスト時、これらの URL はページの 再読み込み後も変わりませんでした。

注意点

• errorcode=CVFE を伴う 403 は、ポータルの「見つかりません」ページであり、ブロックではありません。 メッセージは「No ha sido posible completar su consulta. Verifique la ruta.」 です。存在しないパス（/portal/nonexistent-xyz.aspx）でも同じ応答が返ります。 古い HR/ComunicacionesRR.aspx と Consultas/IFA/InformesFinancierosAnuales.aspx のパスは存在しないため、この応答を返します。2020 年以前の「Hechos relevantes」 フィードは、2020-02-08 に OIR と IP に分割されました。このパックは、この応答を not_found: エラーに変換します。
• nif を指定せずに listadoifa.aspx を呼び出すと、400 errorcode=HE が返ります。
• .aspx URL は拡張子なしの URL に 301 リダイレクトするため、リダイレクトに従ってください。
• OIR／IP の結果ページには「Página 1 de N」と表示されますが、行数は表示されません。このパックは 正確な合計を (N-1)*10 + 最終ページの行数 として計算します。対象期間が limit に 必要なページ数を超える場合、追加のリクエストが 1 回発生します。
• 「Últimos días」の概要ページ（Consultas/BusquedaUltimosDias.aspx）が日ごとに カテゴリー別に数えるのは、届出ではなく発行体です。その数値は同じ日の total_count より小さくなりますが、これは想定どおりです。
• 事業体検索では WebForms の状態が必要です。__VIEWSTATE、 __VIEWSTATEGENERATOR、__EVENTVALIDATION をフォーム形式で POST し、 コントロール名の $ は %24 として送信してください（ここで動作を確認したエンコード方式です。 CNMV では $ をそのまま使う方法はテストしていませんが、ほかの WebForms サイトでは HTTP 200 でフォームが黙って再表示されます）。一致する候補が 1 件の場合は、事業体ページにリダイレクトされます。 候補が複数ある場合は、NIF → 名称の select リストが表示されます。

クイックスタート

お使いの MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加してください：

{
  "mcpServers": {
    "cnmv-filings": {
      "url": "https://gateway.pipeworx.io/cnmv-filings/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/cnmv-filings/mcp の tools/list は、上の表にあるツールに 加えて、共有 Pipeworx メタツール（ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で使える ツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックの エンドポイントには、パック独自のツールとともに、およそ 30 個の共有ツールが一覧表示されます。 接続の initialize 応答には正確なスコープが記載されており、その日の状況を確認する際の 確定情報となります。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使うと、このパックが 対応していない質問にも、カタログ全体を対象にルーティングする ask_pipeworx を通じて 回答できます。そのため、MCP サーバーをもう 1 つ追加する必要はありません。現在、メタツールを 含めずにパックのエンドポイントをマウントする方法はありません。追加のスキーマによる コンテキスト消費が、ルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、 フルゲートウェイに一度だけ接続してください。

このパックだけでなく、すべてのパックのツールを直接一覧表示するには、Pipeworx の フルゲートウェイに接続してください：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと同じ 1875 以上のデータソースに接続します。 異なるのは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、 ask_pipeworx を通じてすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/cnmv_search_filings \
  -H 'Content-Type: application/json' \
  -d '{"date_from":"2026-09-21","date_to":"2026-09-23","limit":5}'

最初の呼び出しではアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/cnmv_search_filings を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントもゲートウェイへの往復通信も不要です。

{
  "mcpServers": {
    "cnmv-filings": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-cnmv-filings"]
    }
  }
}

または、直接実行して起動を確認します。

npx -y @pipeworx/mcp-cnmv-filings

stdin/stdout 経由で MCP を使用し、このパックのツールのみを対象に initialize/tools/list/tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールはありません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx の使用

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは上記のパックエンドポイントと、ゲートウェイ全体の両方で機能します。

ask_pipeworx({ question: "your question about Cnmv Filings data" })

ゲートウェイが適切なツールを選び、引数を自動的に入力します。

詳細情報

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT