NorthCinderの機能
NorthCinderは、購入者が定義した条件に基づいて商品を比較するAIショッピングエージェントを支援する、オープンソースのModel Context Protocolサーバーです。順位付きの候補リストを作成し、各商品がその順位になった理由を説明し、除外された選択肢を示し、どの店舗を検索したか、または検索しなかったかを報告します。
NorthCinderは、MCPに対応したAIアプリケーションとともに、コンピューター上で実行されます。リポジトリの所有者は、ホスト型のNorthCinderサービス、アカウントシステム、コントロールプレーン、テレメトリーサービスを運用していません。クライアントと集約エンジンを実行し、接続する店舗を選択し、ローカル設定と監査データを保持するのは利用者です。
中心的な設計原則は、購入者の条件が順位を決定することです。販売者からの支払い情報やアフィリエイト情報によって、商品の順位が上がることはありません。スポンサー付きの結果はスポンサー表示を維持し、オーガニック検索結果より下位に表示されます。
主な機能
- 購入者主導のランキング: 商品は、ショッピング条件に記載された要件に従って並べられます。
- 機械可読な説明: 各おすすめには、スコアと構造化された理由が含まれます。
- 除外結果の可視化: 必須条件を満たさない商品は、満たせなかった要件とともに報告されます。
- 店舗カバレッジの報告: 利用不能、ブロック済み、未設定の店舗も、暗黙に省略されず表示されます。
- 販売者信頼性の根拠: 各販売者には、明示的な裏付け証拠、または正直な「不明」状態が示されます。
- 維持されるラベル: スポンサー表示とソース表示は各商品に付いたままになります。
- ローカル検証: クライアントは、サービスが開示した入力に対して決定論的なランキングを再実行します。
- 管理されたチェックアウト: 自動チェックアウトには、正確な商品、数量、支出上限に紐付いた、署名済みかつ1回限りの承認委任が必要です。
- ローカル監査: おすすめ、承認、チェックアウト試行は、ローカル監査記録に書き込まれます。
ローカルでの再ランキングは、開示された入力から生成された順序を検証します。上流のカタログが完全であることや、店舗から提供されたすべての情報が正確であることを証明するものではありません。
前提条件
標準インストールには、Node.js 20以降と、MCPに対応したAIアプリケーションが必要です。個々の店舗連携では、追加のプラットフォームアクセス、認証情報、または設定が必要になる場合があります。
NorthCinderのインストールと初期設定
ステップ1: 初期化ツールを実行する
ターミナルを開き、次を実行します:
npx northcinder init初期化ツールがローカル設定を案内し、AIアプリケーションに必要なMCP設定を表示します。
ステップ2: MCP設定を追加する
初期化ツールに表示された設定を、AIアプリのMCP設定領域にコピーします。正確な場所と接続手順はアプリケーションによって異なるため、そのMCPドキュメントに従ってください。
ステップ3: AIアプリを接続または再起動する
設定を適用し、必要に応じてアプリケーションを再接続または再起動します。これでNorthCinderがローカルMCPサーバーとしてエージェントから利用できるようになります。
最初のショッピング条件を送信する
NorthCinderは、必須属性、予算、比較要素、説明の依頼を含む具体的な条件で最も効果を発揮します。例:
130ドル未満の黒いウール製ランニングシューズを探してください。価格、配送、フィット感、販売者の信頼性を比較してください。最終候補が1位になった理由と、どの選択肢が除外されたかを教えてください。
この条件により、色、素材、商品タイプ、最高価格などの必須条件が定まります。また、比較する要素をエージェントに伝え、勝者となった理由と除外された代替候補の両方を明らかにするよう求めています。
応答を確認する
最初の結果だけでなく、さらに確認してください。NorthCinderの応答には、次の内容が含まれる場合があります:
- 必須条件を満たす商品。
- 各おすすめのスコアと機械可読な理由。
- 除外された商品と、それぞれが満たせなかった具体的な要件。
- 販売者の信頼性に関する証拠、または証拠がないことを示す明確な表示。
- 店舗ごとのカバレッジレポート。
- すべての商品に付いたソース表示とスポンサー表示。
カバレッジレポートは特に重要です。店舗が利用できなかった、またはブロックされていた場合、返された候補リストを市場全体の完全な検索結果と解釈してはいけません。
検索と承認のワークフローを理解する
AIアプリはMCP経由でNorthCinderクライアントと通信します。クライアントは購入者が運用する検索サービスと通信し、そのサービスは設定済みの店舗アダプターを使用します。結果はクライアントに戻され、ローカルでの再ランキング、説明、監査が行われます。
検索や価格監視によって、購入の許可が与えられるわけではありません。自動チェックアウトの前に、NorthCinderは特定の購入に対する購入者の承認を必要とします。生成される委任は署名済みで1回限りのものであり、正確な商品、数量、支出上限に紐付けられます。プロセス間ノンス台帳により、委任の再利用が防止されます。
利用可能な連携によっては、承認された購入をチェックアウトレール経由で進めるか、カートを引き渡すことができます。カード情報の生データは拒否され、利用可能な場合、自動決済レールでは不透明な委任決済トークンが使用されます。
店舗カバレッジを設定する
店舗へのアクセス方法はプラットフォームによって異なります。実際のワークフローで利用する前に、各アダプターのドキュメントを確認してください。
- Shopify: カタログ検索を利用するには、追加のShopify設定が必要です。以前のストア単位の接続方式は、現在の方式ではありません。
- WooCommerce: 公開WooCommerce Store APIを提供しているストアで検索できます。
- eBay: ネイティブ検索には、承認済みのeBay Buy APIアクセスが必要です。
- Etsy: ネイティブ検索には、承認済みのEtsyアプリケーションアクセスが必要です。
- Amazon: 読み取り専用の比較には、管理下にあるブラウザープロファイルを使用できます。チャレンジが表示された時点で停止し、チェックアウトは実行しません。
ネイティブアクセスを利用できない場合、エージェントは、すでに管理しているブラウザーツールを使って、許可された商品ページを比較できます。NorthCinderは、これらの観察結果から正規化された商品情報を受け入れます。Cookie、生のHTML、スクリーンショット、ページ上の指示、パスワード、ワンタイムコード、AIプロバイダーのキーは受け取りません。
エージェントが観察したオファーは、ネイティブアダプターまたはマーチャントプロトコルによって確認されるまで、自動チェックアウトや無人監視には使用できません。
ソースからNorthCinderをビルドする
このリポジトリはpnpmワークスペースです。プロダクトパッケージにはNode.js 20以降が必要です。プライベートサイトワークスペースにはNode.js 22.12以降が必要です。
ステップ1：依存関係をインストールする
corepack pnpm install --frozen-lockfileステップ2：ワークスペースをビルドする
corepack pnpm buildステップ3：ローカル初期化処理を実行する
node northcinder/bin/northcinder.js initこのリポジトリには、オフラインビルド、型チェック、テスト、依存関係、シークレット、パッケージング、公開サーフェスの各チェックも含まれています。リリース検証用のコマンド全体については、CONTRIBUTING.mdを参照してください。
高度な利用のヒント
テスト可能な要件を書く
必須要件と希望条件を分けて記述します。たとえば、上限となる支出額と必須の商品属性を明確にし、その後に配送速度、適合性、販売者への信頼など、比較時のより緩やかな要素を列挙します。これにより、却下理由と順位付けの説明を監査しやすくなります。
勝者を信頼する前に対象範囲を監査する
どのアダプターが成功し、どれがブロックされ、どれが設定されていないかを確認します。NorthCinderは、こうした対象範囲の不足を意図的に可視化します。最上位のオファーは、開示され、正常に評価された入力の中での勝者であり、オンラインで利用可能なすべてのオファーの中での勝者とは限りません。
検証と完全性を区別する
クライアントは順位付けを決定論的に再実行し、開示された購入者の基準から受け取った注文が生成されたことを検証できます。これは、カタログが完全であることを検証するものでも、ストアが提供した情報が正しいことを保証するものでもありません。証拠の欠落や不明な信頼状態は、意味のある制約として扱ってください。
ブラウザーでの観察をその範囲内に保つ
ネイティブストアアダプターを利用できない場合、ブラウザー支援による比較が役立つことがあります。ただし、観察されたオファーは、無人監視や自動チェックアウトの前に、ネイティブまたはマーチャントプロトコルによる確認が必要です。Amazonのブラウザーベースの比較は読み取り専用で、チャレンジが表示された時点で停止し、チェックアウトは実行しません。
認証情報と決済データを保護する
AIプロバイダーのキーはAIアプリケーション内で管理し、ストアの認証情報は自分と対象ストアの間で管理してください。パスワード、ワンタイムコード、Cookie、生のカード情報をNorthCinderに渡さないでください。完全な境界については、リポジトリのプライバシーおよびソフトウェア所有権に関するドキュメントとセキュリティポリシーを確認してください。
プロジェクトの契約を確認する
より深い技術検証を行うには、リポジトリの順位付け仕様、妥当性中立性監査、アダプター契約、信頼仕様、チェックアウトパッケージ、クライアントソースを確認してください。これらの資料には、順位付けの中立性、スポンサー掲載、対象範囲の報告、信頼の証拠、購入指示、ローカル監査がどのように実装されているかが記載されています。
現在のプロジェクト状況
バージョン0.1.2は初回の公開リリースです。フィクスチャとハーネスによるカバレッジは、第三者の認証情報が現在有効であること、すべてのストアに本番環境でアクセスできること、または実際の購入が完了したことを証明するものではありません。連携を信頼する前に、該当するアダプターのドキュメントを確認してください。
このパッケージはまだ公式MCP Registryに掲載されておらず、リポジトリに含まれるマーケティングサイトも、正規の本番オリジンでは公開されていません。
結論
NorthCinderは、AI支援ショッピングのための、ローカルで検査可能な基盤を提供します。購入者が定義した順位付け、明示的な却下理由、可視化されたストアの対象範囲、販売者の信頼性に関する証拠、ローカル監査、購入ごとの承認を組み合わせています。まず初期化処理を実行し、生成されたMCP設定を接続して、具体的な依頼を送信してください。そのうえで、購入を承認する前に、順位付けの根拠と対象範囲の不足の両方を確認してください。