Oneinfo Storage

@pipeworx/oneinfo-storage

直接获取意大利受监管公司的披露信息，来源为 1INFO——一个文档索引（标题、发行人、类别、时间戳、文档链接），当天更新，涵盖约 314 家使用 1INFO 而非 eMarket Storage 作为《欧盟透明度指令》申报官方指定机制（OAM）的发行人。

该项目是 Pipeworx 的一部分——一个连接 AI Agent 与 1807+ 个实时数据源的 MCP 网关。这是一项独立、非官方的集成，与上游提供方无关联，未经其认可，也并非由其发布。

工具

• oneinfo_search_disclosures(company?, ndg?, category?, date_from?, date_to?, limit?, offset?) — 按发行人（名称会与 1INFO 自有的 314 家发行人名单进行匹配，或使用已知的 ndg）、类别和/或发布日期范围搜索披露信息。结果按时间从新到旧排列。
• oneinfo_get_disclosure(id, date) — 根据 protocolCode 和发布日期获取一条披露信息（两者均来自先前的搜索结果——此数据源不支持仅按 ID 查询）。

为什么需要这个工具包——以及为什么它与 emarket-storage 分开

意大利有两个负责《透明度指令》披露的官方指定机制：eMarket Storage（Teleborsa）和 1INFO。发行人只会通过其中一个进行披露——两者没有重叠，因此不能用其中一个工具包替代另一个。经确认，截至 2026-09-24 的实时信息显示：1INFO 自有的 314 家发行人名单中包括 IREN 和 SOMEC，而这两家未列入 eMarket Storage 的选项列表；约半数 STAR 板块发行人使用 1INFO。如果在此处找不到某家公司，请改用 emarket-storage 的 emarket_search_disclosures（反之亦然——emarket-storage 的未找到提示会指向这里）。

⚠️ 调用方必须了解的五件事

1. 仅涵盖 1INFO 覆盖的发行方——并非意大利全市场。 如果公司搜索没有匹配结果，会返回说明性的 note，而非单纯的错误，并指向 emarket-storage。此工具包不会合并 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）后直接按 ndg 识别。
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 的公开披露存储门户（意大利的欧盟《透明度指令》官方指定机制 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 需要添加 .pdf 后缀，而 1INFO 自己的 JSON 中没有这个后缀——这是一个会静默返回类似 404 的陷阱。 PdfShow.aspx 接受 file（文档代码）和 year（财政年度）两个查询参数。如果某行包含 XBRL 包（protocolCodeXbrl 非空，例如 "165960_oneinfo.zip"），该值可直接用于下载。但当 protocolCodeXbrl 为空时——所有半年度报告、所有附属申报文件，也就是大多数行——如果直接使用 protocolCode（例如 "171904_oneinfo"），请求会 302 重定向到 Error.aspx …documento non trovato，且不会说明错误原因。实际有效的做法是追加 .pdf（"171904_oneinfo.pdf"）——已于 2026-09-24 对三个不同的发行方／类别（UNIDATA REGEM、Banca Sistema 3.1、SOMEC 1.2）进行实时验证：不带后缀时均返回 302，带后缀时均返回 HTTP 200。
• year 是 dataEsercizio 中的财政年度，而非存储年份——同一报告的两份申报文件即使在同一天存储，年份也可能不同：SOMEC 的 FY2025 年报以两条相邻记录存储（一份 ESEF 格式 ZIP 文件和一份纯 PDF 副本），两者相隔 2 分钟；其中一条的 year=2025，另一条的 year=2026——实时验证确认，每条都必须使用各自计算出的年份，不能使用另一条的年份。
• 公司名称解析使用 rankMatches，根据 1INFO 自己的发行方列表进行匹配，优先级依次为：完全匹配 > 前缀匹配 > 整词匹配 > 子串匹配。该列表嵌入在 /API/companies/documenti 中。若多个发行方的匹配得分相同，结果会返回 candidates，而不是自行猜测。
• categoria 筛选器接受多值行——单条披露记录可以包含多个代码（例如 "1.2,2.2"）；category_labels 会反映该行中的每个代码，而按 category 筛选时采用的是成员匹配，不是完全相等匹配。
• 日期通过 Intl.DateTimeFormat 按 Europe/Rome 时区计算（正确处理夏令时），而不是手动使用 UTC 时差——源 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"
    }
  }
}

此端点实际提供的内容

tools/list 在 https://gateway.pipeworx.io/oneinfo-storage/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 都连接到同一个网关和相同的 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