otr-protocol

OTR 协议

AI Agent 商业交易的商家信任层
为 Agent 经济打造的确定性、可验证、开源商家信任评分
协议 v4.1

规范 • 评分算法 • 快速开始 • 软件包 • 参与贡献

---

问题

AI Agent 正日益代表消费者做出购买决策。Agent 商业交易技术栈正在成形——但其中缺少一个至关重要的层：

┌──────────────────────────────────────────────────────────────────┐
│                  AI Agent Commerce Protocol Stack                 │
├──────────────────────────────────────────────────────────────────┤
│                                                                   │
│   Visa TAP ·············· Agent Identity Verification             │
│   Google UCP ············ Structured Data Exchange                 │
│   Stripe ACP ············ Payment Processing                      │
│                                                                   │
│   ┌───────────────────────────────────────────────────────────┐   │
│   │  OTR Protocol ·····  MERCHANT TRUST VERIFICATION  ◀━━━━━ │   │
│   │                      "Is this merchant safe to buy from?" │   │
│   └───────────────────────────────────────────────────────────┘   │
│                                                                   │
│   Visa TAP answers "Who is the AI agent?"                         │
│   Google UCP answers "What products are available?"               │
│   Stripe ACP answers "How do I pay?"                              │
│   OTR answers "Should I trust this merchant?"  ◀━━ ONLY OTR      │
│                                                                   │
└──────────────────────────────────────────────────────────────────┘

没有 OTR，AI Agent 就只能盲目运作，无法区分正规零售商与精心伪装的诈骗网站。这会让消费者面临欺诈风险，并侵蚀人们对整个 Agent 商业交易生态系统的信任。

解决方案

OTR（Open Trust Registry） 使用 6 个验证维度、10 层反欺诈流程（第 0 层：Google Web Risk 一票否决；第 1-9 层：核心检测引擎）和三层不可变审计轨迹，提供确定性、可验证的商家信任评分。它完全开源（MIT），支持机器读取，并从设计之初就面向 AI Agent 使用。

主要特性

• 确定性——相同输入始终产生相同输出。任何验证者都可以复现任意评分。
• 可验证——所有数据源均可公开访问。没有隐藏因素或专有信号。
• 不可伪造——验证维度在公开评估中的权重为 40%。SEC 文件、Wikidata 条目和 10 年域名年龄都无法伪造。
• 防篡改——SHA-256 哈希链 + Base L2 区块链锚定 + IPFS 月度快照。
• 公平——不花钱买信任。评分反映行为，而非订阅等级。
• 类别感知——提供三种网站类别（电商 / saas / 非商业），并采用相应的评分权重。
• 安全优先——Google Web Risk 第 0 层一票否决：被标记的域名得分为 0，状态为 SUSPENDED。

快速开始

# Verify any merchant instantly
npx @otr-protocol/validator verify nike.com

# Output:
# ┌──────────────────────────────────────────────┐
# │  nike.com                             GOLD   │
# │  Trust Score: 88/100   Category: ecommerce   │
# │  OTR-ID: OTR-1C-7F3A2B9E4D1C-K4             │
# │                                              │
# │  Verification:   85  ██████████████░░        │
# │  Security:       80  █████████████░░░        │
# │  Governance:     72  ████████████░░░░        │
# │  Transparency:   75  ████████████░░░░        │
# │  Data Quality:   65  ██████████░░░░░░        │
# │  Fulfillment:    --  (COLD mode)             │
# └──────────────────────────────────────────────┘

面向 AI Agent（MCP 服务）

OTR MCP 服务采用标准的 Model Context Protocol，适用于所有兼容 MCP 的客户端。

Claude Desktop / Claude Code——添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "otr": {
      "command": "npx",
      "args": ["@otr-protocol/mcp-server"]
    }
  }
}

Cursor / Windsurf / Cline——在 .cursor/mcp.json 或相应配置文件中使用相同配置。任何实现 MCP 规范的客户端都可以开箱即用。

现在，任何 AI Agent 都可以用自然语言验证商家：

“nike.com 可信吗？” --> OTR 返回 88/100 的信任评分、GOLD 徽章，以及包含证据来源的 6 维评分明细（Verification、Security、Governance、Transparency、DataQuality、Fulfillment）。

两种 MCP 工具——一次调用，获得完整答案

工具	描述	返回内容
verify_merchant	一次调用即可获取完整的商家档案	信任评分（0-100）、徽章、6 个维度的细分评分、安全状态（Google Web Risk）、网站分类（电商/ SaaS /非商业）、实体数据、政策 URL、数据来源
search_registry	搜索 OTR 商家注册表	带评分、徽章和推荐的分页商家列表

**设计理念：**AI Agent 应通过一次工具调用获取所需的一切。verify_merchant 会返回信任评估、购买能力、链接、政策 URL 和数据新鲜度，无需串联多次调用。

TypeScript SDK

import { OtrClient } from "@otr-protocol/sdk";

const otr = new OtrClient();
const result = await otr.verify("nike.com");

console.log(result.trustScore);   // 88
console.log(result.badge);        // "GOLD"
console.log(result.dimensions);   // { verification: 85, security: 80, ... }

// Search the registry
const results = await otr.search("electronics", { minScore: 70 });

核心评分引擎

import { calculateTrustScore } from "@otr-protocol/core";

// Deterministic: same inputs always produce identical outputs
const result = calculateTrustScore({
  hasSecFiling: true,
  hasStockSymbol: true,
  stockExchange: "NYSE",
  hasWikidataId: true,
  trancoRank: 500,
  domainAgeYears: 15,
  // ... 40+ evidence fields
});

console.log(result.trustScore);  // 88
console.log(result.badge);       // "GOLD"
console.log(result.tier);        // "TIER_4"

架构

                         ┌─────────────────────────────────┐
                         │       AI Agent / Application      │
                         │   "Should I buy from example.com?" │
                         └──────────────┬──────────────────┘
                                        │
                    ┌───────────────────┼───────────────────┐
                    │                   │                    │
              ┌─────▼─────┐     ┌──────▼──────┐    ┌──────▼──────┐
              │ MCP Server │     │  REST API   │    │   SDK       │
              │  (stdio)   │     │  /api/otr   │    │  npm pkg    │
              └─────┬──────┘     └──────┬──────┘    └──────┬──────┘
                    │                   │                    │
                    └───────────────────┼───────────────────┘
                                        │
                         ┌──────────────▼──────────────┐
                         │      OTR Scoring Engine       │
                         │   @otr-protocol/core          │
                         │                               │
                         │  ┌─────────────────────────┐  │
                         │  │ 6 Dimension Evaluators   │  │
                         │  │ Verification | Security  │  │
                         │  │ Governance | Transparency│  │
                         │  │ DataQuality | Fulfillment│  │
                         │  └─────────────────────────┘  │
                         │  ┌─────────────────────────┐  │
                         │  │ 10-Layer Anti-Fraud      │  │
                         │  │ Domain Age | SSL | DNS   │  │
                         │  │ Pattern | Tranco | ...   │  │
                         │  └─────────────────────────┘  │
                         │  ┌─────────────────────────┐  │
                         │  │ Brand Fast-Track         │  │
                         │  │ SEC + Tranco + Wikidata  │  │
                         │  └─────────────────────────┘  │
                         └──────────────┬──────────────┘
                                        │
              ┌─────────────────────────┼─────────────────────────┐
              │                         │                          │
     ┌────────▼────────┐    ┌──────────▼──────────┐    ┌─────────▼─────────┐
     │  Public Data     │    │  Merchant Bridge     │    │  Immutable Audit   │
     │  Sources         │    │  (Verified Only)     │    │  Trail             │
     │                  │    │                      │    │                    │
     │  SEC EDGAR       │    │  Product Catalog     │    │  SHA-256 Hash      │
     │  Wikidata        │    │  Order Data (agg)    │    │  Chain             │
     │  Tranco List     │    │  Delivery Metrics    │    │  Base L2 Anchoring │
     │  DNS Records     │    │  Tracking Numbers    │    │  IPFS Snapshots    │
     │  SSL Certs       │    │  (desensitized)      │    │                    │
     │  Finnhub.io      │    │                      │    │                    │
     │  Google Web Risk │    │                      │    │                    │
     │  Website Scan    │    │                      │    │                    │
     └─────────────────┘    └──────────────────────┘    └───────────────────┘

评分机制

6 个信任维度

权重因网站类别而异：

#	维度	电商 COLD	SaaS COLD	AUTH 模式	衡量内容
1	验证	0.40	0.37	0.10	证券交易所、Wikidata、GLEIF LEI、域名年龄、Tranco 排名、支付处理商
2	安全	0.15	0.20	0.10	SSL/TLS、DMARC、SPF、DKIM、HSTS、DNSSEC、CSP、CAA、WAF、security.txt（15 项信号）
3	治理	0.20	0.23	0.10	隐私政策、GDPR/CCPA、条款、退款/退货、配送、Cookie 同意（10 项信号）
4	透明度	0.10	0.15	0.05	robots.txt、sitemap、Schema.org、hreflang、AI 爬虫政策、llms.txt、关于页面
5	数据质量	0.15	0.05	0.25	电商：22 项产品数据信号。SaaS：12 项平台信号（API 文档、SLA、定价、安全认证）
6	履约	--	--	0.40	配送速度、退货期限、追踪、配送政策（COLD 模式下不评分）

各维度的衡量内容

维度	评估内容
验证 (V)	这是否是一家真实的注册企业？SSL 证书类型、GLEIF LEI、Wikidata 实体、SEC 文件、域名年龄、支付处理商检测
安全 (S)	网站在技术层面是否安全？DMARC、SPF、DKIM、HSTS、CSP、WAF、DNSSEC 配置
治理 (G)	是否遵守业务规则？隐私政策、退款政策、配送政策、Cookie 同意、法规合规性
透明度 (T)	是否便于机器读取？robots.txt、Schema.org 结构化数据、llms.txt、协议端点可用性
数据质量 (D)	产品/服务数据是否完整？产品数量、图片覆盖率、价格格式一致性、类别分类体系深度
履约 (F)	是否兑现承诺？订单完成率、配送时间、退货率、争议率（仅限 AUTH 模式——需要商家数据）

为什么不同类别的权重不同

• 电商：验证权重最高（0.40），因为买家在购买前需要信任商店。身份信号（SEC 文件、Wikidata、域名年龄）是防范欺诈商店最有效的手段。
• SaaS：安全（0.20）和治理（0.23）的权重较高，因为 SaaS 平台会处理用户数据，因此需要明确的政策。用户会将信息的持续访问权限托付给平台。
• 非商业：不评分。不销售产品或服务的网站不具备适用的商业维度（产品数据、结账、履约）。

三种网站类别

类别	描述	评分方式
ecommerce	销售实体/数字产品的在线商店	按完整的 6 个维度评分，并包含产品 D 信号
saas	软件即服务平台	采用定制权重（V=37%，G=23%），并包含 12 项 SaaS D 信号
non_commerce	非商业网站（Wikipedia、政府网站等）	不评分——仅返回身份信号

非电商网站

归类为 non_commerce 的网站（例如，Wikipedia、政府门户网站、新闻网站）不进行评分：

• trustScore：null
• badge：null
• scanStatus："non_commerce"
• 仍会返回基本验证数据（SSL、实体信息），但不会分配数值信任评分。

原因：非电商网站不销售产品或服务，因此信任评分维度（产品数据、结账、履约）不适用。

OTR-ID

分配给每个受评估域名的唯一标识符。

格式：OTR-1{mode}-{fingerprint}-{checksum}

• 1 — 协议版本
• mode — C（COLD：预授权扫描）或 A（AUTH：商家已授权）
• fingerprint — 12 位大写十六进制字符，由规范化域名的 SHA-256 派生（前 48 位）
• checksum — 2 个 Base36 字符（Luhn mod-36 验证 + 确定性盐值）

Example: OTR-1C-7F3A2B9E4D1C-K4

属性：

• 确定性：同一域名始终生成相同的指纹
• 不可逆：SHA-256 在密码学上是单向的；截取 48 位后，无法还原原始域名
• 抗碰撞：约有 281 万亿种可能的指纹（2^48）

生命周期：

事件	结果	状态
首次扫描	生成 OTR-1C	ACTIVE
商家授权	升级为 OTR-1A（指纹相同，重新计算校验和）	UPGRADED
检测到域名身份变更	撤销 OTR-ID（设为 NULL），域名重新进入冷启动	REVOKED
Google Web Risk 将域名标记为风险	评分强制设为 0	SUSPENDED
反作弊乘数 < 0.10	评分强制设为 0	SUSPENDED

当加权信号超过阈值 3 时，系统会检测到身份变更：GLEIF 实体不匹配（3）、名称服务器变更（2）、内容相似度 < 30%（2）、Wikidata P856 不匹配（2）、域名停放 > 90 天（2）、SSL 组织变更（1）。

Google Web Risk（第 0 层安全防护）

Google Web Risk 作为第 0 层一票否决机制运行，与维度评分分开处理：

• 被标记的域名 → trustScore = 0、otrIdStatus = SUSPENDED、safety.googleWebRisk = true
• 不参与维度权重计算
• 无论其他信号的值如何，均具有覆盖效力

两种评分模式

COLD Mode: Public Assessment (no merchant cooperation needed)
═══════════════════════════════════════════════════════════════
  E-Commerce: V (0.40) + S (0.15) + G (0.20) + T (0.10) + D (0.15) = Score
  SaaS:       V (0.37) + S (0.20) + G (0.23) + T (0.15) + D (0.05) = Score

  Nike (ecommerce):   V=85×0.40 + S=80×0.15 + G=72×0.20 + ...  = 83 GOLD
  Scam site:          V=10×0.40 + S=100×0.15 + G=90×0.20 + ...  = 39 UNRATED
                                                                    ↑ can't game Verification


AUTH Mode: Verified Merchant (merchant provides API access)
═══════════════════════════════════════════════════════════════
  F (0.40) + D (0.25) + V (0.10) + S (0.10) + G (0.10) + T (0.05) = Score

  Good merchant:   F=90×0.40 + D=85×0.25 + ...  = 78 SILVER
  Bad merchant:    F=30×0.40 + D=40×0.25 + ...  = 38 UNRATED
                                                    ↑ bad fulfillment = low score

信任徽章

徽章	评分	AI Agent 操作
PLATINUM	90-100	可放心推荐，置信度高
GOLD	80-89	信任度高，推荐给 AI Agent
SILVER	70-79	可推荐，但应保持常规谨慎
BRONZE	60-69	仅展示，建议用户自行核实
UNRATED	0-59	提醒用户信任数据不足

评分达到 95+ 时会触发人工审核建议。没有硬性上限。如果 safety.status 为 "DANGEROUS"（Google Web Risk），无论评分如何，均不要推荐。

10 层反欺诈引擎

OTR 通过 10 层检测流程，防止欺诈网站操纵系统：

Layer 0  Safety Check        Google Web Risk API — malware/phishing one-vote-veto (instant block)
Layer 1  Domain Age          Certificate history analysis (crt.sh)
Layer 2  SSL Security        HTTPS/HSTS verification, self-signed detection
Layer 3  DNS Security        DMARC, SPF, DKIM policy completeness
Layer 4  Domain Pattern      Brand impersonation (amaz0n-deals.xyz), suspicious TLDs
Layer 5  Tranco Rank         Independent traffic ranking verification
Layer 6  Content Analysis    Phishing keywords, parked domains, empty pages
Layer 7  Redirect Chain      Cross-domain redirect detection
Layer 8  Cross-Signal        Multi-signal correlation and accumulation rules
Layer 9  Anti-Gaming         Signal-brand mismatch, identity-gameable gap, template suspect
         ▼
         Layer 0 DANGEROUS = immediate rejection (one-vote-veto)
         Single CRITICAL signal = immediate rejection
         Fraud score > 30 = rejection
         Anti-gaming multiplier applied to gameable dimensions

反作弊检测模式（第 9 层）

模式	触发条件	乘数
信号与品牌不匹配	可操纵信号均值 ≥ 80 + 无 Tranco/Wikidata/SEC + 身份 < 30	0.5x
身份与可操纵信号差距	身份 < 20 + 可操纵信号均值 > 70 + 无已确立身份	0.7x
疑似模板网站	域名注册时间 < 1 年 + 无 Tranco/Wikidata/SEC + 可操纵信号均值 > 60	0.5x
域名年龄限制（<6 个月）	域名注册时间不足 6 个月	上限为 50
域名年龄限制（<1 年）	域名注册时间不足 1 年	上限为 75

反作弊实践

场景	旧版 v3 评分	新版 v4 评分	变化
Nike（正规品牌）	83 GOLD	83 GOLD	--
诈骗网站（技术表现完美）	39 UNRATED	35 UNRATED	-4
诈骗网站 + 反作弊	28 UNRATED	22 UNRATED	-6

数据完整性

OTR 使用三层不可变审计跟踪，确保历史评分无法被篡改：

Layer 1: PostgreSQL Hash Chain (real-time, $0/year)
├── Every score change records SHA-256 hash
├── Each record links to previous via prev_hash
├── Any modification breaks the chain → detectable
└── verifyChainIntegrity() → instant verification

Layer 2: Base L2 Blockchain Anchoring (daily, ~$0.37/year)
├── Daily chain-head hash written to Base L2 smart contract
├── Externally verifiable by anyone
├── AWS KMS hardware security for signing keys
└── Transaction hash stored in otr_l2_anchors table

Layer 3: IPFS Monthly Snapshots (monthly, $0/year via web3.storage)
├── Full registry exported as content-addressed JSON
├── CID (Content Identifier) is immutable
├── Anyone can retrieve and verify the snapshot
└── CIDs recorded in otr_snapshots table

公开验证端点：

GET /api/otr/audit/chain-integrity     Verify hash chain completeness
GET /api/otr/verify/:domain/history    Score history with trend data
GET /api/otr/audit/l2-anchors          Base L2 anchoring records
GET /api/otr/audit/snapshots           IPFS snapshot CID listing

多源共识

OTR 从不盲目信任任何单一数据源。每个外部数据点都必须通过交叉验证：

Source Weights (not all sources are equally trustworthy):
  google-web-risk   1.0   Google Safe Browsing → one-vote-veto on DANGEROUS
  sec.gov           1.0   Government source → highest trust
  dns-query         0.9   Infrastructure → high trust
  tranco-list.eu    0.9   Academic source → high trust
  wikidata.org      0.8   Community source → high but editable
  finnhub.io        0.7   Commercial API → moderate-high trust
  website-scan      0.6   Self-reported → moderate trust
  product-sample    0.5   Product page sampling → public but limited scope
  merchant-api      0.4   Merchant-declared → low trust (can be faked)

Consensus Rules:
  ✓ 2+ sources agree → accepted (high confidence)
  ✗ Sources disagree → rejected (keep existing value)
  ⚠ Single source drift > 30% → anomaly flagged
  🔒 3+ anomalies from one source → auto-quarantine

数据脱敏

商家提供履约数据时，OTR 会应用 4 个级别的隐私保护：

级别	阶段	处理方式
L1	传输前	客户姓名 → SHA-256 哈希，地址 → 仅保留国家+城市，邮箱/电话/支付信息 → 删除
L2	传输中	TLS 1.3 + HMAC-SHA256 签名 + nonce 防重放
L3	服务端	即时汇总为统计数据，原始数据绝不持久化
L4	审计跟踪	仅记录元数据（时间戳、数量），绝不记录内容

为什么选择 OTR？

功能	OTR	Trustpilot	BBB	Google Merchant
AI 原生 API（MCP 服务）	是	否	否	否
确定性评分	是	否	否	否
开源算法（MIT）	是	否	否	否
不付费买信任	是	否	否	是
多源验证	6 个维度	1（星级）	1（等级）	部分
反操纵检测	10 层	否	否	否
机器可读输出	完整 JSON	部分	否	部分
不可篡改审计跟踪	3 层	否	否	否
感知类别的评分	3 种类型	否	否	否
一致性测试套件	是	不适用	不适用	不适用
数据脱敏	4 级	不适用	不适用	部分

软件包

软件包	描述	npm
@otr-protocol/core	确定性评分引擎——参考实现
@otr-protocol/mcp-server	面向 AI Agent（Claude、Cursor、Windsurf、Cline）的 MCP 服务
@otr-protocol/validator	用于商家验证的命令行工具
@otr-protocol/sdk	用于应用集成的 TypeScript 客户端 SDK

一致性测试

任何 OTR 实现都必须通过标准一致性测试向量：

npm run conformance

测试套件会验证确定性：在所有实现（TypeScript、Python、Go、Rust）中，相同输入会产生相同输出。这确保无论由哪个验证器计算，商家的信任评分都相同。

conformance/test-vectors.json 中的测试向量涵盖：

• 网站类别检测（ecommerce / saas / non_commerce）
• 评分模式检测（COLD 与 AUTH）
• 使用类别专属权重进行单个维度评分
• 徽章和等级分配（PLATINUM/GOLD/SILVER/BRONZE/UNRATED）
• 反操纵检测和惩罚应用
• Google Web Risk 安全覆盖
• 非商业类别排除
• 边界情况（空数据、null 字段、边界值）

评分完整性

OTR Protocol 通过以下承诺维护商户信任评分的完整性和独立性：

1. 不出售评分——信任评分无法购买、赞助，也不受商业因素影响。没有任何高级套餐、赞助或合作关系会影响评分。
2. 信任不可付费购买——订阅状态对 OTR 评分的影响为零。免费套餐商户和企业客户接受相同的评估。
3. 不接受人工干预——所有评分均由算法计算。任何个人都不能手动调整任何评分。
4. 算法透明——整个算法均以开源方式发布（MIT）。任何人都可以审计、验证和复现任意评分。重新扫描同一域名会产生相同的评分（确定性流水线）。
5. 仅依据数据——评分反映可独立验证的信号。商户提交的数据会标记为 verified=false，且 scoringWeight=0；还必须至少有 2 个独立权威来源佐证。

**执行机制：**开源代码 + 一致性测试 + 治理流程 + 具有累积乘数效应的 10 层反博弈检测。

使命

OTR 旨在为 AI Agent 商业时代打造公平、透明的信任层。任何商户——无论规模大小或品牌知名度高低——都可以凭借可验证的表现赢得信任。提升评分的唯一途径是改善实际的信任信号。

公开数据来源

OTR 仅使用公开可访问的数据评估商户（COLD 模式）。无需商户配合。

来源	数据	可验证性
DNS 记录	SPF、DMARC、DKIM、DNSSEC、MTA-STS、CAA	是——标准 DNS 查询
SSL/TLS 证书	类型（DV/OV/EV）、颁发 CA、组织	是——证书透明度日志
HTTP 标头	HSTS、CSP、X-Frame-Options、Permissions-Policy	是——任何 HTTP 客户端
网站内容	政策页面、产品目录、Schema.org 标记	是——公开网页
Tranco List	域名热度排名（前 1M）	是——tranco-list.eu（学术机构）
WHOIS / crt.sh	域名年龄、证书历史记录	是——公共注册机构
Wikidata	通过 P856（官方网站）验证实体	是——wikidata.org（CC0）
GLEIF	法律实体识别编码（LEI）、ISO 17442	是——gleif.org
SEC EDGAR	美国监管申报文件	是——sec.gov
Finnhub / OpenFIGI	证券交易所上市信息、股票代码解析	是——finnhub.io / openfigi.com
Google Web Risk	恶意软件、网络钓鱼、不需要的软件检测	是——Google API

路线图

阶段	状态	描述
阶段 1	已完成	开源评分引擎、MCP 服务、CLI、SDK、一致性测试
阶段 2	已完成	哈希链完整性、L2 锚定、IPFS 快照、多源共识、数据脱敏、评分衰减、Google Web Risk Layer 0 安全层、3 种站点类别（ecommerce/saas/non_commerce）、SaaS D 维度的 12 个信号、COLD/AUTH 评分模式
阶段 3	计划中	IETF Internet-Draft 标准化、Python/Go SDK、学术论文

参与贡献

欢迎参与贡献。详细指南请参阅 CONTRIBUTING.md。

评分算法变更的关键要求：

1. 在 spec/ 中提交 RFC 风格的提案
2. 更新一致性测试向量
3. 验证确定性
4. 由维护者审核

许可证

MIT —— ORBEXA

---

协议规范 • 评分算法 • 治理模型 • 贡献指南 • 行为准则

_{由 ORBEXA 构建——Agent 商业基础设施}