Oneinfo Storage

@pipeworx/oneinfo-storage

イタリアの規制対象企業による開示情報を1INFOから直接取得します。タイトル、発行体、カテゴリー、タイムスタンプ、文書リンクを含む文書インデックスで、同日中に更新されます。EU透明性指令に基づく届出の公式指定メカニズム（OAM）として、eMarket Storageではなく1INFOを利用する約314の発行体を対象としています。

Pipeworxの一部です。AI エージェントを1807以上の稼働中のデータソースに接続するMCPゲートウェイです。独立した非公式の連携であり、上流プロバイダーとの提携、承認、公開はありません。

ツール

• oneinfo_search_disclosures(company?, ndg?, category?, date_from?, date_to?, limit?, offset?) — 発行体（名称。1INFO独自の314発行体リストと照合されます。または既知のndg）、カテゴリー、および／または公開日の期間を指定して開示情報を検索します。新しいものから順に返します。
• oneinfo_get_disclosure(id, date) — protocolCodeと公開日を指定して開示情報を1件取得します（どちらも事前の検索結果から取得します。このソースにはIDのみで検索する機能はありません）。

このパックが存在する理由 — emarket-storageとは別になっている理由

イタリアには、透明性指令に基づく開示情報を扱う公式指定メカニズムが2つあります。eMarket Storage（Teleborsa）と1INFOです。発行体はどちらか一方を通じて開示を行い、両方に重複して掲載されることはありません。そのため、どちらか一方をもう一方の代わりに使うことはできません。2026-09-24に実際のデータで確認済みです。1INFO独自の314発行体リストにはIRENとSOMECが含まれていますが、どちらもeMarket Storageの選択リストにはありません。STARセグメントの発行体の約半数が1INFOを利用しています。企業がここで見つからない場合は、代わりにemarket-storageのemarket_search_disclosuresをお試しください（逆の場合も同様です。emarket-storageの「見つからない場合」の注記からこちらを参照できます）。

⚠️ 呼び出し元が知っておくべき5つのこと

1. 対象は1INFOに掲載されている発行体のみです。イタリア市場全体ではありません。 企業検索で一致するものがない場合は、エラーだけを返すのではなく、代わりに emarket-storage を案内する説明的な note を返します。このパックはeMarket Storageのデータを統合しません。
2. これは文書インデックスであり、XBRL事実データAPIではありません。 各行は開示イベントを表します。タイトル、発行体、カテゴリー、公開日時、元文書へのリンクが含まれます。個々の事実データの抽出はありません。イタリアの年次報告書のXBRL事実データ（純利益、収益など）には、esef-filings（filings.xbrl.orgのプロキシ）を使用してください。2026-09-24時点の測定では、1INFOの発行体（SOMEC、IREN、Softlab）の年次報告書は、ここに保存された後、約6日でfilings.xbrl.orgに到達していました。半期報告書については、XBRL事実データのソースはどこにもありません（ESEFは仕組み上、年次報告書のみを対象としています）。そのため、これらの報告書が公開されるのを確認するための構造化された方法は、このパックだけです。
3. ISINはありません。 LEIが含まれるのは、XBRLタグ付き年次報告書ZIPのファイル名に埋め込まれている場合のみです（has_xbrl: true の行。例：SOMECのFY2025 ZIP内の 81560001692D0424C949-2025-12-31-1-it.html）。発行体は名前（1INFO独自のリストに照合）で識別するか、以前の検索で取得済みであれば、ndg（1INFO内部の数値ID）で直接識別してください。
4. date_to は指定日を含みます（Europe/Romeの現地暦で指定する最終日）。emarket-storage とは異なり、このパックは日付を上流に範囲として渡すのではなく、クライアント側で独自にフィルタリングします。そのため、対処が必要な「上流側で最終日を含まない」問題はありません。2026-09-24にライブ検証済み：date_from=2026-09-22&date_to=2026-09-22 は、その日に実際に公開された唯一の開示（UNIDATA）を返し、最終日が含まれることを確認しています。
5. このソースには発行体によるサーバー側フィルターがありません。 2026-09-24にライブ検証済み：1INFOの /API/Documenti エンドポイントは SearchFilter[categoria] を反映します（実際に結果セットが絞り込まれます）が、SearchFilter[ndg] とDataTablesのグローバル検索 search[value] はどちらも黙って無視します。これらを指定しても、指定しなくても recordsFiltered は同じです。このパックは企業名を ndg に解決し、常に保存日降順の結果セットをページングしながら、クライアント側でフィルタリングします。date_from/date_to の期間を指定した場合は、スキャンを完了します（安全上限として上流へのリクエストは最大6回、約6,000行まで）。企業のみを指定し期間を指定しない検索は、limit 件の一致が見つかった時点で停止します。処理は軽量ですが、発行体の古い提出書類が見つからない可能性があります。すべての応答で、スキャンした範囲（scanned.oldest_date_local、scanned.stopped_reason）と、matched_in_scanned_range が対象範囲の正確な件数（range_fully_scanned: true）か、下限にすぎないかを正直に示します。合計件数を捏造することはありません。

認証

キー不要です。アカウントもAPIキーも必要ありません。

データソース

• https://www.1info.it/PORTALE1INFO/ — 1INFOの公開開示保存ポータル（イタリアのEU透明性指令OAM）。Pipeworxは呼び出しのたびにJSON APIへリアルタイムでクエリします。一括ダウンロードはありません。

注意点

• 正式な REST API ではなく、DataTables のサーバーサイドエンドポイントです。 POST /PORTALE1INFO/API/Documenti には、標準の DataTables フォーム フィールド（draw、columns[0][...]、order[0][...]、start、length）が必要です。 これらを含まない単純な POST は、サーバーサイドの NullReferenceException で失敗します。 GET /PORTALE1INFO/API/companies/documenti（発行体 314 社）と GET /PORTALE1INFO/API/documenti/Categories は通常の GET リクエストです。
• ダウンロード URL には、1INFO 自身の JSON には表示されない .pdf サフィックスが必要です。気づきにくい 404 の落とし穴です。 PdfShow.aspx は、クエリパラメーターとして file（書類コード）と year（会計年度）を受け取ります。行に XBRL パッケージ （protocolCodeXbrl が null ではない場合。例："165960_oneinfo.zip"）があるときは、 その値でそのままダウンロードできます。ただし protocolCodeXbrl が null の場合、 つまりすべての半期報告書と補足書類など、大半の行では、protocolCode （例："171904_oneinfo"）だけを使うと、何が問題なのか示されないまま Error.aspx …documento non trovato に 302 リダイレクトされます。 .pdf（"171904_oneinfo.pdf"）を追加すると正しく解決します。2026-09-24 に 3 つの異なる発行体／カテゴリー（UNIDATA REGEM、Banca Sistema 3.1、SOMEC 1.2）で ライブ確認済みです。いずれもサフィックスなしでは 302、ありでは HTTP 200 でした。
• year は保存年ではなく、dataEsercizio の会計年度です — 同じ日に保存された同じ報告書の 2 つの提出書類でも異なる場合があります。SOMEC の FY2025 年次報告書は、ESEF 形式の ZIP と通常の PDF の 2 つの関連行として、2 分差で保存されました。 一方は year=2025、もう一方は year=2026 でした。どちらもライブ確認済みで、 相手の年ではなく、それぞれ算出した年を指定する必要があります。
• 会社名の解決では、1INFO 独自の発行体選択リスト（/API/companies/documenti に 埋め込まれています）に対して rankMatches（完全一致 > 前方一致 > 単語全体の一致 > 部分文字列一致）を使用します。同じスコアの発行体が複数ある曖昧な一致の場合は、 推測せずに candidates を返します。
• categoria フィルターでは複数の値を含む行を指定できます — 1 件の開示に複数のコード （例："1.2,2.2"）が付く場合があります。category_labels にはその行のすべてのコードが 反映され、category によるフィルタリングは完全一致ではなく、コードが含まれるかどうかで 判定されます。
• 日付は手動の UTC オフセットではなく、Intl.DateTimeFormat を使って Europe/Rome 時間で 計算されます（夏時間に対応）。ソース JSON の dataStoccaggio／dataEsercizio は、 タイムゾーンのマーカーがない Unix 秒の生タイムスタンプです。
• oneinfo_get_disclosure にはソース側に ID を直接指定するエンドポイントがありません。 そのため、指定日の一覧を再スキャンし（最大 3 リクエスト／3,000 行。市場全体で最も件数が 多い単日分を大幅に上回ります。約 5 年間で 33,444 行を実測）、protocolCode で照合します。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

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

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

https://gateway.pipeworx.io/oneinfo-storage/mcp の tools/list は、上記の表にあるツールに加えて、共有の Pipeworx メタツール（ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で利用できる一連のツール）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、そのパック独自のツールとともに、共有ツールが約 30 個リストされています。接続の initialize 応答には正確な対象範囲が記載されており、その日の状況を確認するための正式な回答となります。

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

または、フル Pipeworx ゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接リストされます。

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

どちらの URL でも、同じゲートウェイと同じ 1807 以上のデータソースにアクセスできます。違いは、どのパックのツールが直接リストされるかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/oneinfo_search_disclosures \
  -H 'Content-Type: application/json' \
  -d '{"date_from":"2026-09-17","date_to":"2026-09-24"}'

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

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

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

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

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

npx -y @pipeworx/mcp-oneinfo-storage

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

ask_pipeworx を使う

ツールを直接呼び出す代わりに、平易な英語で質問できます。これは上記のパックエンドポイントでも、フルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Oneinfo Storage data" })

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

その他

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

ライセンス

MIT