Bodacc

@pipeworx/bodacc

法国官方企业事件公告（BODACC —《民事和商事公告官方公报》）：按公司列出的带日期公告，包括企业创立、破产程序（司法重整／司法清算）、企业出售／转让、注销、变更和年度账目申报。

Pipeworx 的一部分（https://pipeworx.io）——一个将 AI Agent 连接到 1875+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游提供方无关联、未获其认可，也非由其发布。

工具

• bodacc_company_events(siren | name, event_type?) — 某家公司的完整 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）。约 5000 多万行， 随新公报发布而更新（工作日每日更新）。

注意事项：

• 此数据集的 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 实时确认。 若要有意限定为按字段搜索、仅匹配名称，请使用 name 而非 q。
• 这里的每次调用都会直接请求上游端点：该 API 无需密钥，正常查询量没有实际速率限制， 而使用 since 限定范围的监控查询通常远低于 10,000 条的分页上限。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

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

此端点实际提供的内容

tools/list 在 https://gateway.pipeworx.io/bodacc/mcp 返回上表中的工具，以及 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":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

独立运行（无需网关账户）

此软件包也可以作为本地 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