EU Business Data (VAT, EORI, company, sanctions, KYB)

欧盟企业数据 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 云端发起调用（出站地址范围 160.79.104.0/21），因此这些调用按会话而非 IP 地址计数；该地址范围内所有无需密钥的流量共享每天 2,000 次查询（verify_batch / verify_eori_batch 按号码逐个计数）。新建的无密钥会话：每个 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/" } } }

工具

工具	功能
verify_vat	通过 VIES 实时验证欧盟 VAT 号码（27 个欧盟成员国 + XI），提供名称/地址以及可选的查询编号
verify_batch	一次验证多个 VAT 号码
lookup_company	在欧洲企业注册机构中查询企业
screen_sanctions	将姓名与欧盟 / UN / UK / US 制裁名单进行模糊匹配
kyb_check	综合 KYB 检查：VAT 有效性 + 注册信息 + 制裁筛查
verify_eori	验证欧盟 EORI 号码（海关）
verify_eori_batch	一次验证多个 EORI 号码
validate_einvoice	根据官方 EN 16931 和 XRechnung 规则验证 UBL 或 CII 电子发票：提供错误及其规则 ID、通俗易懂的说明和修复提示
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.08、电子发票路由 $0.02、尽职调查报告 $0.49；Apify 按事件付费。
• 产品页面：VAT API · VIES 宕机 · EORI · 制裁名单 · 公司注册信息 · TED 招标 · KYB · 电子发票 · 欧盟 VAT 验证指南
• 免费工具：批量 VAT 检查器（CSV） · VIES 状态 · EORI 查询
• 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

定价

• MCP 端点： 免费，每个 MCP 会话每天可调用工具 20 次（详情及 Claude 连接器流量的共享限额见上文）。使用 X-API-Key 中的 API 密钥：Starter 每月 EUR 19（5,000 个单位），或 Pro 每月 EUR 49（25,000 个单位）。达到免费限额时，工具会返回错误，指出限额并说明如何添加密钥。
• 同一主机上的 REST API（使用 x402）（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。