Global law
The law of nearly every country on earth, any date: read it, see what changed it, check citations.
Polish registers: KRS, VAT, parcels, prices, GUS statistics, legal acts, Sejm, REGON/CEIDG.
목록은 사용 점수(100점 만점)로 정렬되며 구성은 다음과 같습니다
| 인기 | 0/80 | GitHub 별 또는 주간 다운로드: 큰 쪽 60, 작은 쪽 20 |
|---|---|---|
| 최신성 | 12/12 | 30일 안에 릴리스나 코드 변경이 있으면 만점 |
| 응답 중 | 0/8 | 마지막 점검 때 클라우드 엔드포인트가 응답 |
| 사용 점수 | 12/100 |
품질: 기본 점검 3/3개 통과(표시만, 정렬에는 안 씀) · 상승세: 데이터 없음 (급상승 탭에서만 사용)
쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.
한 문장으로 AI에게 설치 맡기기
Polish Open Data (unofficial) 설치해 줘. https://mcp.popnx.com/i/jaceksmi-polishopendata.md 를 따라 하고, 명령을 먼저 보여 주고 내가 승인하면 실행해.내 컴퓨터에서 작업하는 AI(Claude Code, Cursor 등)에 붙여 넣으세요. 단계를 읽고 명령을 보여 준 뒤 승인을 기다립니다. 키도 가입도 필요 없습니다. · AI가 읽을 전체 내용 보기
검사 3/3 통과 · 내 컴퓨터에서 실행돼요 · ✓ 명령 확인 2026년 11월 15일
먼저: 어떤 AI를 쓰시나요?
쓰는 앱을 고르면 아래에 단계가 나옵니다.
Claude에 연결할 수 있지만 먼저 준비가 필요해요
키 필요 없음, 설치 필요 없음 · 컴퓨터용 Claude 앱(Windows 또는 Mac)에서만 되고 웹이나 모바일은 안 돼요
이 메시지를 Claude 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.
이 컴퓨터의 Claude에 MCP server Polish Open Data (unofficial)을 설치해 주세요. 순서대로: 1) 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): { "mcpServers": { "polishopendata": { "command": "dnx", "args": [ "PolishOpenData.Mcp", "--yes" ] } } } 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) 키는 필요 없습니다. 5) 합의한 대로 실행한 뒤 Polish Open Data (unofficial)의 도구가 실제로 보이는지 확인하세요.이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.
SettingsDeveloperEdit Config
{
"mcpServers": {
"polishopendata": {
"command": "dnx",
"args": [
"PolishOpenData.Mcp",
"--yes"
]
}
}
}Polish Open Data (unofficial)을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Claude가 Polish Open Data (unofficial)을 쓰고 있다고 하거나 답에 Polish Open Data (unofficial) 도구 이름이 나오면 연결된 거예요
위 명령은 이 값들 없이도 동작합니다. 바꾸고 싶을 때만 제작자 설명대로 추가하세요.
POLISHOPENDATA_OFFLINE_DIR check_vat_bank_account_offline가 사용하는 준비된 VAT 화이트리스트 플랫 파일 색인을 보관하는 폴더(네트워크 공유가 아닌 로컬 디스크). 기본값: 사용자의 로컬 ap… 아래 PolishOpenData/BialaListaOffline POLISHOPENDATA_REGON_KEY 선택 사항. 본인의 무료 GUS BIR 키(regon_bir@stat.gov.pl). lookup_regon 도구를 활성화합니다. 데이터는 본인의 컴퓨터에 남습니다. POLISHOPENDATA_CEIDG_TOKEN 선택 사항. 본인의 무료 CEIDG API 토큰(biznes.gov.pl의 개인 JWT, e-service 00_9999_00). lookup_ceidg 도구를 활성화합니다. 데이터는 본인의 컴퓨터에 남습니다. POLISHOPENDATA_BDL_CLIENT_ID 선택 사항. 본인의 무료 GUS BDL API 키(BDL 등록에서 발급). 키 없이도 작동하는 find_statistical_unit, search_statistics, get_statistics의 요청 제한을 높입니다. 설명은 자동 번역이며 변수 이름은 원문 그대로입니다. 확실하지 않으면 원문을 확인하세요.
메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
ChatGPT는 아직 Polish Open Data (unofficial)에 연결할 수 없어요
Polish Open Data (unofficial)는 내 컴퓨터에 설치해서 쓰지만 ChatGPT는 웹에서 도는 서버만 연결할 수 있어요
A · Polish Open Data (unofficial)에 연결되는 앱 쓰기
B · 법률 및 정부 데이터에서 ChatGPT에 연결되는 다른 서버
같은 분류에서 많이 쓰는 것 중 키 없이 주소만으로 연결되는 것을 골랐어요
Claude Code에 연결할 수 있지만 먼저 준비가 필요해요
키 필요 없음, 설치 필요 없음
이 메시지를 Claude Code 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.
이 컴퓨터의 Claude Code에 MCP server Polish Open Data (unofficial)을 설치해 주세요. 순서대로: 1) 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): claude mcp add --scope user polishopendata -- dnx PolishOpenData.Mcp --yes 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) 키는 필요 없습니다. 5) 합의한 대로 실행한 뒤 Polish Open Data (unofficial)의 도구가 실제로 보이는지 확인하세요.이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.
Mac: Command+스페이스를 누르고 Terminal 입력 · Windows: PowerShell 열기
claude mcp add --scope user polishopendata -- dnx PolishOpenData.Mcp --yesPolish Open Data (unofficial)이 목록에 있고 연결됨으로 보이면 돼요
Polish Open Data (unofficial)을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Claude Code가 Polish Open Data (unofficial)을 쓰고 있다고 하거나 답에 Polish Open Data (unofficial) 도구 이름이 나오면 연결된 거예요
위 명령은 이 값들 없이도 동작합니다. 바꾸고 싶을 때만 제작자 설명대로 추가하세요.
POLISHOPENDATA_OFFLINE_DIR check_vat_bank_account_offline가 사용하는 준비된 VAT 화이트리스트 플랫 파일 색인을 보관하는 폴더(네트워크 공유가 아닌 로컬 디스크). 기본값: 사용자의 로컬 ap… 아래 PolishOpenData/BialaListaOffline POLISHOPENDATA_REGON_KEY 선택 사항. 본인의 무료 GUS BIR 키(regon_bir@stat.gov.pl). lookup_regon 도구를 활성화합니다. 데이터는 본인의 컴퓨터에 남습니다. POLISHOPENDATA_CEIDG_TOKEN 선택 사항. 본인의 무료 CEIDG API 토큰(biznes.gov.pl의 개인 JWT, e-service 00_9999_00). lookup_ceidg 도구를 활성화합니다. 데이터는 본인의 컴퓨터에 남습니다. POLISHOPENDATA_BDL_CLIENT_ID 선택 사항. 본인의 무료 GUS BDL API 키(BDL 등록에서 발급). 키 없이도 작동하는 find_statistical_unit, search_statistics, get_statistics의 요청 제한을 높입니다. 설명은 자동 번역이며 변수 이름은 원문 그대로입니다. 확실하지 않으면 원문을 확인하세요.
메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
Cursor에 연결할 수 있지만 먼저 준비가 필요해요
키 필요 없음, 설치 필요 없음
이 메시지를 Cursor 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.
이 컴퓨터의 Cursor에 MCP server Polish Open Data (unofficial)을 설치해 주세요. 순서대로: 1) 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): { "mcpServers": { "polishopendata": { "command": "dnx", "args": [ "PolishOpenData.Mcp", "--yes" ] } } } 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) 키는 필요 없습니다. 5) 합의한 대로 실행한 뒤 Polish Open Data (unofficial)의 도구가 실제로 보이는지 확인하세요.이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.
Polish Open Data (unofficial)을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Cursor가 Polish Open Data (unofficial)을 쓰고 있다고 하거나 답에 Polish Open Data (unofficial) 도구 이름이 나오면 연결된 거예요
위 명령은 이 값들 없이도 동작합니다. 바꾸고 싶을 때만 제작자 설명대로 추가하세요.
POLISHOPENDATA_OFFLINE_DIR check_vat_bank_account_offline가 사용하는 준비된 VAT 화이트리스트 플랫 파일 색인을 보관하는 폴더(네트워크 공유가 아닌 로컬 디스크). 기본값: 사용자의 로컬 ap… 아래 PolishOpenData/BialaListaOffline POLISHOPENDATA_REGON_KEY 선택 사항. 본인의 무료 GUS BIR 키(regon_bir@stat.gov.pl). lookup_regon 도구를 활성화합니다. 데이터는 본인의 컴퓨터에 남습니다. POLISHOPENDATA_CEIDG_TOKEN 선택 사항. 본인의 무료 CEIDG API 토큰(biznes.gov.pl의 개인 JWT, e-service 00_9999_00). lookup_ceidg 도구를 활성화합니다. 데이터는 본인의 컴퓨터에 남습니다. POLISHOPENDATA_BDL_CLIENT_ID 선택 사항. 본인의 무료 GUS BDL API 키(BDL 등록에서 발급). 키 없이도 작동하는 find_statistical_unit, search_statistics, get_statistics의 요청 제한을 높입니다. 설명은 자동 번역이며 변수 이름은 원문 그대로입니다. 확실하지 않으면 원문을 확인하세요.
메뉴 이름은 2026년 11월 11일에 Cursor 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
VS Code에 연결할 수 있지만 먼저 준비가 필요해요
키 필요 없음, 설치 필요 없음
이 메시지를 VS Code 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.
이 컴퓨터의 VS Code에 MCP server Polish Open Data (unofficial)을 설치해 주세요. 순서대로: 1) 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): { "servers": { "polishopendata": { "type": "stdio", "command": "dnx", "args": [ "PolishOpenData.Mcp", "--yes" ] } } } 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) 키는 필요 없습니다. 5) 합의한 대로 실행한 뒤 Polish Open Data (unofficial)의 도구가 실제로 보이는지 확인하세요.이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.
Polish Open Data (unofficial)을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ VS Code가 Polish Open Data (unofficial)을 쓰고 있다고 하거나 답에 Polish Open Data (unofficial) 도구 이름이 나오면 연결된 거예요
위 명령은 이 값들 없이도 동작합니다. 바꾸고 싶을 때만 제작자 설명대로 추가하세요.
POLISHOPENDATA_OFFLINE_DIR check_vat_bank_account_offline가 사용하는 준비된 VAT 화이트리스트 플랫 파일 색인을 보관하는 폴더(네트워크 공유가 아닌 로컬 디스크). 기본값: 사용자의 로컬 ap… 아래 PolishOpenData/BialaListaOffline POLISHOPENDATA_REGON_KEY 선택 사항. 본인의 무료 GUS BIR 키(regon_bir@stat.gov.pl). lookup_regon 도구를 활성화합니다. 데이터는 본인의 컴퓨터에 남습니다. POLISHOPENDATA_CEIDG_TOKEN 선택 사항. 본인의 무료 CEIDG API 토큰(biznes.gov.pl의 개인 JWT, e-service 00_9999_00). lookup_ceidg 도구를 활성화합니다. 데이터는 본인의 컴퓨터에 남습니다. POLISHOPENDATA_BDL_CLIENT_ID 선택 사항. 본인의 무료 GUS BDL API 키(BDL 등록에서 발급). 키 없이도 작동하는 find_statistical_unit, search_statistics, get_statistics의 요청 제한을 높입니다. 설명은 자동 번역이며 변수 이름은 원문 그대로입니다. 확실하지 않으면 원문을 확인하세요.
메뉴 이름은 2026년 11월 11일에 VS Code 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
Claude Code
claude mcp add --scope user polishopendata -- dnx PolishOpenData.Mcp --yesClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"polishopendata": {
"command": "dnx",
"args": [
"PolishOpenData.Mcp",
"--yes"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"polishopendata": {
"command": "dnx",
"args": [
"PolishOpenData.Mcp",
"--yes"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"polishopendata": {
"type": "stdio",
"command": "dnx",
"args": [
"PolishOpenData.Mcp",
"--yes"
]
}
}
}POLISHOPENDATA_OFFLINE_DIR envPOLISHOPENDATA_REGON_KEY 비밀 envPOLISHOPENDATA_CEIDG_TOKEN 비밀 envPOLISHOPENDATA_BDL_CLIENT_ID 비밀 env설명은 자동 번역이며 변수 이름은 원문 그대로입니다. 확실하지 않으면 원문을 확인하세요.
이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.
nuget: PolishOpenData.Mcp이 서버의 연결 방식과 각 앱의 공식 문서를 바탕으로 했어요. 2026년 11월 10일 확인.
내 컴퓨터에서 실행하는 앱
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.
누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 19일 점검
레지스트리 이름이 GitHub 계정 JacekSmi 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요
코드 마지막 변경: 4일 전
MIT 사용
내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요
내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요
내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요
제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.
[](https://mcp.popnx.com/en/servers/jaceksmi-polishopendata)질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.
아직 리뷰가 없어요
레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.
해당하는 기본 점검 3개 중 3개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.
레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.
내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).
GitHub 저장소는 마지막으로 4일 전 변경됐고, 최신 버전(1.10.0)은 4일 전 레지스트리에 올라왔어요.
Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 .NET도 있어야 해요.
같은 카테고리에는: Global law, Open Legal Data (Germany), LibreJustice, InfraNode, Fedlex Connector
같은 카테고리, 다른 제작자, 명령 확인 완료. 공식이 먼저, 그다음 스타 순.
카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i
The law of nearly every country on earth, any date: read it, see what changed it, check citations.
German court decisions (Rechtsprechung) and laws (Gesetze) with citation graph and citation checks.
Search French-language and European case law and French legal texts (codes, statutes, treaties).
Keyless open data for 84 German cities: 12 lean read-only MCP tools covering 67 data types.
Search Swiss federal legislation: laws, articles, amendments via the Fedlex SPARQL endpoint.
| 이 항목 Polish Open Data (unofficial) | Global law | Open Legal Data (Germany) | LibreJustice | InfraNode | Fedlex Connector | |
|---|---|---|---|---|---|---|
| 실행 위치 | 컴퓨터에 설치 필요 | 클라우드에서 동작, 설치 불필요 | 클라우드에서 동작, 설치 불필요 | 클라우드에서 동작, 설치 불필요 | 클라우드에서 동작, 설치 불필요 | 클라우드에서 동작, 설치 불필요 |
| 키 필요 | 아니요 | 아니요 | 아니요 | 아니요 | 아니요 | 아니요 |
| Claude에서 +로 추가 | 아니요 | 아니요 | 아니요 | 아니요 | 아니요 | 아니요 |
| 기본 점검 | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 4/4 |
| 라이선스 | MIT | NOASSERTION | MIT | Apache-2.0 | Apache-2.0 | MIT |
| 가격 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 |
제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.
.NET libraries and an MCP server for Polish public registers — company lookup in KRS, the VAT whitelist (Biała Lista) with bank-account checks (online, or offline against the Ministry of Finance flat file), a client for the GUS REGON register (library only), cadastral parcel lookup (ULDK), address geocoding (UUG) and real estate transaction prices (RCN) from GUGiK, and offline validation of NIP, REGON, KRS, NRB and land-registry (KW) numbers.
Unofficial project. Not affiliated with the Ministry of Justice, the Ministry of Finance or any other public body. Results are informational, not legal or tax advice; the registers are the authoritative source.
| Package | What it does | Targets |
|---|---|---|
PolishOpenData.Core | Offline value types: Nip, Regon, KrsNumber, Nrb, KwNumber (+ official court-code table) | net10.0, netstandard2.0 |
PolishOpenData.Krs | KRS Open API: current/full extracts, removed entities, daily change feed, English summary | net10.0, netstandard2.0 |
PolishOpenData.BialaLista | VAT whitelist: status, bank-account check with request ID, batches, daily-limit guard | net10.0, netstandard2.0 |
PolishOpenData.BialaLista.Offline | VAT whitelist checked offline against the Ministry of Finance daily flat file: no request limit, many pairs at once, no request ID | net10.0, netstandard2.0 |
PolishOpenData.Regon | GUS REGON (BIR1.2): search by NIP/REGON/KRS, batches of 20, full reports, session and request limiter; needs your own free GUS key | net10.0, netstandard2.0 |
PolishOpenData.Ceidg | CEIDG v3 (register of sole traders): entries by NIP, REGON or id with status, dates, address and PKD; needs your own free API token | net10.0, netstandard2.0 |
PolishOpenData.Bdl | GUS Bank Danych Lokalnych: find voivodeships, powiats and gminas, search indicators, read values by year (population, unemployment, budgets...); no key needed | net10.0, netstandard2.0 |
PolishOpenData.Eli | Polish legal acts (Sejm ELI API): find acts in Dziennik Ustaw and Monitor Polski, status, consolidated texts and amendments, one article as plain text with provenance; no key needed | net10.0, netstandard2.0 |
PolishOpenData.Sejm | Sejm parliament API: legislative processes and prints with the resulting act (ELI id), votings with the result per club, clubs and committees; individual votes and members only on request; no key needed | net10.0, netstandard2.0 |
PolishOpenData.Geo.Core | Typed Polish coordinates: Pl1992Point (EPSG:2180) and Wgs84Point with a built-in conversion, Pl1992Bbox, ParcelId (TERYT parcel identifier) | net10.0, netstandard2.0 |
PolishOpenData.Uldk | GUGiK ULDK: cadastral parcel by ID, by point or by region name and number, with its boundary as WKT | net10.0, netstandard2.0 |
PolishOpenData.Geo.Nts | Optional NetTopologySuite adapter: ParcelGeometry.ToNtsGeometry() and ToNtsPoint() for area, intersection, buffer and distance on parcels | net10.0, netstandard2.0 |
PolishOpenData.Uug | GUGiK UUG: geocode a Polish address to a WGS-84 point with a match accuracy, or find the nearest address to a point | net10.0, netstandard2.0 |
PolishOpenData.Rcn | GUGiK RCN (Rejestr Cen Nieruchomości): real estate transactions (premises, parcels, buildings) in an area and period, with price per m² statistics | net10.0, netstandard2.0 |
PolishOpenData.Mcp | MCP server for AI assistants: company lookup, VAT whitelist and bank-account check (online and offline), KRS extracts, parcels, address geocoding and property prices, identifier validation | .NET 10 tool |
No network, no DI:
dotnet add package PolishOpenData.Core
using PolishOpenData;
Console.WriteLine(Nip.TryParse("774-000-14-54", out var nip) ? $"Valid NIP {nip}" : "Invalid NIP"); // Valid NIP 7740001454 Console.WriteLine(KwNumber.TryParse("WA1M/00012345/1", out var kw) ? kw.Court?.Name : "Invalid KW number"); // Sąd Rejonowy dla Warszawy-Mokotowa … Console.WriteLine(string.Join(", ", KwNumber.SuggestCorrections("WAIM/00012345/1"))); // WA1M/00012345/1
dotnet add package PolishOpenData.BialaLista
dotnet add package PolishOpenData.Krs dotnet add package Microsoft.Extensions.Http.Resilience
using Microsoft.Extensions.DependencyInjection;
using PolishOpenData; using PolishOpenData.BialaLista; using PolishOpenData.Krs; using System.Threading.Tasks;
var services = new ServiceCollection(); services.AddBialaListaClient(o => o.TrackQuota = true) .AddStandardResilienceHandler(o => o.Retry.ShouldHandle = _ => new ValueTask (false)); services.AddKrsClient().AddStandardResilienceHandler(); using var provider = services.BuildServiceProvider();
var vat = provider.GetRequiredService (); var nip = Nip.Parse("774-000-14-54");
var result = await vat.FindByNipAsync(nip); Console.WriteLine($"{result.Value?.Name}: {result.Value?.VatStatus} (request {result.RequestId})");
var check = await vat.CheckBankAccountAsync(nip, Nrb.Parse("06 1600 1127 1843 9838 2000 0034")); Console.WriteLine(check.Value ? "Account is on the whitelist" : "Account is NOT on the whitelist");
var krs = provider.GetRequiredService (); var extract = await krs.GetCurrentExtractAsync(result.Value!.Krs!.Value); Console.WriteLine(extract.Extract?.ToSummary().ShareCapital);
Retries are off for Biała Lista: every retry the resilience handler would make is another upstream request that the quota guard above cannot count, and once the daily limit is reached Biała Lista blocks the whole IP address — not just this process — until midnight. Register AddBialaListaClient once per process and reuse the resulting client (or pass one shared BialaListaQuotaTracker explicitly); a client created without DI and without a shared tracker gets its own private tracker that does not see requests made by other instances.
A runnable version is in samples/CheckCounterparty.
Keep `RequestId`. Every BialaListaResult carries the request identifier and time returned by Biała Lista (RequestId, RequestDateTime); keep them with your payment records to document when you checked the whitelist and what it answered.
Source-generated JSON. The KRS models use public converters from PolishOpenData.Krs.Serialization (KrsDateJsonConverter, KrsTimestampJsonConverter), so on .NET 8 or later you can add KrsCurrentExtract or KrsFullExtract to your own JsonSerializerContext (for example to cache extracts) without registering any converter. If you parse raw KRS API responses yourself instead of calling IKrsClient, note two things: the extract is wrapped in an odpis object, so deserialize that inner object; and the registry's field names (such as dataRejestracjiWKRS) match the properties only case-insensitively, so use JsonSerializerDefaults.Web — [JsonSourceGenerationOptions(JsonSerializerDefaults.Web)] on your context, or new JsonSerializerOptions(JsonSerializerDefaults.Web) with the reflection-based serializer on .NET Framework. Otherwise the properties stay null without an error.
PolishOpenData.Regon is a client for GUS's BIR1.2 web service: search by NIP, REGON or KRS number, batches of up to 20 identifiers, and the full reports of legal persons, sole traders and local units. It needs a key of your own (free: write to regon_bir@stat.gov.pl); GUS's public test environment works without a key but serves an old, anonymised copy of the register.
dotnet add package PolishOpenData.Regon
using Microsoft.Extensions.DependencyInjection;
using PolishOpenData; using PolishOpenData.Bir; using System.Linq;
var services = new ServiceCollection(); services.AddRegonClient(o => o.UserKey = Environment.GetEnvironmentVariable("MY_APP_REGON_KEY")); // your key, from your own configuration // GUS's public test environment needs no key: services.AddRegonClient(o => o.Environment = RegonEnvironment.Test); using var provider = services.BuildServiceProvider(); var regon = provider.GetRequiredService ();
var found = await regon.FindByNipAsync(Nip.Parse("526-104-08-28")); var entity = found.Value[0]; Console.WriteLine($"{entity.Name}, {entity.Address.City} (REGON {entity.Regon})");
var details = (await regon.GetDetailsAsync(entity, RegonInclude.Pkd)).Value[0]; Console.WriteLine($"{details.LegalFormName}; main PKD {details.Pkd!.First(p => p.IsPrimary).Code}"); Console.WriteLine($"Source: GUS REGON ({found.Environment}), retrieved {found.RetrievedAt:u}");
await regon.LogoutAsync();
The client limits itself to GUS's strictest window by default (3 calls per second, 120 per minute, 6,000 per hour; a batch of up to 20 identifiers is one call for the per-second limit, while the per-minute and per-hour limits count requests and identifiers: each identifier of a search counts one, and so does every other request — login, report, GetDataDateAsync, logout) and keeps one login session. A batch method checks its whole batch before the first request and throws QuotaExceededException without sending anything when it does not fit into what is left of the minute or hour window: under the default window one call carries at most 119 distinct identifiers (120 when the session is already logged in, fewer when other calls used the last minute). Whether GUS also counts every identifier of a batch toward its own per-second limit is not confirmed; if you send many batches, use smaller ones or space them out. Register AddRegonClient once per process and reuse the client: GUS counts requests per application instance, and a session works only from the IP address that created it. Call LogoutAsync when your process stops; the client never does it by itself. A client created without DI gets a private session and limiter.
Retries stay off for REGON, as for Biała Lista: a retry made by a resilience handler is another GUS request that the request limiter cannot count, and a SOAP fault, which means your request was wrong, arrives as HTTP 500 and would be retried. If you add AddStandardResilienceHandler, switch its retries off as in the Biała Lista example above.
Keys and the test environment. The library is bring-your-own-key: it ships no production key, never reads environment variables and never logs or prints your key. GUS's technical manual (section 3.6.3) calls it unacceptable for software to make ever