ItalyCheck

Name: ItalyCheck
Author: yeick010

远程服务

github.com/yeick010法律与政务04 天前更新

代码仓库

关于 ItalyCheck

ItalyCheck 是面向 AI Agent 的 x402 付费 API，使用公共来源查询意大利公共机构和增值税数据。目前部署的 MCP 接口提供付费公共机构查询；增值税查询因等待法律意见而停用。

主要功能

01按税号付费查询公共机构
02在 Base 上使用 USDC 或 EURC 支付
03离线校验增值税号校验和
04公共来源数据及署名要求

适用场景

01查询意大利公共机构名称和联系信息
02无需联网查询即可校验增值税号格式

MCP 相关

远程 Streamable HTTP MCP 接口提供 `lookup_italian_pa`，并通过 MCP 接受 x402 付款。MCP 命令还可使用本地查询模式。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://italycheck.italycheck.workers.dev/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http yeick010-italycheck https://italycheck.italycheck.workers.dev/mcp

Cursor.cursor/mcp.json{"mcpServers":{"yeick010-italycheck":{"type":"http","url":"https://italycheck.italycheck.workers.dev/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"yeick010-italycheck":{"type":"http","url":"https://italycheck.italycheck.workers.dev/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"yeick010-italycheck":{"type":"http","url":"https://italycheck.italycheck.workers.dev/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"yeick010-italycheck":{"serverUrl":"https://italycheck.italycheck.workers.dev/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

ItalyCheck（MVP）

AI Agent 按次付费验证供应商。仅使用免费的公开来源。通过 x402 付款（Base 上的 USDC 或 EURC）。

端点

路径	价格	来源
`GET /v1/vat?vat=IT00743110157`	$0.01	EU VIES REST（实时透传，不保存数据）
`GET /v1/pa?cf=80016350821`	$0.005 USDC 或 €0.005 EURC	IndicePA，“Enti”数据集（AgID，CC BY 4.0，必须注明来源）
`GET /v1/vat/format?vat=...`	免费	离线 P.IVA 校验和
`GET /`	免费	面向 Agent 的描述目录

用法

npm install
npm test              # 对 VIES + IndicePA 进行实时测试，测试 402 x402、MCP
npm run dev           # 不启用付款，端口 8787
npm start             # 启用 x402（Base Sepolia 测试网，x402.org facilitator）
ITALYCHECK_URL=https://... npm run mcp   # MCP stdio 服务（代理）。ITALYCHECK_LOCAL=1 = 本地查询

上线生产环境（尚未完成）

将 PAY_TO 设为 Yeison 的 Base 钱包地址。
设置 X402_NETWORK=eip155:8453；使用 CDP facilitator（npm i @coinbase/x402，密钥 CDP_API_KEY_ID/SECRET；每月免费 1,000 笔交易，之后每笔 $0.001）。
在 Cloudflare Workers Free 上运行 npx wrangler deploy（允许商业用途，每天 100k 次请求，10 ms CPU）。
通过 CDP facilitator 完成首笔结算付款后，Bazaar 就会发现它。将 MCP 发布到 MCPize/Smithery。

法律限制

VIES 免责声明规定，只能将其用于验证欧盟内部交易的增值税号。禁止任何不合规的数据提取，滥用行为将按 IP 屏蔽（例如，同一增值税号每天查询多次）。因此不得共享缓存、不得建立存档，也不得大规模抓取。

部署状态（16/10/2026）

已上线：https://italycheck.italycheck.workers.dev（Cloudflare Workers Free、Base Sepolia 测试网、x402.org facilitator）
仅 /v1/pa 需要付费。/v1/vat（VIES）已停用：ENABLE_VAT="0"，等待法律意见。
部署：CLOUDFLARE_ACCOUNT_ID=... npx -y -p node@22 node ./node_modules/wrangler/bin/wrangler.js deploy（wrangler 4 需要 Node 22）。
Worker 会为每个请求创建一个新应用，并仅将 facilitator 返回的“supported”响应作为数据缓存。在 Workers 上，在多个请求间共享进行中的 promise 会导致请求阻塞。

主网（16/10/2026，晚间）

Base 主网，网络为 eip155:8453，USDC 合约为 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913，使用 CDP facilitator。密钥 CDP_API_KEY_ID 和 CDP_API_KEY_SECRET 已存储在 Cloudflare 中（wrangler secret）。
Bazaar：带有 schema 和示例的发现扩展。已通过 CDP /x402/validate 验证：valid true。
远程 MCP：POST /mcp（Streamable HTTP，无状态）。lookup_italian_pa 通过 MCP 使用 x402 付费。
CPU：src/bazaar-shim.js（wrangler 别名）跳过每个请求的 ajv 重新验证。CDP JWT 和“supported”响应作为数据缓存。
发现详情见 SUBMISSIONS.md。

EURC（24/10/2026）

/v1/pa 和 MCP 工具 lookup_italian_pa 除 USDC 外，也接受 Base 上的 EURC。USDC 仍是 accepts 中的首选项（默认项）；EURC 为第二项，名义金额相同（0.005 EURC = 5000 个单位，6 位小数），payTo 相同。
EURC Base 主网合约地址：0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42（Circle：https://developers.circle.com/stablecoins/eurc-contract-addresses）。Base Sepolia 合约地址：0x808456652fdb597867f38412077A9182bf77359F。从链上读取的 EIP-712 域：名称为 EURC，版本为 2。
CDP facilitator 在其 EVM 网络上接受所有支持 EIP-3009 的 ERC-20 代币（USDC、EURC）：https://docs.cdp.coinbase.com/x402/support/faq
购买者须知：@x402 2.28 客户端在使用默认 spendControls 时只接受默认资产（USDC）。若要使用 EURC 付款，需在 spendControls.allowedAssets 中添加 EURC，或设置 allowedAssets: true。
如需禁用 EURC：设置变量 DISABLE_EURC="1"。