EU e-invoicing and business checks (EN 16931, Peppol, VAT, sanctions)

EU Business Data MCP – VAT、EORI、公司注册信息、制裁筛查、KYB 与电子发票

面向 AI Agent 和 KYB／入驻／开票工作流的远程 MCP 服务和 x402 按次付费 API，用于查询欧洲商业数据。

**开发者声明：**由 W System 构建并运营。这是我们自己的商业产品。代码采用 MIT 许可证。

远程 MCP 端点（可流式传输的 HTTP）

https://api.wsystem.dev/mcp/

免费层，无需注册：每个 MCP 会话每天可调用 20 次工具。直接客户端（Claude Code、Cursor、mcp-remote 等从你自己的机器连接的客户端）也按每个 IP 最多 20 次计算，因此开启更多会话不会增加调用次数。Claude.ai／Claude Desktop 自定义连接器从 Anthropic 云端发起调用（出站 IP 段 160.79.104.0/21），因此这些调用按会话而非 IP 计数；该 IP 段内所有无需密钥的流量每天共享 2,000 次查询（verify_batch／verify_eori_batch 每个号码计 1 次）。新的无密钥会话：每个 IP 每天 1,500 次（每个 Anthropic 地址 3,000 次）。限制在 UTC 时间 00:00 重置；实时数值：https://api.wsystem.dev/mcp/limits

大流量使用时可选用 API 密钥：在每个 MCP 请求中发送 X-API-Key: <key>（或 Authorization: Bearer <key>）。使用密钥的调用消耗该密钥的月度单位（权重与 REST API 相同），而非免费层额度。密钥：https://wsystem.dev/pricing（Starter：每月 EUR 19，5,000 单位；Pro：每月 EUR 49，25,000 单位；没有免费密钥）。不接受 URL 中的密钥。如何在 Claude 中添加密钥：docs/mcp-claude-cursor.md。

服务卡片：https://api.wsystem.dev/server-card · 网站：https://wsystem.dev · LLM 摘要：https://wsystem.dev/llms.txt

客户端配置示例：

{ "mcpServers": { "eu-business-data": { "type": "http", "url": "https://api.wsystem.dev/mcp/" } } }

工具（14 个）

工具	功能
verify_vat	通过 VIES 实时验证欧盟 VAT 号码（27 个欧盟成员国 + XI），并返回名称／地址以及可选的查询编号
verify_batch	一次验证多个 VAT 号码
lookup_company	在欧洲商业注册机构中查询公司
screen_sanctions	将姓名与欧盟／联合国／英国／美国制裁名单进行模糊匹配
kyb_check	综合 KYB：VAT 有效性 + 注册信息 + 制裁筛查
verify_eori	验证欧盟 EORI 号码（海关）
verify_eori_batch	一次验证多个 EORI 号码
validate_einvoice	根据官方 EN 16931 和 XRechnung 规则验证 UBL 或 CII 电子发票：返回含规则 ID、通俗易懂的说明和修复提示的错误
parse_einvoice	将收到的电子发票（UBL Invoice/CreditNote、CII，或以 base64 格式提供的 ZUGFeRD／Factur-X PDF 中的 XML）解析为统一的 JSON 结构：卖方、买方、日期、引用、总额、VAT 明细、付款／IBAN、行项目、附件。保留原始值，不进行验证（请使用 validate_einvoice）。指南：将 XRechnung / ZUGFeRD 读取为 JSON
create_einvoice	将简单的 JSON 转换为通过验证的 UBL 2.1 发票（符合 EN 16931、XRechnung 或 Peppol BIS 3 结构）
einvoice_route	“我能向这家公司开具电子发票吗？”：查询 VIES、Peppol Directory、各国 B2B 强制要求和推荐格式
send_einvoice_sandbox	沙盒：验证买方 VAT + 制裁筛查 → 创建／验证 EN 16931 → 路由 → 模拟传输（不会实际发送）→ 返回 Ed25519 签名的凭证
due_diligence_report	在一份报告中汇总 VAT、注册信息、制裁、EORI、GLEIF LEI 和 Peppol，并附带风险标记和时间戳
check_fr_pa_registry	法国：该电子发票平台是否在 DGFiP 官方认证平台（Plateformes Agréées，PA）名单中？输入名称或网站，返回已获批／等待互操作性测试／未找到、注册日期和官方来源（REST 也可免费使用：GET https://api.wsystem.dev/fr/pa-registry?name=Pennylane）

快速解答

• 如何通过代码或 AI Agent 验证欧盟 VAT 号码？ GET https://api.wsystem.dev/verify?vat=IE6388047V，或使用 MCP 工具 verify_vat。数据来自官方 VIES，提供供审计使用的查询编号，并在 VIES 故障时重试。
• EORI 查询 API？ GET https://api.wsystem.dev/eori?eori=SE5560360793（来自欧盟委员会官方 EOS，使用 JSON 而非 SOAP）。
• 制裁筛查 API？ GET https://api.wsystem.dev/sanctions/screen?name=...（欧盟、联合国、OFAC SDN、英国；每日刷新）。
• 公司注册信息 API？ GET https://api.wsystem.dev/company?q=552032534&country=FR（FR、NO、FI、CZ、PL、EE + GLEIF LEI）。
• 电子发票验证 API（EN 16931、XRechnung、ZUGFeRD/Factur-X）？ 将 XML 或 PDF 作为请求正文发送至 POST https://api.wsystem.dev/einvoice/validate。创建：POST /einvoice/create（示例请求正文：GET /einvoice/sample）。路由：GET /einvoice/route?id=BE0403170701。沙盒发送（验证 → 创建 → 路由 → 模拟传输 → 签名证据）：POST /einvoice/send（公钥：GET /einvoice/evidence-key）。目前尚未检查 Peppol BIS 3 特定规则；暂不支持实时 Peppol 传输。规则资源文件：CEN EN 16931（EUPL-1.2，https://github.com/ConnectingEurope/eInvoicing-EN16931）和 KoSIT XRechnung 配置（Apache-2.0，https://github.com/itplr-kosit/validator-configuration-xrechnung），在运行时下载，且未经修改。页面：https://wsystem.dev/eu-e-invoice-validation-api · https://wsystem.dev/e-invoicing-api
• 交易对手尽职调查报告？ POST https://api.wsystem.dev/ddreport {"company":"FR40303265045"}。
• 欧盟招标（TED）？ Apify Actor wsystem/eu-tenders-search。
• 定价： REST 每个 IP 每天免费调用 20 次；MCP 每个会话每天可免费调用工具 20 次；x402 单次检查 $0.01，批量检查 $0.10，KYB $0.045，电子发票验证 $0.03，电子发票解析 $0.01，电子发票创建 / 沙盒发送 $0.08，电子发票路由 $0.02，尽职调查报告 $0.49；Apify 按事件付费。
• 产品页面：VAT API · VIES 故障 · EORI · 制裁筛查 · 公司注册信息 · TED 招标 · KYB · 电子发票 · 欧盟 VAT 验证指南
• 免费工具：批量 VAT 检查器（CSV） · VIES 状态 · EORI 查询 · Peppol ID 查询
• CI：einvoice-validate-action 可在 GitHub Actions 中验证 UBL/CII/ZUGFeRD 发票，并提供行内规则注释（免费套餐；开始使用无需密钥）
• OpenAPI：https://api.wsystem.dev/openapi.json · x402 清单：https://api.wsystem.dev/.well-known/x402

VIES 宕机时（回退）及英国号码

• VIES 会采用退避策略重试。如果成员国仍然返回 MS_UNAVAILABLE 或超时，则使用该国的免费官方来源返回结果：PL Biała lista（财政部）、CZ ARES（VAT 注册状态）、FI YTJ 开放数据（VAT 注册）、FR Recherche d'entreprises / SIRENE（公司存续状态 + VAT 识别码；法国没有免费的 VAT 注册查询 API）。
• 否则，返回该号码最近一次成功的 VIES 答复，并标注日期。再否则，返回 member_state_unavailable。
• 回退结果包含 fallback: true、fallback_type（national_source | last_vies_result）、source、legal_status、vies_error，且不含咨询编号。国家登记簿显示的是国内状态，不能作为 VIES 审计证明。设置 fallback=false 可关闭此功能。
• DE（BZSt eVatR 要求德国申请方提供 VAT ID）、ES（证书）、IT（验证码）、NL、BE、HU（NAV 技术用户）和 DK 均没有免费的自动化数据源。
• GET /vies/status：EC VIES 各国可用性，每 5 分钟缓存一次，免费。
• GB：接受并验证 HMRC 校验位。已实现通过 HMRC Check a UK VAT number API v2 进行实时查询（vatcheck/hmrc.py），但需要在 HMRC Developer Hub 获取 OAuth 应用凭据（HMRC_CLIENT_ID、HMRC_CLIENT_SECRET，以及可选的 HMRC_REQUESTER_VRN）；未提供凭据时，GB 结果会返回 status: not_configured。XI 通过 VIES 查询。

集成指南

分步指南（所有代码片段均已通过实时 API 测试）：docs/

• MCP：Claude Desktop、Cursor、Claude Code
• 通过 Python 和 JavaScript 使用 REST
• n8n · Make · 通过 Apify 使用 Zapier
• **Make 应用（原生自定义应用）：**在 Make 中安装 W System，其中包含 Check VAT Number、Check VAT Numbers (Batch)、Check EORI Number 和 Search Companies 模块。API 密钥可选（免费套餐每天 20 次调用）。
• Zapier 应用（测试版，原生）：将 W System 添加到 Zapier，用于 VAT 查询和制裁筛查操作。
• x402 Agent（Base 上的 USDC）
• 使用官方 EOS API 验证欧盟 EORI 号码
• 在 Python 中直接通过 VIES 验证欧盟 VAT 号码：单个零依赖文件，支持针对 MS_UNAVAILABLE 的重试、CSV 批量处理和咨询编号（无需 W System 账户）

提供免费 VAT 和 EORI 查询工具的网站：https://wsystem.dev REST API 文档和免费 API 密钥（无需银行卡）：https://api.wsystem.dev/docs?ref=mcp-github

定价

• **MCP 端点：**免费，每个 MCP 会话每天可调用工具 20 次（详情及 Claude 连接器流量的共享限额见上文）。使用 X-API-Key 中的 API 密钥：Starter 每月 EUR 19（5,000 个单位），或 Pro 每月 EUR 49（25,000 个单位）。达到免费限额时，工具会返回错误，指出限额并说明如何添加密钥。
• 同一主机上的 x402 REST API（https://api.wsystem.dev，例如 GET /verify?vat=...、POST /verify/batch、GET /company?q=...、制裁筛查、KYB 和 EORI 路由）：超出免费额度后，每次请求均需通过 x402 使用 Base 上的 USDC 付费：单次查询约 $0.01，批量查询 $0.10，KYB 查询 $0.045。未付款的调用会收到包含付款要求的 HTTP 402 响应。
• Apify Actors（按事件付费），见下文。

Apify 上也有

同样的查询也可作为 Apify Actors 提供（按事件付费），并可通过 Apify 托管的 MCP 服务使用：

• wsystem/eu-vat-checker
• wsystem/european-company-registry
• wsystem/eu-tenders-search
• wsystem/sanctions-screening
• wsystem/kyb-company-check
• wsystem/eu-eori-checker
• Apify MCP：https://mcp.apify.com?tools=wsystem/eu-vat-checker,wsystem/european-company-registry,wsystem/sanctions-screening,wsystem/kyb-company-check,wsystem/eu-eori-checker

博客：https://wsystem.hashnode.dev

即用示例（在 Apify 上一键运行）

每个示例都会打开一个已填入内容的运行页面，并展示真实样例输出，让你在付费前就能了解结果格式：

• 在 VIES 中查询德国增值税号（USt-IdNr.）
• 查询法国增值税号（TVA intracommunautaire）
• 在 VIES 中查询意大利增值税号（Partita IVA）
• 在 VIES 中查询西班牙增值税号（NIF-IVA）
• 在 VIES 中查询波兰增值税号（NIP）
• 批量验证多个国家的欧盟增值税号
• 批量验证欧盟 EORI 号
• 按 SIREN 或名称查询法国公司
• 搜索北欧公司注册信息（挪威、芬兰）
• 查询捷克和波兰公司（ARES、KRS）
• 查询欧洲的 IT 和软件招标项目（TED）
• 查询德国的建筑招标项目（TED）
• 查询欧盟的医疗设备招标项目（TED）
• 根据 OFAC SDN 名单筛查姓名
• 根据欧盟综合制裁名单筛查姓名
• 根据英国制裁名单筛查姓名
• 供应商入驻检查：增值税、注册信息和制裁筛查
• 通过增值税号验证 B2B 客户

自行运行

pip install -r requirements.txt
uvicorn vatcheck.server:app --port 8000     # REST at /, MCP at /mcp/
# or stdio MCP:
python -m vatcheck.mcp_server stdio

除非设置 X402_ENABLED=1 和 X402_PAY_TO，否则 x402 默认关闭（参见 vatcheck/x402.py）。

数据来源与免责声明

数据实时来自公开来源，例如欧盟委员会的 VIES 和 EORI 服务、公开企业注册机构以及官方制裁名单。本项目与欧盟委员会或任何主管机构均无关联。结果不构成法律或税务建议。

许可证

MIT。参见 LICENSE。