Amf Filings

@pipeworx/amf-filings

Info-financière（フランスの公認指定メカニズム（OAM））が提供する、AMF 規制対象企業の開示情報（業績、保有比率の基準値超過、重要な未公開情報、自社株買いなど）。AMF の公開に合わせて更新され、コミュニティ ESEF インデックスのように数カ月遅れることはありません。

Pipeworx の一部です。AI エージェントを 1872 以上の稼働中データソースに接続する MCP ゲートウェイです。これは独立した非公式の連携であり、上流プロバイダーとは提携関係になく、承認も受けておらず、同社から公開されたものでもありません。

ツール

• amf_search_filings(company?, isin?, lei?, date_from?, date_to?, language?, limit?, offset?) — 発行体（ISIN を推奨。LEI は null の場合が多く、自由入力の名称も指定可能）および／または公開日の範囲で開示情報を検索します。date_to はINCLUSIVE（含める最終日）です。1 日分を確認するには、date_from と date_to に同じ日付を指定してください。新しい順に返します。
• amf_get_filing(id) — Info-financière のレコード ID（uin_idt_uin）を指定して開示情報を取得します。この ID は amf_search_filings の返却値から取得できます。

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

esef-filings は filings.xbrl.org をプロキシしますが、これはコミュニティのインデックスであり、フランスの発行体については当年分のカバレッジが実質的にありません。週次の株式分析パイプライン向けに当社を評価していた、名前が特定された外部開発者が実際にこの問題に直面し、それを理由にこのパックを却下しました。このパックがまだ存在していなかった時点である 2026-09-23 に、ライブデータで測定しました。

フランス、ESEF インデックス（filings.xbrl.org）：  2023：~ok   2024：~ok   2025：ほぼゼロ

このパックはアグリゲーターではなく、一次ソースにアクセスします。データ鮮度の測定値、2026-09-23：データセット内の最新レコードは、それを見つけたクエリの約 1 分前にタイムスタンプが付与されていました。「昨日から今日まで」の date_from／date_to 範囲を指定すると、同日中の開示情報が安定して返されます。デプロイ済みゲートウェイへのライブ呼び出しで検証済みです（実際に使用した引数は workers/gateway/src/tool-examples.json を参照してください）。

発行体ごとに 1 回ではなく、1 日に 1 回の呼び出し

company、isin、lei はすべて省略可能です。これらをすべて省略し、date_from／date_to だけを渡すと、その期間におけるすべての発行体の開示情報を 1 回の呼び出しで取得できます（市場全体の 1 日分の件数が 100 行の上限を超える場合に限り、limit／offset でページ分割してください）。2026-10-19 にライブで検証済みです。ある設計パートナーは約 155 の発行体を毎日確認するために発行体ごとに呼び出し、約 35 回で 1 回あたり 50 クレジットの上限を使い切っていました（フリート #3300）。日付範囲での呼び出しなら、この確認を低コストで行えます。

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

1. これは文書インデックスであり、XBRLファクトのAPIではありません。 各行は開示イベントです。タイトル、発行者、公表日時、元のPDF（場合によってはESEF/XBRLパッケージ）へのリンクが記録されています。ファクトごとの抽出には対応していません。「2025年度の純利益を教えて」といった検索はできません。同じ発行者について、このOAM経由で filings.xbrl.org 形式の構造化ファクトにアクセスできるかどうかは、このパックの構築時には検証していません。このパックが保証することではなく、別途確認が必要な未解決の問題として扱ってください。
2. LEIは頻繁にnullです。 identificationsociete_iso_cd_lei は多くの行に設定されていますが、すべてではありません。ISIN（identificationsociete_iso_cd_isi）のほうがはるかに信頼性が高いため、結合キーとして優先してください。このパックに対してLEIだけに依存するパイプラインを構築しないでください。LEIで見つからなくても、「提出書類がない」という意味ではありません。
3. フランスに登記された発行者だけが対象ではありません。 このフィードには、フランスの開示配信事業者を通じて開示するすべての発行者が含まれます。これには、フランス企業グループのフランス国外の子会社（例：ガボンに登記されたTotalEnergies EP Gabon）も含まれます。country はAMFの記録にある発行者自身の登記国を示すもので、既定で「フランス」になるわけではありません。
4. company は自動フォールバックを伴い、商号ではなく正式名称に一致します。 AMFは発行者を登記上の正式名称（例：「TELEVISION FRANCAISE 1」）で登録しています。また、search() は部分文字列ではなくトークンに基づくため、company: "TF1" のように商号で検索しても、同じ期間内に実際には38件存在するにもかかわらず、該当行は0件になります（2026-10-19、fleet #3300でライブ検証済み）。正式名称で検索して結果がない場合、amf_search_filings は開示タイトルで再試行するようになりました。タイトルで見つかった場合、レスポンスには matched_via: "title" と company_resolved（実際の正式名称）が含まれます。フォールバックを完全に省略するには、手元にある場合は isin を渡してください。
5. subtype_of_information は実際の null に正規化されます。 一部の配信事業者（特に307）は、実際のnullではなく文字列の "NULL" を送信します（前回確認時で9,519行）。このパックは、大文字と小文字を区別せず、"null" という文字列を実際のnullに変換してから返します。
6. date_to は指定したUTC日の終日を含みます。 1日だけを確認する場合は、date_from と date_to に同じ日付を設定します。このパックは上流の排他的な境界を内部で処理し（1暦日先まで検索）、実際に送信した境界を upstream_date_to_exclusive として返します。以前はそうではありませんでした。同日を指定した期間（date_from=date_to="2026-10-16"）では、該当する行が61件あったにもかかわらず、上流の境界をそのまま排他的な値として渡していたため、何も通知されず0件が返されていました。この問題は2026-10-20に修正されました（毎日、全発行者を対象にESEFの確認を実行している有料顧客が、直接この問題に遭遇しました）。date_from が date_to より後の日付の場合は、単に0件を返すのではなく、説明を記載した message とともに empty_reason: "empty_window" を返すようになりました。

バイリンガルの発行者は、同じ開示をフランス語版と英語版で別々の行として、同じ1分以内に提出します（それぞれ独自の id を持ちます）。 amf_search_filings はこれらを統合しません。どちらか一方の版を選ぶには language を渡すか、返された language_pair_key（会社名＋種別／サブタイプ＋公表分）を使ってクライアント側で結果をグループ化してください。

認証

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

データソース

• https://www.info-financiere.gouv.fr/api/explore/v2.1/catalog/datasets/flux-amf-new-prod/records — Opendatasoft Explore v2.1 records API、flux-amf-new-prod データセット （執筆時点で500,000件以上のレコード）。これはAMFの主要な開示フィードであり、そのミラーやキャッシュではありません。Pipeworxは呼び出しのたびにライブでクエリします。

注意点

• 旧ホスト www.info-financiere.fr はすべてのリクエストを www.info-financiere.gouv.fr に 301 リダイレクトします。このパックでは、往復を省くため .gouv.fr ホストを直接呼び出します。
• limit は上流 API により 100 に上限設定されています（-1 <= limit <= 100）。これを超える値を指定すると、黙って上限に丸められるのではなく、400 エラーになります。このパックではリクエスト送信前に 100 まで上限を丸め、丸めた場合は元の値をレスポンスの limit_clamped_from として返すため、黙って処理されることはありません。
• uin_dat_amf（提出日時）に対する ODSQL の where 句は実際に機能します。同日除外テストで実環境にて検証済みです。このパックは、同系列の esef-filings における日付フィルターの不具合を繰り返さないように作成されています。
• 会社名フィールドに対する search() は、ODSQL のセマンティクスに従う緩やかなトークン一致であり、完全一致の名前フィルターではありません。ある発行体を検索すると、類似した名前の関連会社（子会社など）が結果に含まれることがあります。isin がわかっている場合は、そちらを優先してください。

クイックスタート

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

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

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

https://gateway.pipeworx.io/amf-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 も同じゲートウェイと同じ 1872 以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx ですべてのツールにアクセスできます。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/amf_search_filings \
  -H 'Content-Type: application/json' \
  -d '{"isin":"FR0013230950","limit":3}'

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

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

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

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

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

npx -y @pipeworx/mcp-amf-filings

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

ask_pipeworx を使う

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

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

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

詳細

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

ライセンス

MIT