Faro

Faro

在 Agent 付款、点击或信任之前进行检查。

Faro 是面向 AI Agent 和应用的信任层。发送 URL、收款方、消息或 Agent 付款载荷，Faro 就会返回一个明确的判断：绿色、黄色或 红色，并附上一句话说明原因，以及下一步该怎么做（allow / warn / block / review）。

此代码库提供开放接口（Apache-2.0）：判断契约、客户端 SDK，以及可审计的支付协议适配器。评分和信誉图保留在 Faro 托管 API 中，因此你可以审计离开自身进程的数据，而无需分叉一个黑盒引擎。

获取 API 密钥 → farofinance.app

---

这个软件包能做什么？

你想要……	使用
在 Agent 打开或分享链接前进行验证	Python/TS SDK verify_url、REST 或 MCP verify_url
在汇款前检查 UPI / 收款方 / 账户	verify_payee
检查收到的短信、电子邮件或聊天内容是否包含诈骗手法	verify_message
在结算前拦截 AP2 / x402 / ACP 付款	adapters/faro_agentpay/ 中的开放适配器 → 然后验证每个产物
让 Claude / Cursor / 任意 MCP 客户端调用 Faro	托管 MCP：https://mcp.farofinance.app/mcp
在代码中根据稳定契约进行分支判断	contracts/verdict.schema.json + 类型化 SDK

典型用户： Agent 构建者、钱包/结账集成者、MCP 应用作者，以及需要在采取操作时获得单一红/黄/绿判断，而不是查看满是原始威胁情报的仪表板的安全团队。

---

快速入门

pip install faro-client

import asyncio, os
from faro_client import FaroClient

async def main() -> None:
    async with FaroClient(os.environ["FARO_API_KEY"]) as client:
        result = await client.verify_url("https://example.com")
        print(result.verdict, result.reason, result.recommended_action)
        # Branch: allow | warn | block | review
        if result.recommended_action == "block":
            raise SystemExit("blocked by Faro")

asyncio.run(main())

curl -s -X POST https://api.farofinance.app/v1/verify/url \
  -H "Authorization: Bearer $FARO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"value":"https://example.com"}'

TypeScript：参见 sdk/typescript/。
支付解析器（内部不含引擎）：adapters/faro_agentpay/。
示例方案：recipes/。

---

此代码库包含什么

部件	路径
判断 JSON Schema	contracts/verdict.schema.json
OpenAPI	sdk/openapi.json
Python SDK（faro-client）	sdk/python/
TypeScript SDK	sdk/typescript/
AP2 / x402 / ACP 适配器	adapters/faro_agentpay/
付款前验证示例方案	recipes/
MCP 注册清单	server.json · docs/tools.md

---

为什么开放 / 哪些内容未开放

此处开放： Schema、SDK、协议适配器、示例方案、MCP 工具文档，便于 集成者和协议生态引用并分叉此接口。

未开放（托管 API）： 信号提供方、评分、信誉图、提示词。 适配器止步于文档说明的接口：解析 → 产物 → POST /v1/verify（或 你自己的检查）→ 可选的 worst_of。

---

关于信任，直说

托管验证可以附带签名信任凭证和透明度日志 （哈希和签名，而非你的原始 PII）。产品文档： farofinance.app。

---

路线图 / 未来范围

托管产品中已发布或正在开发的内容（并非全部都包含在此公开 代码库中）：

• 随着规范不断变化，加强 AP2 / x402 / ACP 的付款前验证覆盖范围
• 丰富收款方 / 消息 / URL 信号并回写信誉数据
• 当此前安全的实体状态发生变化时，通过监控与 Webhook 通知
• 信任凭证和基于日期根哈希的透明度日志验证工具
• 支持更多 SDK 语言并提供框架示例（LangGraph、Crew 等）
• 提供可选的公开示例（例如 Agent 防御模式），但不开放引擎

欢迎社区提交 适配器/SDK/文档修复方面的 PR（必须遵守 DCO）。此处不接受引擎 变更，详见 CONTRIBUTING.md。

---

这不是什么

• 不是可自托管的诈骗 ML 模型——默认使用托管 API
• 不是通用提示词注入检测器——Faro 会在采取操作时验证产物

分支：BRANCHES.md · 安全：SECURITY.md

许可证

Apache-2.0。