# 組み込みガイド — 『PARRY（`@andq/patriot`）』を自分のサイト・製品に組み込む（開発 AI に渡す 1 枚）

**表のサービス看板名**：**『PARRY』**
**サブコピー**：「漏れたなら、漏れたあとを心配したい。」
版：2026-11-10（`@andq/patriot` 1.0.0 ＆ `@andq/tapp` 対応）
正本：`src/`（エンジン本体）。

**使い方**：この文（または `/guide.md` の URL）をそのまま、あなたの開発 AI（Cursor・Claude Code・Codex・Antigravity）に貼る。AI が「先に確かめる事」（§4）を返してきたら答える。あとは AI が票を切って実装する。人がやるのは **環境変数を入れる・deploy する・最後に 1 回テスト送信する** の 3 つ。

---

## 0. 一枚まとめ ＆ 2ティア料金プラン

PARRY は「①連絡先はもう漏れている前提で、漏れたあとに届くものを入口で受け流す ②営業・ご提案は有償受付（1件1,000円・税別）の見える案内（`/reception`）へ誘導し、同意のうえ送信された提案だけを確定発注（`order_confirmed`）として処理する ③自動送信は受付保留（`quarantine_candidate`・請求なし）として隔離する」受付・検疫プロトコル。
確定した発注事実（本文の独立ダイジェスト `contentDigest` ＋ 規約ノンス `termsNonce` ＋ 規約ハッシュ ＋ 観測 AS 番号/組織名を結合した 64 文字 SHA-256 指紋）を `@andq/tapp` 経由で Sigstore Rekor（公開の追記専用ログ）に固定し、自前請求書（`/invoice/:orderId`）と有料契約テナント間の共有防衛インデックス（`GET /api/shared-index`）を発行する。

### 料金プラン（2ティア構成）
1. **① 個人・親孝行見守りプラン（月額 390円 税込・現在準備中）**
   - 対象：実家の親のスマホ・自宅電話を特殊詐欺や自動音声アンケート・不用品買取営業から守りたい個人・家族
   - 機能：専用050検疫番号の付与、海外番号・共有防衛リスト番号の0秒 `<Reject/>` 遮断、10秒音声検疫、家族へのリアルタイムLINE/メール通知レポート（※電話ゲート・個人プランは現在準備中）
2. **② 法人・社長防衛プラン（月額 3,980円 税別）**
   - 対象：フォーム営業ボット・一斉営業メールに時間を奪われている法人・個人事業主・店舗
   - 機能：Webフォーム有償受付ゲート `<script>`（見える有償受付案内＋自動送信隔離）、TAPP（Sigstore Rekor）固定、自前1,000円請求書発行、**有料会員間の共有防衛インデックス（`GET /api/shared-index` / MCP API）フルアクセス**、および回収された有償受付料（1,000円/件）の受取（プラットフォーム手数料控除後）

| ゲート | 入口 | 仕分け・受付ルール（WRITE のみ） | 残る事実・出力 |
|---|---|---|---|
| ① Web フォーム (`patriot-form`) | `<script src="/trap.js" defer></script>` ＋ `/reception` ＋ `POST /api/order/form` | ・見える有償受付フォーム（`visible_paid_consent=true` ＋ サーバー発行 `terms_nonce`）からの送信 → 1,000 円発注確定（`order_confirmed`）<br>・不可視DOM・隠しハニーポット・打鍵＋解除URL/ドメイン不一致 → 受付保留（`quarantine_candidate`・請求なし）<br>・共有防衛遮断リスト一致 → 受付遮断（新規発注なし） | 発注確定時は TAPP Rekor 固定・自前請求書 URL ／ 受付保留時は有償受付フォーム案内 |
| ② メール (`patriot-mail`・準備中) | `POST /api/order/mail`（既定無効） | 専用有償受付アドレス宛ての着信、または `unsubscribe` / ドメイン不一致付き一斉配信メール | TAPP Rekor 固定・請求書 URL |
| ③ 電話・親見守り (`patriot-call`・準備中) | Twilio Voice Webhook `POST /api/order/call`（既定無効） | ①共有防衛インデックス未入金番号・海外番号帯は 0 秒 `<Reject/>` ②親見守り検疫（家族は `1`、有償発注は `9`） ③`9` 押下（確定発注 `order_confirmed`）または連続発話（受付保留 `quarantine_candidate`） | 0 秒遮断ログ／家族通知レポート／1,000 円発注確定＆SMS 請求書通知 |

---

## 1. あなた（開発 AI）への依頼

私の Web サイトまたはアプリケーションに PARRY（`@andq/patriot`）を組み込んでください。下の「守るべき 3 つの線」を厳守し、§4「先に確かめて返す事」を質問してから、§5 の票ごとに最小破壊で実装してください。

### 守るべき 3 つの線（絶対に変えない）
1. **READ（閲覧・HTTP GET）は 100% 自由、人間の通常問い合わせを止めない。**
   - ページを見に来るだけのクローラーや人間の通常フォーム送信はそのまま既存処理へ通す。
   - サーバーが万一タイムアウトしても、`SafePatriot` クライアントは例外を投げず `{ intercepted: false }` を返して既存の問い合わせ処理を続行させる。
2. **課金の根拠は「見える有償受付フォームでの同意」のみ。入口で Stripe 等の外部決済 API を一切叩かない。**
   - 自動送信は「受付保留（請求なし）」として隔離し、見える有償受付フォーム（`/reception`）で同意した送信のみを有償受付枠（1,000 円・税別）の発注事実として `@andq/tapp`（Sigstore Rekor）へ固定し、自前請求書 URL（`/invoice/:orderId`）を発行する。
3. **客向け画面・通知・請求書・公開インデックスに「評価語」を一切出さない。**
   - 使わない語：悪質・スパム・詐欺・犯罪・迷惑業者・ブラックリスト・晒し・不正・流出・監視・証明・証拠・検出・完全・100%・防ぐ・確実・パクリ・侵害・違法・不審・盗作。
   - 使う語：「発注記録」「固定」「規約に基づくゲート利用料（1,000 円）」「支払未履行」「一致」「確かめる」「指紋（64 文字）」。

---

## 2. 組み込みコード（3 つの方法）

### 2-1. 最速 1 行：Web サイトの HTML / レイアウトに貼るだけ
既存の `<head>` または `</body>` 直前に 1 行追加する。これだけで各フォーム直前への「営業・ご提案は有償受付（1件1,000円・税別）」の見える案内表示と、自動送信プログラムを受付保留へ回す仕分け計測が自動で有効になる。
```html
<script src="https://your-parry-host.example.com/trap.js" data-patriot-base="https://your-parry-host.example.com" defer></script>
```

### 2-2. バックエンド組み込み：`SafePatriot`（Next.js / Cloudflare Workers / Express / Hono）
既存の問い合わせ API（例：`POST /api/contact`）の先頭に 3 行入れる。有償受付同意または自動送信保留の対象だけをゲート側で処理し、通常の問い合わせはそのまま既存のメール送信・DB 保存へ流す。
```js
import { SafePatriot } from "@andq/patriot";

const patriot = new SafePatriot({
  baseUrl: process.env.PATRIOT_URL || "http://localhost:3980",
  tenantId: process.env.PATRIOT_TENANT_ID || "my-company",
});

// 既存の問い合わせ POST ハンドラ内
export async function POST(req) {
  const body = await req.json();

  // 1. フォーム仕分け（万一サーバーが落ちていても通常問い合わせを止めない）
  const gate = await patriot.inspectForm(body, {
    ipAddress: req.headers.get("x-forwarded-for") || "",
    asn: req.headers.get("x-asn") || "",
    asOrg: req.headers.get("x-as-org") || "",
  });

  // 2. 有償発注または受付保留・遮断の対象となった場合はゲートの応答を返して終了
  if (gate.intercepted) {
    return Response.json(gate, { status: gate.orderId ? 201 : 200 });
  }

  // 3. 人間の通常問い合わせはそのまま既存の処理を続行
  return handleNormalHumanInquiry(body);
}
```

### 2-3. 電話ゲート（Twilio Voice Webhook）＆ メールゲート（SendGrid / Mailgun / Cloudflare Email）
- **Twilio 着信 URL**：`POST https://your-parry-host.example.com/api/order/call` を Twilio 番号（または親のスマホの話中時転送先 050 番号）の Voice Webhook に設定するだけ。
- **Inbound Mail Webhook**：`POST https://your-parry-host.example.com/api/order/mail` を設定するだけ。

---

## 3. MCP（Model Context Protocol）で AI エージェントから直接使う

Claude Desktop / Cursor / Claude Code / Windsurf の MCP 設定（`claude_desktop_config.json` や `.cursor/mcp.json`）に以下を登録すると、AI に自然言語で指示するだけで組み込みコード生成・営業データの 1,000 円発注確定・TAPP 固定・公開インデックス管理がすべて実行できる。

```json
{
  "mcpServers": {
    "patriot": {
      "command": "node",
      "args": ["/Users/ecotech/Desktop/Patriot/src/mcp-server.mjs"],
      "env": {
        "PATRIOT_DB_PATH": "/Users/ecotech/Desktop/Patriot/patriot.db",
        "PATRIOT_BASE_URL": "http://localhost:3980"
      }
    }
  }
}
```

### MCP が提供するツール（8 本）
1. `patriot_generate_integration`：指定フレームワーク（`nextjs` | `cloudflare-workers` | `express` | `html` | `twilio`）向けの組み込みコード一式を生成
2. `patriot_submit_form_order`：フォーム営業データを判定し、1,000 円発注確定・TAPP Rekor 固定・自前請求書発行を実行
3. `patriot_submit_mail_order`：営業メールデータを判定・1,000 円発注確定・TAPP 固定を実行
4. `patriot_evaluate_call`：着信番号を 3 段制御（0 秒 `<Reject/>` ／ 個人の親見守り検疫 ／ 法人 AI テレアポ 1,000 円発注）で処理・TwiML 生成
5. `patriot_list_orders`：確定発注レコード一覧・リアルタイム統計カウンターを取得
6. `patriot_publish_overdue_order`：期日未入金の発注レコードを共有防衛インデックスへ掲載（`status='published'`、単調増加 `state_version` 検証付き）し JSON-LD を出力
7. `patriot_mark_order_paid`：1,000 円（税別）の入金確認時にステータスを `paid`（入金確認済）へ反転させ、共有防衛インデックスおよび 0 秒遮断フィードから即時除外して、隔離保管していた提案本文を本来の受付窓口へ引き渡す
8. `patriot_get_shared_index`：有料契約テナント向けの共有防衛インデックス（投影許可リスト限定・担当者個人名等の PII 除外・`payment_unconfirmed` 事実表記）および 0 秒遮断フィードを取得

---

## 4. 先に確かめて返す事（AI が実装前にユーザーへ聞く 4 項目）
1. 組み込みたい対象のフレームワークは何か（Next.js / Cloudflare Workers・Pages / Express / WordPress・静的 HTML）
2. 既存の問い合わせフォームのファイルパスと送信先 API エンドポイントはどこか
3. メールゲート（`patriot-mail`）および電話ゲート・親見守り（`patriot-call` / Twilio）も今回同時に繋ぐか、まずは Web フォームゲートから始めるか
4. エンジンは同一アプリ内に同居させるか（`createPatriotEngine` 直接呼び出し）、別ホストへ HTTP（`SafePatriot`）で投げるか

---

## 5. 票の切り方（AI が順番に実装するステップ）
- **票 P1（クライアントスクリプト設置）**：共通レイアウトまたはフォーム画面に `<script src="/trap.js" defer></script>` を設置し、見える有償受付案内と自動送信計測を有効化する。
- **票 P2（サーバー側ゲート接続）**：問い合わせ POST エンドポイントの先頭に `SafePatriot.inspectForm()`（または `engine.handleFormSubmission()`）を接続し、人間の通常送信が 100% 通過すること・有償受付同意送信が 201 で 1,000 円請求書 URL を返すことをテストする。
- **票 P3（請求書・AIO 公開インデックス確認）**：`/invoice/:orderId` と `/index`（JSON-LD 付き）および `/llms.txt` が表示され、評価語が 0 件であることをテストで固定する。
