Precleared Contact Check

Precleared：AI Agent 冷邮件合法性检查

你的 Agent 可以发送这封邮件吗？ Precleared 会在邮件发出前给出答复：针对每个地址，判断冷营销邮件是否合法、引用相关法规、说明页脚必须包含哪些内容，并生成任何人都能验证的签名回执。支持英国（PECR 和 UK GDPR）、美国（CAN-SPAM）、加拿大（CASL）、德国（UWG）、法国（CPCE）、澳大利亚（Spam Act）、爱尔兰（S.I. 336/2011）和荷兰（Telecommunicatiewet）。

它位于查找地址的步骤（Hunter、Apollo、Clay）和发送邮件的步骤（Gmail、Outlook、Instantly、lemlist）之间。每有一个新联系人，就在发送第一封邮件前调用一次。发票、收据或其他事务性邮件不需要使用它。

• 网站和文档：https://precleared.dev/docs
• MCP 服务（可流式传输的 HTTP）：https://precleared.dev/mcp
• REST：POST https://precleared.dev/api/v1/check
• OpenAPI：https://precleared.dev/openapi.json
• 规则及来源：https://precleared.dev/rules

插件和 Agent 技能

此仓库也是 Claude 插件和 Agent Skills 技能。该插件会将你的 Agent 连接到托管的 MCP 服务，并添加 cold-email-check 技能，告诉 Agent 何时运行检查（向新地址发送第一封冷邮件前，而不是用于发票或回复）、如何填写事实信息而不臆测、如何处理每种判定结果，以及在哪里保存回执。

Claude Code：

claude plugin marketplace add gabrielaoimevbore-beep/precleared-mcp
claude plugin install precleared@precleared

如果之前单独添加过 Precleared MCP 服务，请将其移除，以免工具重复显示。

**Claude.ai、桌面应用和 Cowork：**依次选择 Customize、Plugins、Add、Add marketplace，输入 gabrielaoimevbore-beep/precleared-mcp，然后添加 Precleared，并从插件的 Connectors 标签页连接其连接器。

Cursor、Codex、OpenCode 和其他可读取技能的 Agent：

npx skills add gabrielaoimevbore-beep/precleared-mcp

连接 Precleared MCP 工具后，该技能会使用这些工具。否则，它会运行 skills/cold-email-check/scripts/check.mjs（Node 18 或更高版本，无依赖项），通过 REST API 检查单个地址或整个列表：

node skills/cold-email-check/scripts/check.mjs --email [email protected] --sender GB --source SOURCE --pitch "bookkeeping software"
node skills/cold-email-check/scripts/check.mjs --file leads.csv --sender GB --source SOURCE --out leads-checked.csv

SOURCE 表示地址的来源：published、bought、scraped、given 或 unknown。它会影响判定结果，因此请如实填写。脚本会将每个地址及其对应的事实信息发送到 precleared.dev；如果你设置了 PRECLEARED_API_KEY，也会一并发送。除此之外，任何内容都不会离开你的设备，也不会向收件人发送任何内容。

将其添加到客户端

Cursor：添加到 Cursor

VS Code：添加到 VS Code

Claude Code：

claude mcp add --transport http precleared https://precleared.dev/mcp

**Claude.ai 和 Claude 桌面应用：**依次点击 Settings、Connectors、Add custom connector，然后粘贴 https://precleared.dev/mcp。

**Claude 目录：**https://claude.ai/directory/precleared（一键添加，无需设置）。

**Smithery：**通过 https://smithery.ai/servers/gabrielaoimevbore/precleared 连接。密钥是可选的连接设置。

官方 MCP 注册表：dev.precleared/contact-check

**通过 stdio 运行本地服务（此仓库）：**适用于只能运行本地服务的客户端。

{
  "mcpServers": {
    "precleared": {
      "command": "npx",
      "args": ["-y", "github:gabrielaoimevbore-beep/precleared-mcp"],
      "env": { "PRECLEARED_API_KEY": "pc_live_..." }
    }
  }
}

也可以使用 Docker：docker build -t precleared-mcp . && docker run -i --rm -e PRECLEARED_API_KEY=pc_live_... precleared-mcp。无论哪种方式，密钥都是可选的。任何客户端也可以使用 npx mcp-remote https://precleared.dev/mcp --transport http-only 桥接托管端点。

任何 MCP 客户端（JSON）：

{
  "mcpServers": {
    "precleared": {
      "url": "https://precleared.dev/mcp",
      "headers": { "Authorization": "Bearer pc_live_..." }
    }
  }
}

Authorization 标头是可选的，也可以使用 X-API-Key: pc_live_...。不使用密钥时，通过托管 MCP 端点每天可免费检查 100 次（通过 REST 可检查 10 次），同一 IP 地址上的所有用户共享额度。在 https://precleared.dev/get-key 获取免费密钥后，你每天可通过 MCP 检查 100 次（通过 REST 可检查 25 次）；39 英镑的套餐另含 2,000 次检查，永不过期。

此仓库包含的内容

index.js 是一个小型 MCP 服务（需要 Node 18 或更高版本，只有一个依赖项），提供与托管端点相同的两个工具，并通过公共 REST API 执行检查。本地不会存储任何内容，也不会向收件人发送任何内容。https://precleared.dev/mcp 上的托管端点是规范服务：不使用密钥时每天允许检查 100 次，而此本地服务背后的 REST API 每个网络每天允许检查 10 次，因此如果你要在本地大量运行，请添加免费密钥。

npm install
npm test        # runs the server and the skill script against a fake API on localhost, no network needed
PRECLEARED_API_KEY=pc_live_... node index.js

环境变量：PRECLEARED_API_KEY（可选）、PRECLEARED_API_BASE（默认值为 https://precleared.dev/api/v1）、PRECLEARED_TIMEOUT_MS（默认值为 30000）。

插件位于其旁边：.claude-plugin/ 存放插件和市场清单，.mcp.json 指向托管服务，skills/cold-email-check/ 存放技能及其脚本。运行 node test/skill.mjs 可使用模拟 API 测试脚本。

工具

工具	功能
contact_check	接收收件人的电子邮件地址或域名、发件人所在国家（GB 或 US）、推介内容以及地址来源。返回 verdict（ok_to_email、consent_needed、blocked 或 unknown）、confidence、附带来源的引用规则、footer_text（电子邮件页脚必须包含的内容，而非可直接粘贴的措辞）、next_step、所用事实以及签名收据 receipt。交易类电子邮件（如发票）无需使用。
verify_receipt	接收收据 ID，并返回包含其哈希值、Ed25519 签名和公钥的收据。

示例

curl https://precleared.dev/api/v1/check \
  -H "Content-Type: application/json" \
  -d '{"recipient_email":"[email protected]","sender_country":"GB","address_source":"published"}'

{
  "verdict": "ok_to_email",
  "confidence": "high",
  "reasons": [{ "rule_key": "gb_corporate_ok", "text": "Under PECR the consent rule for marketing email applies to individual subscribers only...", "source_title": "PECR 2003 regulation 22(1) and ICO Guide to PECR" }],
  "footer_text": "Say who you are and who the email is from, include a valid postal address, and give a simple free way to stop further emails (PECR regulation 23).",
  "next_step": "Send. Log the receipt against the lead.",
  "receipt": { "id": "cc_rcpt_...", "signature": "...", "key_version": "k1", "verify_url": "https://precleared.dev/api/v1/receipt?id=cc_rcpt_..." }
}

收据证明的内容

Precleared 在此时收到过这个问题，并根据这些事实给出了这个答案。每份收据都有对应的公开页面，网址为 https://precleared.dev/r/<id>，也可使用 https://precleared.dev/api/v1/public-key 上的公钥离线验证。这是提供来源依据的决策支持，不构成法律建议。

隐私与条款

https://precleared.dev/privacy · https://precleared.dev/terms