Cardstream：オープンソースのライブ配信向けカードスキャナー

ライブコマースが急成長しており、高速で正確なライブ配信向けカードスキャナーは急速に欠かせないものになりつつあります。アナリストは、2026年の米国におけるライブコマースの売上高が前年比35%増で200億ドル近くに達すると予測しています。世界最大のライブコマースプラットフォームであるWhatnotは、2026年8月に200億ドルの企業評価額に達しました。コレクターズアイテムとトレーディングカードは、同社最大のビジネスです。

一般的なカードのライブ配信番組はシンプルです。販売者はカメラの前でパックを開封し、各カードを掲げて視聴者にカード名を伝えます。時には価格の査定も行います。多くの販売者はこれを記憶を頼りに行うか、手を止めてカードを調べます。これには時間がかかり、間違いも発生します。配信を見ているコレクターは、すべての詳細情報や価格データを迅速に知りたがっています。

だからこそ私たちは、コンピュータビジョンを活用した、オープンソースのライブ配信向けリアルタイム・カード認識ツール「Cardstream」を開発しました。このツールはベータ版であり、私たちは継続的に改善を行っています。本記事では、その機能と開始方法について紹介します。

Cardstreamとは？

Cardstreamは、お使いのコンピュータ上で動作する小さなアプリケーションです。カメラをカードに向けると、カードがフレームに入った瞬間にCardstreamがその名称、セット名、信頼度を返します。

結果が出るまでに要する時間は約0.5秒です。スキャンボタンもアップロードも不要です。代わりに、アプリは映像から直接カードを継続的にスキャンするように設計されています。

当社のCollectibles Recognition APIが識別処理を担当します。Cardstreamが呼び出すのは、カードゲーム（TCG）用とスポーツカード用の当社の識別エンドポイントであるTCG IDとSport Card IDです。それ以外の処理（映像内でカードを見つけ、APIを呼び出すタイミングを判断する処理）は、すべてお使いのコンピュータのCPU上でローカルに動作します。GPUは必要ありません。

スキャン対象：TCGとスポーツカード

Cardstreamは当社のAPIと同じカテゴリをサポートしています。配信中であっても、設定でカテゴリを切り替えて別のゲームをスキャンすることができます：

• トレーディングカードゲーム（TCG）：ポケモン、マジック：ザ・ギャザリング（MTG）、遊戯王、ONE PIECE、ロルカナを含む15以上のゲーム
• スポーツカード（近日対応予定）：野球、バスケットボール、アメリカンフットボール、アイスホッケー、サッカー、総合格闘技（MMA）

すべてのカードで取得できる情報

当社の識別システムは世界最高であると考えており、継続的に拡張を行っています。すべてのカードにおいて、以下の情報を取得できます：

• カード名および正式名称
• セット名、セットコード、カード番号
• シリーズ名、発行年
• 特徴の信頼度レベル（High、Medium、Low）
• TCGplayer、eBay、Scryfallなどのマーケットプレイスへのリンク
• その他の一致候補（最大4件）
• グレーディング済みと未鑑定の販売データに分けた価格統計情報

英語やその他のラテン文字表記の言語に加え、Cardstreamは韓国語、タイ語、日本語、中国語のカードも認識します。また、フォイル加工やホロ加工などの視覚的な特徴や、カードがサイン入りかどうかもフラグで示します。全リストについてはFeaturesページをご覧ください。

グレーディングスラブ：PSA、BGS、CGCなど

パック開封の配信者は数多くのグレーディング済みカードを披露しますが、Cardstreamの背後にある認識サービスはそれらも読み取ることができます。

OCRを使用して、PSA、Beckett、CGC、SGCなどのスラブのラベルから鑑定会社、グレード、証明番号を抽出し、保存や表示が可能な構造化データとして返します。

オープンソースとセルフホスト

Cardstreamのベースはオープンソースであるため、別の識別システムへの独自のコネクタを作成して大幅にコストを削減することも可能です。コードはApache-2.0ライセンスのもとでGitHub上に公開されており、インストーラーが一緒に取得する検出モデルも同じライセンスでカバーされています。

セルフホストとは、パイプライン全体がご自身で管理するハードウェア上で実行されることを意味します。APIキー、映像データ、カードデータはお客様自身のマシン内に保持されます。環境に合った方法でインストールしてください：

• 仮想環境をセットアップしてモデルの重みファイルをダウンロードする1行のインストールスクリプト
• PyPIからのリリースホイール：pip install 'cardstream[client,onnx]'
• ソースからのクローンおよびビルド（DockerおよびWindowsビルドに対応）

フレーム単位ではなく、カード1枚につき1回のAPI呼び出し

Cardstream自体は無料です。識別呼び出しの費用のみが発生し、それも識別処理にXimilar Collectibles Recognitionを選択した場合に限られます。

秒間15フレームの場合、ライブ配信では1時間に54,000フレームが生成されます。1フレームずつAPIに送信するには数が多すぎ、コストもかかりすぎます。Cardstreamはお使いのコンピュータ上で小さなステートマシンを実行し、最後のステップのみが外部APIを呼び出します：

1. Detect – ローカルモデルがカードを検出し、きれいに切り抜きます。API呼び出しはありません。
2. Wait – モーションゲートが、カードの動きが止まるまで待機します。API呼び出しはありません。
3. Compare – 簡易チェックにより、前のカードと同じカードであるかどうかを判断します。API呼び出しはありません。
4. Identify – 完全に新しいカードのみがXimilarに送信されます。呼び出しは1回のみです。

新しいカード1枚につき1回の呼び出し、それだけです。一般的な配信番組では、54,000回ではなく1時間あたり約100回の呼び出しとなります。1回の識別あたり10クレジットとすると、一晩のパック開封配信全体のコストは数千クレジットで収まります。

Whatnot、eBay Live、Twitch、YouTubeでカードスキャナーを使用する方法

Cardstreamが読み取るのは映像フィードだけです。マーケットプレイスへのログインも、APIキーも、チャット内のボットも必要ありません。いかなるマーケットプレイスや配信プラットフォームとも提携していませんが、Whatnot、Fanatics Live、eBay Live、TikTok Shop、Twitch、YouTube Liveなど、すべてのプラットフォームで同じように動作します。配信映像に向けるだけで、表示されたカードを順次識別します。

カメラをカードに向けた瞬間に、Cardstreamはその詳細な識別情報と価格統計情報を提供します。スラブのラベルは別途読み取られます。

接続には3つの簡単な方法があります：

• OBS仮想カメラ。OBSから配信を行う場合は、仮想カメラを起動します。Cardstreamは通常のウェブカメラと同じようにシーンを読み取ります。
• OBSからの第2出力。OBSがRTMPまたはSRT経由で配信のコピーをCardstreamに送信します。視聴者には以前とまったく同じ映像が表示されます。
• 卓上カメラ。スマートフォンからライブ配信を行う場合は、カードを公開する場所の上にウェブカメラまたはIPカメラを配置します。

起動すると、以下の機能を利用できます：

• リアルタイム識別 – 各カードが表示されると同時にカード名、セット名、信頼度が表示され、視聴者にそのまま読み上げることができます。
• 継続的な履歴 – すべてのカードが画面に表示されていた時間とともに一覧表示されるため、パック開封の記録が自動的に作成されます。
• ステップバイステップガイド – ライブ販売ガイドで、すべての方法を解説しています。
• 1回限りのセットアップ – 約15分で完了します。

約15分でスキャンを開始

導入は迅速に行えます。必要なものは、Cardstreamアプリ、カメラまたはOBSシーン、識別呼び出し用のXimilarアカウントの3つだけです。

1. Cardstreamをインストールし、APIトークン（Ximilar Appにログイン後に取得できる一意の識別子）でサインインします。
2. 映像を接続します：OBS仮想カメラ、OBSの第2出力、または卓上のウェブカメラ。
3. 設定でゲームまたはカードのカテゴリを選択します。
4. 配信を開始します。サイドパネルにはカードを提示するたびにその名称が表示され、履歴パネルには後から出品処理に再利用できるログが保存されます。

1つのセットだけを扱う場合は、エンドポイントが推測しなくて済むように、あらかじめ指定しておきます：

cardstream-web --game Pokemon --set-code CRI --alphabet latin --price-stats

Cardstream Cloud – 配信のレポートとアナリティクス

Cardstreamは、カードを1枚ずつ識別するだけでなく、セッション全体のレポートを作成することもできます。フラグを1つ有効にするだけで設定できます：

cardstream-web --game Pokemon --alphabet latin --price-stats --ximilar-stream NEW

これによりXimilar Platform上に新しいセッションが作成され、配信からのすべてのスキャンが自動的に記録されます。

セッションダッシュボードには、最も価値の高い商品、最も頻繁にスキャンされたセット、カードの総価値、および使用された有料API呼び出し回数が表示されます。

現在はベータ版、リリースごとに進化

この記事の執筆時点で、Cardstreamはベータ版です。私たちはテスト、デフォルト設定の調整、モデルの再学習、ガイドや機能の追加を継続的に行っています。

皆様からのフィードバックが、私たちが次に構築するものを形作ります。カードのライブ販売を行っている方は、ぜひ試してみて不足している点をお知らせください。GitHubでIssueを作成するか、右下のライブチャットまたはお問い合わせフォームからご連絡ください。インストールし、カメラをカードに向けて、ライブ配信を始めましょう。

よくある質問

Cardstreamは、Whatnot用のカードスキャナーとして使えますか？

はい。Whatnotのライブ配信に向けると、Whatnotのオークション中に各カードをスキャナーと同じようにリアルタイムで識別します。読み取るのは配信映像だけなので、Whatnotにログインすることはなく、同プラットフォームとの提携関係もありません。

Cardstreamはカードの価格を表示したり、カードをグレーディングしたりできますか？

Cardstreamは、認識したカードごとに価格統計とマーケットプレイスへのリンクを表示し、スラブのラベルからグレードを読み取ることもできます。ただし、価格スナイピングツールではなく、未鑑定のカードを自らグレーディングすることもありません。このアプリが教えてくれるのはカードが何であるかであり、いくらで入札すべきかではありません。

Cardstreamは無料のアプリですか？

このアプリはオープンソースで、Apache-2.0ライセンスのもと無料で利用できます。費用が発生するのは識別呼び出しの分だけで、それも識別処理にXimilar Collectibles Recognitionを使用する場合に限られます。