skanfirmy.pl

skanfirmy.pl — MCP 服务

一款免费的无状态 MCP（Model Context Protocol）服务，让 AI Agent 可以直接从波兰官方政府登记系统中核验波兰公司并验证欧盟 VAT 编号。查询无需密钥或注册；适用每 IP 限流（参见限制与个人数据）。

• 端点： https://skanfirmy.pl/mcp（基于 Streamable HTTP 的 JSON-RPC 2.0）
• 14 个工具：9 个查询和计算工具，整合 VAT 登记系统（财政部）、KRS（司法部）、REGON（波兰统计局 / GUS）和 VIES（欧盟委员会）；另有 5 个可选的变更监控工具，需要 API 密钥。
• 也可作为纯 REST 接口使用，供无法使用 MCP 的爬虫 / Agent 调用。

由 Bartosz Kuć 开发——他也是 skanfirmy.pl 和波兰及欧盟公共 API 目录 otwarteAPI.pl 的创建者。

工具

工具	功能
sprawdz_nip	根据 NIP 查询公司的 VAT 状态（白名单）和 KRS 数据
sprawdz_lista_nip	单次调用批量查询最多 30 个 NIP（财政部 VAT 登记系统）
sprawdz_regon	根据 NIP 查询 REGON 登记数据（GUS）；对于个体经营者及其他自然人，仅返回姓名、法律形式、实体类型、城镇和经营状态
sprawdz_vies	通过 VIES（欧盟委员会）验证欧盟 VAT 编号
sprawdz_rachunek	查询某个银行账户是否已针对指定 NIP 列入 VAT 白名单
generuj_mikrorachunek	根据 NIP 生成个人税务微账户（PIT/CIT/VAT）；PESEL 的计算公式在工具说明中，可在本地计算
szukaj_pkd	搜索 PKD 2025 经营活动分类
oblicz_odsetki	法定 / 商业（B2B）逾期付款利息计算器
szukaj_katalog_api	搜索 otwarteAPI.pl——其他波兰 / 欧盟公共 API 目录

监控工具（需要 skanfirmy API 密钥，确认在 skanfirmy.pl/monitoring 注册后即可获取）： observe_nip、unobserve_nip、list_observations、changes_since、set_webhook。

限制与个人数据

• 按 IP 地址限流。 MCP：每 10 秒最多 60 个请求，超出后返回 HTTP 429 和 JSON-RPC 错误（error.data.contact），持续 10 秒。REST 端点：每 10 秒最多 20 个请求，超出后返回 HTTP 429，持续 10 秒。本服务面向用户或其 Agent 发起的单次查询，不用于批量采集数据。
• 数据源限制。 财政部白名单 API 有自己的每日限额（搜索：每天 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"}}}'

普通 REST（无 MCP）

适用于只需要 URL 的 Agent／爬虫：

• 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} — 欧盟 VAT（VIES）
• POST https://skanfirmy.pl/rachunek — 查询一个银行账户是否在某个 NIP 的白名单中

添加 ?format=json 可获取 JSON。完整文档：skanfirmy.pl/llms.txt， OpenAPI：skanfirmy.pl/openapi.yaml。

Claude Agent Skill

更倾向于直接使用 Agent Skill？ skill/ 中包含 verify-polish-company — 一个 SKILL.md 文件， 用于指导 Claude Code、Claude 应用或 Agent SDK 何时以及如何调用上述端点（无需密钥，除常规 HTTP 外无需运行任何内容）：

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

详情请参阅 skill/README.md。

数据来源

VAT Register / Biała Lista（财政部）、KRS（司法部）、 REGON / BIR（波兰统计局 — 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。