SuperAPI AI 工具集

frisk

Frisk 是为自主 AI 智能体提供的交易前风险筛查工具。在智能体向 x402 卖家付款或调用陌生工具之前,可用它判断交易对手是否可信、交易是否符合自身策略。Frisk 返回 allow、review 或 block 三种裁决,并给出信任评分和人类可读的理由,但仅为建议性质,最终决策仍由智能体自行掌握。它同时提供 TypeScript 与 Python 两种 SDK,均暴露相同的模型:带有 screen() 调用的 Client、零依赖本地运行的 lite 模式,以及可选托管模式(提供声誉历史与实时威胁情报)。对于无法导入库的智能体,还提供 MCP 服务器形式,暴露单一工具 screen_payment,无需 API 密钥和账户,默认在本地完成全部筛查。lite 模式可捕捉明显问题,如格式错误的交易对手、payTo 掉包、不安全端点、策略违规以及小型种子黑名单;托管 API 则增加声誉历史与持续更新的威胁情报。Frisk 筛查的是“付款给谁”,不判断返回内容是否符合预期、是否包含所购数据或是否物有所值。

访问官网

工具介绍

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 等文档。