Faro

Faro

エージェントが支払い、クリック、または信頼する前に確認しましょう。

Faro は、AI エージェントやアプリのための信頼レイヤーです。URL、支払先、メッセージ、またはエージェント決済ペイロードを送信すると、Faro は明確な回答を返します。緑、黄、または赤の判定、1 行の理由、そして次に取るべき対応（allow / warn / block / review）です。

このリポジトリは、オープンなインターフェース（Apache-2.0）です。判定コントラクト、クライアント SDK、監査可能な決済プロトコルアダプターを提供します。スコアリングとレピュテーショングラフは Faro のホスト API 上に置かれるため、ブラックボックスのエンジンをフォークせずに、プロセス外へ送信されるデータを監査できます。

API キーを取得 → farofinance.app

---

このパッケージでできること

目的	使用するもの
エージェントがリンクを開いたり共有したりする前に確認する	Python/TS SDK verify_url、REST、または MCP verify_url
送金前に UPI / 支払先 / アカウントを確認する	verify_payee
受信した SMS、メール、チャットに詐欺の手口がないか審査する	verify_message
決済確定前に AP2 / x402 / ACP 決済を制御する	adapters/faro_agentpay/ のオープンアダプター → その後、各成果物を検証
Claude / Cursor / 任意の MCP クライアントから Faro を呼び出す	ホスト型 MCP（https://mcp.farofinance.app/mcp）
安定したコントラクトに基づいてコード内で分岐する	contracts/verdict.schema.json + 型付き SDK

主な利用者： エージェントの開発者、ウォレット／チェックアウトのインテグレーター、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

---

オープンな部分と非公開の部分

ここで公開されているもの： スキーマ、SDK、プロトコルアダプター、レシピ、MCP ツールドキュメントです。インテグレーターやプロトコルのエコシステムがインターフェースを参照し、フォークできるようにしています。

非公開（ホスト API）： シグナルプロバイダー、スコアリング、レピュテーショングラフ、プロンプトです。アダプターはドキュメント化された接続点である「解析 → 成果物 → POST /v1/verify（または独自のチェック） → 任意の worst_of」までを担当します。

---

信頼について、簡潔に

ホスト型の検証では、署名付きの信頼レシートと透明性ログを利用できます（ハッシュと署名のみで、生の PII は含みません）。製品ドキュメント： farofinance.app。

---

ロードマップ／今後の予定

ホスト型製品でリリース済み、または開発中の内容です（すべてがこの公開リポジトリに含まれるわけではありません）。

• 仕様の変更に対応しながら、AP2 / x402 / ACP 全体で支払い前検証の対象範囲を拡大
• 支払先 / メッセージ / URL のシグナル強化と、レピュテーションへの書き戻し
• 以前は問題がなかったエンティティの状態が変化した際の監視と Webhook
• 信頼レシートと、日単位の透明性ログを検証するツール
• SDK の対応言語やフレームワークの例を拡充（LangGraph、Crew など）
• エンジンを公開せずに利用できる、任意の公開サンプル（エージェント防御パターンなど）

アダプター／SDK／ドキュメントの修正に関するコミュニティからの PR を歓迎します（DCO が必要です）。エンジンの変更は受け付けていません。詳しくは CONTRIBUTING.md をご覧ください。

---

これは何ではないか

• セルフホスト可能な詐欺 ML モデルではありません。デフォルトではホスト API を使用します。
• 汎用のプロンプトインジェクション検出器ではありません。Faro はアクションの実行時に 成果物 を検証します。

ブランチ： BRANCHES.md · セキュリティ：SECURITY.md

ライセンス

Apache-2.0。