Web Intel

Web Intel MCP

従量課金制の MCP サーバーで、エージェント向けのウェブインテリジェンスを提供します。ライセンスとクレジットの管理には KeyFlint を使用します（オフライン Ed25519 ライセンスチェック＋クレジット台帳）。ここでは課金バックエンドとしてのみ使用します。取得に失敗した場合は自動的に返金され、無効な入力は課金前に拒否されます。

ツール	クレジット	返される内容
read_url	1	クリーンな Markdown 形式のメインコンテンツ（ナビゲーション、フッター、Cookie バナーを除去）
page_metadata	1	タイトル、説明、canonical、lang、robots、Open Graph、JSON-LD のタイプ、H1～H3、画像 alt の統計情報
extract_links	1	アンカーテキスト付きの重複を除いた内部／外部リンク
tech_stack	2	フレームワーク、CMS、アナリティクス、決済、CDN／ホスティング、セキュリティヘッダー
seo_audit	3	0～100 のスコア、A～F の評価、重み付けされた 16 項目のチェック、優先度の高い修正点 5 件
compare_seo	3 x URLs	2～5 ページ（自社と競合他社）を順位付けします。課金されるのは取得した URL のみです
pricing, credits_balance	無料	料金表、残りのクレジット

料金は上書きできます：WEB_INTEL_PRICES="seo_audit=5,read_url=2"。

インストール

必要なのは KeyFlint ライセンス（LIC-...）だけです。ゲートウェイ URL、公開鍵、チェックアウトリンクにはデフォルト値が設定されています。

Claude Desktop、ワンクリック： 最新リリースから web-intel-mcp-X.Y.Z.mcpb をダウンロードし、ダブルクリックしてライセンスを貼り付けます。ターミナルも JSON も不要です。

Claude Code：

claude mcp add web-intel -e KEYFLINT_LICENSE=LIC-... -- uvx web-intel-mcp

Cursor、Windsurf、Claude Desktop（JSON）：

{
  "mcpServers": {
    "web-intel": {
      "command": "uvx",
      "args": ["web-intel-mcp"],
      "env": { "KEYFLINT_LICENSE": "LIC-..." }
    }
  }
}

オプション：KEYFLINT_URL、KEYFLINT_PUBLIC_KEYS（未設定の場合、ゲートウェイから取得して ~/.keyflint/keyring.json にキャッシュされます）、KEYFLINT_CHECKOUT_URL。

ビジュアルカード（MCP Apps）

Claude、ChatGPT、VS Code、Goose では、すべての有料ツールと credits_balance がチャット内でインタラクティブなカードとして表示されます。クレジット残高と補充バー、購入ボタン、または結果の概要（主要な数値、問題点、テーブルのプレビュー、課金されたクレジット）が表示されます。これはネットワークアクセスなしで動作する、自己完結型の ui://web-intel/card.html リソースです。その他のクライアントには、従来どおり同じ JSON が返されます。

ホストモード（販売者向け）

有料ロジックはサーバー上に保持されます。1 つのプロセスで複数の購入者に課金し、各リクエストには購入者のライセンスが含まれます。

docker build -t web-intel .
docker run -p 8080:8080 \
  web-intel

購入者は https://<host>/mcp（ステートレスな Streamable HTTP）に Authorization: Bearer LIC-...（または X-License-Key）を指定して接続します。ライセンスがない場合、または偽造された場合は -32060 が返されます。

呼び出しごとの課金フロー

1. URL を検証します（http／https のみ）。入力が不正な場合はエラーとなり、課金されません。
2. オフライン Ed25519 ライセンスチェック（keyflint-verify）を行い、60 秒間キャッシュします。
3. 新しい冪等性キーを使って POST /api/v1/quota/deduct を実行します。クレジットが不足している場合は、チェックアウトリンクとともに -32062 が返されます。
4. 取得と分析を行います。何らかの失敗が発生した場合は POST /api/v1/quota/refund（同じキー）を実行し、クライアントには isError が返されます。

安全性

プライベート、ループバック、リンクローカルのアドレスへのリクエストは拒否されます（リダイレクトの各段階でチェックします）。レスポンスは 3 MB（WEB_INTEL_MAX_BYTES）、タイムアウトは 15 秒（WEB_INTEL_TIMEOUT）、リダイレクトは最大 5 回です。 WEB_INTEL_ALLOW_PRIVATE=1 を指定すると、アドレスチェックが無効になります（テスト専用）。

テスト

偽の KeyFlint クォータゲートウェイ、ローカルで署名したライセンス、ローカルのテストサイトを使ったエンドツーエンドテストです （ネットワークは不要です）。

pip install -e ".[test]"
python -m pytest -q

ライセンス

Business Source License 1.1。ソースコードは入手可能です。商用環境での使用には KeyFlint ライセンスが必要です（または非商用である必要があります）。各バージョンはリリースから 4 年後に Apache 2.0 に移行します。LICENSE を参照してください。