Bynn

Bynn Agent Skills

Bynn、ZOREAL、Agemin、Detector24 の公式 Agent Skills です。加工された文書、偽造文書、AI 生成の PDF や画像を対象とする 文書不正検知 に加え、本人確認、実在する人間であることを証明するサインインやミーティング、年齢確認、コンテンツ検知の連携方法を、あらゆるコーディングエージェントに教えます。微妙な違いが重大な誤りにつながりやすい箇所も扱います。以下のオンボーディングでは、独自のリポジトリ decision-node-skills から DecisionNode スキルもインストールします。

Claude Code、Cursor、Codex、Copilot、Gemini CLI、OpenCode、Windsurf、Zed、および skills CLI がサポートするその他すべてのエージェントで動作します。

エージェントを一度の操作でオンボーディングする

この行を任意のコーディングエージェントに貼り付けると、agent-setup.md に従って、Bynn、ZOREAL、DecisionNode、Agemin、Detector24 のスキルと MCP サーバーがインストールされます。

Set up Bynn, ZOREAL, DecisionNode, Agemin and Detector24 for me: fetch https://bynn.com/agent-setup.md and follow it.

Claude Code、Cursor、VS Code、Windsurf、Zed、Claude Desktop、ChatGPT、およびヘッドレス環境や CI 環境に対応しており、成功を報告する前にエージェントが確認すべき内容も指示します。

https://bynn.com/agent-setup.md は、このリポジトリの agent-setup.md をそのまま配信します。ソースは https://github.com/Bynn-Intelligence/skills/blob/main/agent-setup.md です。

インストール

任意のエージェントの場合：

npx skills add Bynn-Intelligence/skills

インストーラーには、製品（Bynn、ZOREAL、Agemin、Detector24）ごとにまとめられた選択画面が表示されます。グループの見出しでキーを1回押すと、製品全体の選択を切り替えられます。a を押すと、すべて選択されます。何も事前選択されていません。これは CLI の動作であり、リポジトリごとに設定を変更することはできません。

選択画面を完全に省略するには：

# every skill, every detected agent, no prompts
npx skills add Bynn-Intelligence/skills --all

# every skill, but choose the agents yourself
npx skills add Bynn-Intelligence/skills --skill '*'

# just one product's skills
npx skills add Bynn-Intelligence/skills --skill bynn --skill bynn-mcp --skill bynn-kyc-sessions

コーディングエージェント内で実行すると、選択画面は自動的に省略され、すべてがインストールされます。

バンドルされた MCP サーバーを含む Claude Code の場合：

/plugin marketplace add Bynn-Intelligence/skills
/plugin install bynn@bynn
/plugin install zoreal@bynn

DecisionNode は専用のマーケットプレイスからインストールします。

/plugin marketplace add Bynn-Intelligence/decision-node-skills
/plugin install decisionnode@decisionnode

内容

bynn

ID プラットフォームです。まず bynn スキルから始めてください。ここから他のスキルへ案内します。

スキル	内容
bynn	ルーター。認証モデル、API ベース、エラー、規約を扱います。
bynn-mcp	エージェントを mcp.bynn.com に接続し、ツールを通じて Bynn を操作します。
bynn-document-fraud	文書の偽造、改ざん、AI 生成の分析を扱います。
bynn-kyc-sessions	本人確認セッション：ライブネス、NFC チップの読み取り、事前確認を扱います。
bynn-web-sdk	@bynn-intelligence/websdk を使って、ウェブサイトに本人確認を組み込みます。
bynn-age-verification	年齢推定と未成年者の検知、セルフィー、ライブネスを扱います。
bynn-moderation	画像、動画、テキスト、音声を対象とするすべての検知モデルを扱います。
bynn-face-search	顔コレクション、登録、1:N 検索を扱います。
bynn-autodoc	メールまたは SMS で送信する文書リクエストを扱います。
bynn-webhooks	ペイロード、イベントカタログ、署名検証を扱います。

zoreal

デジタルでのやり取りの背後に実在する人間がいることを証明する、信頼レイヤーの ZOREAL です。

スキル	内容
zoreal	ルーター。各 ZOREAL 製品が証明する内容と、ZOREAL Verify の連携に Bynn のスキルを使う理由を扱います。
zoreal-identify	ZOREAL でのログイン：クライアントライブラリ、スコープ、acr でライブな人間を必須にする方法、保証ブロックを扱います。
zoreal-meet	ZOREAL Meet のミーティング API、ホストコントロールとプレゼンスルール、および ZOREAL Book の埋め込みを扱います。

PDFChecker を含む ZOREAL Verify は、現在 Bynn API を通じてチェックを実行するため、その連携については bynn-document-fraud と bynn-kyc-sessions で扱います。

agemin

ウェブサイトやアプリ向けの生体認証による年齢確認です。

スキル	内容
agemin	ルーター。アセット ID と秘密鍵の違い、およびブラウザーの判定が証明にならない理由を扱います。
agemin-web-sdk	@bynn-intelligence/agemin-sdk、年齢制限、SEO のバイパス、React、Vue を扱います。
agemin-api	サーバー側での確認、メールとセルフィーのチェック、参照情報の照会を扱います。

detector24

画像、動画、音声、テキスト用の検出モデル。

スキル	対象
detector24	モデルの input_schema と output_schema の読み取り、非同期での送信、メディアを決して前処理してはならないというルール。

認証情報

ここに認証情報は含まれていません。各スキルに、必要なキーとその入手先が記載されています。

製品	キーの入手先
Bynn	https://dashboard.bynn.com（/authenticate でエージェントトークンを取得）
ZOREAL	https://zoreal.com：ZOREAL でのログイン用アセット、設定、Meet API 用の API キー
DecisionNode	https://decisionnode.com/console/keys
Agemin	https://agemin.com/app
Detector24	https://detector24.ai/app

MCP サーバーに接続する

スキルをインストールしても、Bynn MCP サーバーには接続されません。npx skills add はスキルファイルをコピーするだけです。Bynn のツールを利用するには、別途接続してください。

claude mcp add --transport http bynn https://mcp.bynn.com

その後、/mcp を実行してサインインします。Claude Code プラグインはこの URL を登録しますが、サインインが完了するまでは動作しません。ヘッドレスで使用する場合は、代わりにトークンを渡してください。

claude mcp add --transport http bynn https://mcp.bynn.com \
  --header "Authorization: Bearer $BYNN_API_TOKEN"

エンドポイントはルートパスです。/mcp を追加すると 404 が返されます。

DecisionNode のドキュメントサーバーにはキーもサインインも不要で、decisionnode プラグインが登録します。

claude mcp add --transport http decisionnode-docs https://decisionnode.com/mcp
``` Other clients, including
Claude Desktop, ChatGPT, Cursor, VS Code, Windsurf, and Zed, are covered in the
`bynn-mcp` skill.

## Two rules worth reading before you build

**Never preprocess media.** Do not resize, crop, re-encode, or strip metadata before
submitting an image, video, or document for fraud, tampering, or AI-generation analysis.
Those detectors read artifacts that live in the exact bytes of the original file, and
processing destroys them silently. The result comes back looking clean.

**The browser is never the verdict.** SDK callbacks run on the visitor's own machine.
Confirm every result server side before unlocking anything.

## Documentation

- Agent onboarding: [`agent-setup.md`](agent-setup.md)
- Bynn: `https://docs.bynn.com`, spec at `https://api.bynn.com/openapi.json`
- ZOREAL: `https://zoreal.com/documentation`, sign-in provider at `https://id.zoreal.com/.well-known/openid-configuration`
- DecisionNode: `https://decisionnode.com/docs`, docs MCP server at `https://decisionnode.com/mcp`
- Agemin: `https://agemin.com/docs`
- Detector24: `https://detector24.ai/docs`

## License

MIT. See [LICENSE](LICENSE).