Bodacc

@pipeworx/bodacc

フランスの企業関連公式公告（BODACC — 企業・商事公告公報）：企業ごとの日付付き公告。会社設立、倒産手続き（再建・清算）、事業の売却・譲渡、登記抹消、変更、年次会計書類の提出を扱います。

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

ツール

• bodacc_company_events(siren | name, event_type?) — 1社のBODACCイベント履歴を新しい順にすべて取得します。siren は entreprises-fr パックおよび insee パックで使われるものと同じ9桁のIDです。そこで検索したSIRENをそのままこのツールに渡せます（またはその逆も可能です）。
• bodacc_search(q?, name?, event_type?, departement?, since?, until?, siren?) — すべてのBODACC公告を対象とした自由検索です。q は公告全文（名称、活動内容、判決・行為の文面、住所など）を検索します。name は企業名のみを照合する、個別フィールドを対象とした検索です。イベントの種類、県、日付範囲、SIRENでも絞り込めます。
• bodacc_insolvency_feed(since, until?, departement?) — 指定日以降に公開された倒産関連（familleavis=collective）のみの公告を、新しい順に取得します。更新される since を指定して、定期取得やモニタリングを行う用途に向いています。
• bodacc_get_notice(id) — BODACC IDを指定して、単一の公告を取得します。

認証

認証キーは不要です。上流のDILAのOpendatasoftポータルでは、このデータセットへの読み取りアクセスに登録やAPIキーは必要ありません。

データソース

• https://bodacc-datadila.opendatasoft.com/api/explore/v2.1/catalog/datasets/annonces-commerciales/records — BODACC のライブレコード API（Opendatasoft Explore v2.1）です。約 5,000 万件以上の行があり、新しい公告の公開に合わせて更新されます（営業日の毎日）。

注意点：

• このデータセットでは offset + limit が 10,000 に制限されています（ライブで確認済み： offset=9999&limit=2 → 400 InvalidRESTParameterError）。API レスポンスの total_count に上限はありません。制限されるのは、その中でページネーションを進められる範囲のみです。 すべてのツールは total_count、count（実際に返された行数）、および truncated フラグ（total_count が 10,000 を超えているときに offset + limit >= 10000 の場合に設定）を返すため、呼び出し元が上限を実際の件数と 誤解することはありません。広範なクエリでは、event_type／departement／日付範囲で絞り込み、 上限内に収めてください。
• registre はスカラーではなく配列です。例：["805243102", "805 243 102"] （同じ SIREN の数字のみの形式と、スペースで区切った形式）。ODSQL の registre="805243102" は配列を直接検索します。このパックでは、フィルターの作成前に 入力された SIREN からスペースを必ず取り除き、レコードの整形時には registre[0]（数字のみ）を読み取ります。
• 上流のフィールドのほとんどは、すべてのレコード共通ではなく、ファミリーごとに設定されます。 jugement は倒産／調停の公告、acte は設立／売却、 radiationaurcs は登録抹消、modificationsgenerales は変更、 depot は決算書類の提出に設定され、それ以外は該当するレコードでは null です。各フィールドはネストされたオブジェクトではなく、JSON を格納した 文字列 です。このパックでは、これらのうち null ではないフィールドを解析し、 公告ごとに単一の detail オブジェクトにまとめて、上流の生フィールド名をそのまま公開しません。
• familleavis のコード（event_type に渡します）：creation、 immatriculation、collective（倒産）、conciliation、 retablissement_professionnel、modification、radiation、dpc （決算書類の提出）、vente（売却／譲渡）、divers。正しいコードの情報源は、 同じ Opendatasoft ドメインの ac_mapping_famille_avis データセットです。 event_type は英語の別名も受け付けます（sale／transfer→vente、 insolvency／bankruptcy→collective、deregistration／deletion→ radiation、accounts→dpc、registration→immatriculation）。認識されない値は、 有効なコードを示すエラーをスローし、total_count: 0 を黙って返すことはありません （2026-09-23 修正：以前は event_type: "sale" によって familleavis="sale" が生成されていました。これは上流フィールドの値として存在しますが、 一致するレコードはありません）。
• ODSQL の search() は、フィールドを省略しない限り、そのフィールドのみを検索します。 search(commercant, "...") は commercant フィールドのみを検索します（登記上の会社名）。 フィールドを指定しない search("...") は、インデックス化されたすべてのフィールド （事業内容、判決／証書のテキスト、住所など）を検索します。 bodacc_search の q は、意図的にフィールドを指定しない形式を使用します。 フィールドを指定した形式では、会社名には決して現れない語句である q: "fonds de commerce" に対して total_count: 0 が黙って返されましたが、 フィールドを指定しない形式では同じクエリで 3,188 件が返されることを 2026-09-23 にライブで確認しています。名前のみを意図的に検索するには、q の代わりに name を使ってください。
• ここでの呼び出しはすべて、リクエストごとに上流エンドポイントへ直接アクセスします。 この API には API キーが不要で、通常のクエリ量であれば実質的なレート制限もありません。 また、since で期間を指定する監視クエリは、自然に 10,000 件のページネーション上限を 十分に下回ります。

クイックスタート

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

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

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

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

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

または、フルの Pipeworx ゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールを直接一覧表示できます。

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

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

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

curl -X POST https://gateway.pipeworx.io/v1/tools/bodacc_company_events \
  -H 'Content-Type: application/json' \
  -d '{"siren":"805243102"}'

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

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

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

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

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

npx -y @pipeworx/mcp-bodacc

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

ask_pipeworx の使い方

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

ask_pipeworx({ question: "your question about Bodacc data" })

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

詳細

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

ライセンス

MIT