English Français العربية

otwarteAPI.pl

السجل الرسمي البيانات وقواعدها

Official public & government APIs, dozens of countries: registers, statistics, open data. Keyless.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http otwarteapi-pl 'https://otwarteapi.pl/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "otwarteapi-pl": {
            "type": "http",
            "url": "https://otwarteapi.pl/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. otwarteapi-catalog
  2. Co to jest
  3. Kto to prowadzi
  4. To jest lustro, nie źródło prawdy
  5. Jak zgłosić nowe API lub poprawkę
  6. Licencja

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ę

  1. Nowe API: otwórz issue albo PR dodający wpis do entries[] w ai-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 (brak jeśli bez klucza), oraz representativeQueries (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ę.
  2. Poprawka istniejącego wpisu (zmieniony endpoint, nieaktualny opis, błędna jurysdykcja): PR edytujący konkretny wpis, z krótkim uzasadnieniem w opisie PR.
  3. 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.

الأسئلة الشائعة

ما هو otwarteAPI.pl؟

Official public & government APIs, dozens of countries: registers, statistics, open data. Keyless.

كيف أثبّت otwarteAPI.pl؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http otwarteapi-pl 'https://otwarteapi.pl/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج otwarteAPI.pl إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل otwarteAPI.pl مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون otwarteAPI.pl؟

ينشره bartosz-kuc. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.