otwarteAPI.pl
Official public & government APIs, dozens of countries: registers, statistics, open data. Keyless.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http otwarteapi-pl 'https://otwarteapi.pl/mcp'
{
"mcpServers": {
"otwarteapi-pl": {
"type": "http",
"url": "https://otwarteapi.pl/mcp"
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
otwarteapi-catalog
Publiczne dane katalogu stojące za otwarteAPI.pl — katalogu publicznych API rządowych z całego świata (Polska, Unia Europejska i kraje z 6 kontynentów — 40 jurysdykcji), opisanych tak by mogły być odkrywane i wywoływane przez agentów AI oraz ludzi.
Co to jest
ai-catalog.json w formacie ARD (Agent Resource Directory) — jeden
maszynowo czytelny plik opisujący każde API: nazwę, opis, endpoint,
wymagany klucz/autoryzację, jurysdykcję (kod kraju, EU lub INT), tagi i
przykładowe zapytania. Ten sam plik serwuje sama strona pod
otwarteapi.pl/.well-known/ai-catalog.json.
Kto to prowadzi
Bartosz Kuć (ten sam autor co skanfirmy.pl), prywatny projekt non-profit. Kontakt: info@otwarteapi.pl. Więcej na otwarteapi.pl/o-projekcie.
To jest lustro, nie źródło prawdy
To repozytorium to kopia stanu produkcyjnego, aktualizowana ręcznie. Zaakceptowane PR-y i issue trafiają najpierw tutaj do przeglądu, a dopiero potem są ręcznie przenoszone do prywatnego repo, które faktycznie zasila stronę produkcyjną — nie ma automatycznej synchronizacji w żadną stronę.
Jak zgłosić nowe API lub poprawkę
- Nowe API: otwórz issue albo PR dodający wpis do
entries[]wai-catalog.json. Wymagane pola:identifier(URN, np.urn:air:otwarteapi.pl:api:twoj-slug),displayName,description,url(dokumentacja techniczna),type,jurisdiction(PL/EU/kod kraju),tags,metadata.auth(brakjeśli bez klucza), orazrepresentativeQueries(2-3 przykładowe pytania, po jednym w naturalnym języku). API musi być publiczne, oficjalne (rządowe, samorządowe lub międzynarodowej instytucji publicznej) i mieć żywą, działającą dokumentację. - Poprawka istniejącego wpisu (zmieniony endpoint, nieaktualny opis, błędna jurysdykcja): PR edytujący konkretny wpis, z krótkim uzasadnieniem w opisie PR.
- Każdy PR jest ręcznie recenzowany pod kątem poprawności i tego, czy
API faktycznie działa (żywy
curl/test), zanim trafi do wersji produkcyjnej.
Licencja
MIT — patrz LICENSE. Same dane API pozostają własnością i na licencji swoich pierwotnych źródeł (rządów/instytucji UE); ten plik tylko je katalogizuje i linkuje do oficjalnej dokumentacji.
Questions fréquentes
Qu'est-ce que otwarteAPI.pl ?
Official public & government APIs, dozens of countries: registers, statistics, open data. Keyless.
Comment installer otwarteAPI.pl ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http otwarteapi-pl 'https://otwarteapi.pl/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour otwarteAPI.pl ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
otwarteAPI.pl est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient otwarteAPI.pl ?
Il est publié par bartosz-kuc. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.