skanfirmy.pl

skanfirmy.pl — MCP サーバー

AI エージェントが政府の公式登録簿からポーランド企業を確認し、EU VAT 番号を直接検証できる、無料のステートレスなMCP（Model Context Protocol）サーバーです。照会にキーや登録は不要です。IP ごとのレート制限が適用されます（制限と個人データを参照）。

• エンドポイント： https://skanfirmy.pl/mcp（Streamable HTTP 上の JSON-RPC 2.0）
• 14 個のツール： VAT 登録簿（財務省）、KRS（法務省）、REGON（ポーランド統計局／GUS）、VIES（欧州委員会）を組み合わせた照会・計算ツールが 9 個、任意の変更監視用ツールが 5 個あります。変更監視には API キーが必要です。
• MCP を利用できないクローラー／エージェント向けに、通常の REST としても利用できます。

skanfirmy.pl と、ポーランドおよび EU の公開 API カタログ otwarteAPI.pl を運営する Bartosz Kuć が開発しています。

ツール

ツール	機能
sprawdz_nip	NIP で企業を照会し、VAT ステータス（ホワイトリスト）と KRS データを取得します
sprawdz_lista_nip	1 回の呼び出しで最大 30 件の NIP を一括照会します（財務省 VAT 登録簿）
sprawdz_regon	NIP で REGON 登録データ（GUS）を取得します。個人事業主およびその他の自然人については、名称、法的形態、事業体の種類、町、事業状況のみを取得します
sprawdz_vies	VIES（欧州委員会）で EU VAT 番号を検証します
sprawdz_rachunek	指定した NIP の銀行口座が VAT ホワイトリストに掲載されているか確認します
generuj_mikrorachunek	NIP から個人税務マイクロ口座（PIT／CIT／VAT）を生成します。PESEL 用の計算式はツールの説明に記載されており、ローカルで計算できます
szukaj_pkd	PKD 2025 事業活動分類を検索します
oblicz_odsetki	法定／商取引（B2B）遅延利息を計算します
szukaj_katalog_api	otwarteAPI.pl を検索します — その他のポーランド／EU 公開 API のカタログです

監視ツール（skanfirmy API キーが必要です。登録後、skanfirmy.pl/monitoring で確認すると取得できます）： observe_nip、unobserve_nip、list_observations、changes_since、set_webhook。

制限と個人データ

• IP アドレスごとのレート制限。 MCP：10 秒あたり最大 60 リクエスト。それを超えると、JSON-RPC エラー（error.data.contact）を伴う HTTP 429 が 10 秒間返されます。REST エンドポイント：10 秒あたり最大 20 リクエスト。それを超えると、HTTP 429 が 10 秒間返されます。このサービスは、ユーザーまたはそのエージェントが開始する個別の照会を想定しており、大量のデータ収集を目的としていません。
• 情報源側の制限。 財務省のホワイトリスト API には独自の日次上限があります（検索：1 日 100 回、各回最大 30 件の NIP）。サービスの全ユーザーで共有されます。上限に達すると、翌日まで照会に HTTP 503 が返されます。
• 個人事業主およびその他の自然人（KRS 番号のない事業体および民事会社）については、データを最小限にしています（GDPR）：名称、NIP、VAT ステータス、町、ホワイトリスト上の口座数。REGON 番号、住所、登録日、PKD コード、口座番号の一覧は含まれません。特定の口座を確認するには、sprawdz_rachunek を使用してください（REST：POST /rachunek）。
• 表示制限対象の番号。 データ保護手続きにより、一部の番号のデータは表示されません。その場合、回答は restricted: true となり、所定の文と財務省の検索ページへのリンクのみが含まれます。データや、有効性、VAT ステータス、登録簿への掲載に関するフィールドは含まれません。ユーザーには公式検索ページを案内してください。

接続

リモート（Streamable HTTP）サーバーに対応した MCP クライアント全般 — 次のエンドポイントを指定してください。

https://skanfirmy.pl/mcp

Claude Desktop／stdio のみ対応するクライアント — mcp-remote でブリッジします。

{
  "mcpServers": {
    "skanfirmy": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://skanfirmy.pl/mcp"]
    }
  }
}

生の JSON-RPC（MCP クライアントは不要）：

# list tools
curl -s https://skanfirmy.pl/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# check a company by NIP
curl -s https://skanfirmy.pl/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"sprawdz_nip","arguments":{"nip":"5261040828"}}}'

Plain REST（MCP なし）

URL だけを必要とするエージェント／クローラー向けです。

• GET https://skanfirmy.pl/nip/{nip} — VAT ＋ KRS
• GET https://skanfirmy.pl/nips/{comma,separated,nips} — 一括（≤30）
• GET https://skanfirmy.pl/regon/{nip} — REGON 登録データ
• GET https://skanfirmy.pl/vies/{country}/{number} — EU VAT（VIES）
• POST https://skanfirmy.pl/rachunek — NIP に対して銀行口座が 1 つホワイトリストに登録されているかを確認します

JSON を取得するには ?format=json を追加してください。完全なドキュメント：skanfirmy.pl/llms.txt、 OpenAPI：skanfirmy.pl/openapi.yaml。

Claude エージェントスキル

手軽に導入できる Agent Skill をお探しですか？ skill/ には verify-polish-company が含まれています。これは、Claude Code、Claude アプリ、または Agent SDK に、上記のエンドポイントをいつ、どのように呼び出すかを教える単一の SKILL.md です（キーは不要で、通常の HTTP 以外に実行するものもありません）。

cp -R skill ~/.claude/skills/verify-polish-company

詳細は skill/README.md をご覧ください。

データソース

VAT Register／Biała Lista（財務省）、KRS（法務省）、REGON／BIR（Statistics Poland — GUS）、VIES（欧州委員会）。これらのいずれとも関係のない独立プロジェクトです。サービスが保存するデータとその保存期間については、プライバシーポリシーをご覧ください。

作成者

Bartosz Kuć · skanfirmy.pl · github.com/bartosz-kuc · linkedin.com/in/bartosz-kuc · cal.com/bartosz-kuc

ライセンス

MIT © Bartosz Kuć。このリポジトリには、ホスト型サーバーのドキュメントとその MCP レジストリマニフェストが含まれています。サーバー自体は https://skanfirmy.pl/mcp で稼働しています。