otwarteAPI.pl

Name: otwarteAPI.pl
Author: bartosz-kuc

远程服务

github.com/bartosz-kuc法律与政务0今天更新

代码仓库

关于 otwarteAPI.pl

otwarteAPI.pl 是面向 AI Agent 和人的公共 API 目录，以机器可读的 ARD 文件整理全球 40 个司法辖区的官方公共服务 API，并附示例查询与认证信息。

主要功能

01机器可读的 ARD 目录
02涵盖 40 个司法辖区
03列出端点与认证要求
04提供自然语言示例查询

适用场景

01发现政府及国际公共机构 API
02检查 API 的端点和认证信息

MCP 相关

该项目提供供 AI Agent 发现和调用 API 的 ARD 目录；输入未说明它是 MCP 服务。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://otwarteapi.pl/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http bartosz-kuc-otwarteapi https://otwarteapi.pl/mcp

Cursor.cursor/mcp.json{"mcpServers":{"bartosz-kuc-otwarteapi":{"type":"http","url":"https://otwarteapi.pl/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"bartosz-kuc-otwarteapi":{"type":"http","url":"https://otwarteapi.pl/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"bartosz-kuc-otwarteapi":{"type":"http","url":"https://otwarteapi.pl/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"bartosz-kuc-otwarteapi":{"serverUrl":"https://otwarteapi.pl/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

参数	类型	必填	说明
limit	integer	否	最大结果数（1–92，默认值为 8）。
temat	string	否	用于缩小范围的标签，例如“firmy”“dane-statystyczne”“bez-klucza”。可选。
zasieg	string	否	用于缩小范围的司法管辖区代码，例如 PL、EU、DE、GB、US。可选。
zapytanie	string	否	自然语言查询（PL 或 EN），例如“sprawdź VAT firmy w Estonii”或“company register Germany”。可选。

详细介绍

otwarteapi-catalog

otwarteAPI.pl 背后的公开目录数据—— 一个收录全球各地政府公共 API 的目录，涵盖波兰、欧盟以及 6 大洲的国家（共 40 个司法辖区）。这些 API 的描述方式便于 AI Agent 和人们发现并调用。

这是什么

ai-catalog.json 是 ARD（Agent Resource Directory） 格式的文件，以机器可读的方式描述每个 API：名称、说明、端点、所需密钥/授权、司法辖区（国家代码、EU 或 INT）、标签和示例查询。网站本身也通过 otwarteapi.pl/.well-known/ai-catalog.json 提供同一文件。

由谁维护

Bartosz Kuć（也是 skanfirmy.pl 的作者）的个人非营利项目。联系方式：[email protected]。更多信息请访问 otwarteapi.pl/o-projekcie。

这是一个镜像，不是事实来源

此代码库是生产环境状态的副本，由人工更新。获批的 PR 和 issue 会先提交到这里审核，然后再由人工转移到实际为生产网站提供数据的私有代码库——两个方向都不会自动同步。

如何提交新 API 或修正内容

新 API：创建 issue，或提交 PR，在 ai-catalog.json 的 entries[] 中添加条目。必填字段：identifier（URN，例如 urn:air:otwarteapi.pl:api:twoj-slug）、displayName、description、 url（技术文档）、type、jurisdiction（PL/EU/国家代码）、 tags、metadata.auth（无需密钥时填写 brak），以及 representativeQueries（2-3 个示例问题，每个使用一种自然语言）。 API 必须是公开且官方的（来自政府、地方政府或国际公共机构），并且有可访问、正常运行的文档。
修正现有条目（端点已更改、说明过时、司法辖区错误）：提交 PR 修改相应条目，并在 PR 描述中简要说明理由。
每个 PR 都会经过人工审核，以确认内容准确且 API 确实可用（通过可运行的 curl/测试），之后才会进入生产版本。