Frisk 是一款面向自主 AI 智能体的交易前风险筛查工具,由 GitHub 仓库 Jiangw2718i/frisk 提供。其核心用途是:在 AI 智能体向 x402 卖家付款或调用不熟悉的工具之前,先行判断交易对手是否可信、该笔交易是否符合既定策略。
主要能力 Frisk 返回 allow、review 或 block 三种裁决,并附上信任评分和人类可读的理由。它明确是建议性的,不持有资金、不拦截付款,最终决定仍由智能体的代码做出。筛查内容覆盖:交易对手是否能解析为地址且不在黑名单上、端点请求的 payTo 是否与指定的交易对手一致、端点是否通过 HTTPS 提供、金额与资产是否落在提供的策略范围内。在托管模式下,allow 还意味着没有发现不利的声誉历史。
Frisk 不判断返回内容,即响应是否匹配预期结构、是否包含付费购买的数据、是否物有所值,这属于调用之后买方自行验证的范畴。同时,allow 也不代表普遍意义上的安全;在 lite 模式下置信度始终为低,因为检查是结构性的:没有历史记录且无缺陷的交易对手,与拥有长期清白记录的交易对手,筛查结果相同。
使用方式 Frisk 提供 TypeScript 和 Python 两种 SDK,二者暴露相同的模型:一个带有 screen() 调用的 Client、一个在本地以零依赖运行的 lite 模式,以及一个可选的托管模式,用于获取声誉历史和实时威胁情报。TypeScript SDK 基于平台 fetch API 构建(适用于 Node、Bun、Deno、Workers、浏览器);Python SDK 仅使用标准库。两个 SDK 均附带完整类型信息。
对于无法导入库的智能体,以及需要以交互方式提问的场景,相同的检查也以 MCP 服务器形式提供,暴露一个工具 screen_payment。无需 API 密钥、无需账户,在无配置情况下完全在本地机器上完成筛查。该服务器在 MCP 注册表中登记为 dev.tryfrisk/frisk。
需要注意:MCP 工具仅在模型选择调用时才会运行,因此模型可以跳过的检查,其保障弱于在签署付款的代码路径上执行同样的检查。在资金实际流转的位置,应优先使用 SDK。
适用场景与限制 Frisk 适用于需要向 x402 卖家付款或调用陌生工具的自主 AI 智能体,可作为代码路径上的付款前筛查,或通过 MCP 工具进行交互式提问。其设计原则包括:建议性而非介入路径、零运行时依赖、完整类型化。
限制方面:lite 模式仅能捕捉明显问题(格式错误的交易对手、payTo 掉包、不安全端点、策略违规和小型种子黑名单),且置信度始终为低;未提供的输入项对应的检查不会运行,也不会失败,例如省略 observedPayTo 则不会发生 payTo 比较;它不评估返回内容的质量。托管 API 位于 https://api.tryfrisk.dev,额外受服务条款约束。仓库另提供 CONTRIBUTING.md 和 SECURITY.md 等文档。