ANIME INTELLIGENCE / AI PURCHASE INTELLIGENCE

ANIME INTELLIGENCE / AI PURCHASE INTELLIGENCE

バージョン 3.10.2

本番 MCP エンドポイント：

https://anime-intelligence.goodmy0312.workers.dev/mcp

本番 API ベース URL：

https://anime-intelligence.goodmy0312.workers.dev

リポジトリ：

io.github.Mike05102/anime-intelligence-mcp

---

概要

ANIME INTELLIGENCE / AI PURCHASE INTELLIGENCE は、自律型 AI エージェント向けに設計された MCP ＋ API ＋ x402 のコマースインテリジェンスサービスです。

現在、このサービスには主に次の 3 つの機能グループがあります。

1. アニメ／コレクターズアイテムの購入インテリジェンス
2. 工業用、交換用、製造終了部品向けの PARTS INTELLIGENCE
3. より大規模な商品市場向けの汎用コマース検索

トラベルアダプターもコードベースに含まれていますが、プロバイダーの認証情報が設定されるまでは、ライブの旅行商品在庫は無効のままです。

このサービスは、次の技術を基盤としています。

• Cloudflare Workers
• Supabase
• MCP
• OpenAPI
• x402
• Solana USDC
• Yahoo Shopping 連携
• eBay Browse 連携
• Rakuten アフィリエイト経由のルーティング
• 公開されている加盟店／購入ページ

設計目標は、AI エージェントが複数の情報源から人手で情報を集めなくても、次の流れを実行できるようにすることです。

検索 → 特定 → 評価 → 判断 → 販売者を選択 → インテリジェンスの料金を支払う → 購入手続きに引き継ぐ

---

1. アニメ／コレクターズアイテムのインテリジェンス

ANIME INTELLIGENCE の元となるエンジンは、日本の物理的なアニメ関連コレクターズアイテムに焦点を当てています。

対応している商品カテゴリーは次のとおりです。

• スケールフィギュア
• ねんどろいど
• figma
• プライズフィギュア
• ぬいぐるみ
• アクリルグッズ
• キーホルダー
• バッジ
• プラモデル
• トレーディングカード
• コラボアパレル
• コラボスニーカー
• その他の物理的なアニメ関連グッズ

このシステムは、次のような特定が難しい問題に対応できるよう設計されています。

• 同じキャラクターの複数のエディション
• 再販
• メーカーの違い
• 日本語限定の商品名
• JAN／EAN の違い
• プライズ版と一般販売版の違い
• 販売者による商品タイトルのノイズ
• 情報が不完全なマーケットプレイスの出品
• 複数言語で曖昧な検索クエリ

このサービスは、より価値の高い購入インテリジェンスを返す前に、正規の商品を特定します。

---

無料のアニメ検索

GET /v1/search

例：

/v1/search?query=Hatsune%20Miku

正確な商品がまだ分からない場合は、候補の検索に使用してください。

---

2. 有料のアニメ x402 インテリジェンス

有料エンドポイントでは、x402 を介して Solana USDC を使用します。

現在の有料エンドポイント：

エンドポイント	目的	価格
/v1/identify	商品／エディションの正確な特定	0.005 USDC
/v1/market	現在の市場価値／価格の状況	0.01 USDC
/v1/rarity	希少性と再販リスク	0.01 USDC
/v1/authenticity	偽造品／出品内容の不一致リスク	0.02 USDC
/v1/buy-wait	BUY／WAIT／WATCH／AVOID の判断	0.02 USDC
/v1/best-place	現在最適な購入ルート	0.03 USDC
/v1/listing-match	出品商品と正規商品の照合	0.01 USDC
/v1/deadline	予約注文／抽選／購入期限	0.01 USDC
/v1/landed-cost	購入者の国を考慮した着地価格	0.02 USDC
/v1/price-history	過去の価格の状況	0.02 USDC
/v1/full-intelligence	コレクターズアイテムの購入判断に関する完全なインテリジェンス	0.05 USDC
/v1/shopping-intelligence	エージェント向けの購入推奨	0.05 USDC

可能な場合、このサービスは支払いの前に商品を特定するため、エージェントが間違った商品に対して支払わずに済みます。

---

x402 の支払いフロー

1. エージェントが支払いの証明なしで有料エンドポイントを呼び出します。
2. サーバーが HTTP 402 を返します。
3. エージェントが PAYMENT-REQUIRED レスポンスヘッダーを読み取ります。
4. エージェントが必要な Solana USDC の支払いを作成します。
5. エージェントが PAYMENT-SIGNATURE を付けて、まったく同じ URL に再度リクエストします。
6. 互換性のため、X-PAYMENT もエイリアスとして使用できます。
7. 検証と決済が完了すると、エンドポイントは HTTP 200 を返します。
8. 成功したレスポンスには PAYMENT-RESPONSE が含まれます。

現在の x402 ネットワーク：

• Solana メインネット
• USDC
• x402 v2

---

3. PARTS INTELLIGENCE

バージョン 3.10.x では、2 つ目の専門情報ビジネスが追加されます。

PARTS INTELLIGENCE

産業用部品、交換部品、保守部品、廃番部品、調達困難な部品を対象としています。

カテゴリの例：

• PLC
• センサー
• リレー
• スイッチ
• サーボモーター
• サーボアンプ
• インバーター
• 電源
• 空圧部品
• シリンダー
• バルブ
• ベアリング
• モーター
• コネクター
• 産業用制御部品
• 機械の交換部品
• 家電／サービス部品
• カメラ部品
• オーディオ部品
• 工具部品
• IT／サーバーの交換部品

商業的な価値は、次のような疑問を解決することから生まれます。

• この部品の正確な型番は何ですか？
• 廃番になっていますか？
• 後継品は何ですか？
• 検証済みの代替品はありますか？
• 候補品に本当に互換性がありますか？
• この関係を裏付ける公式文書はどれですか？
• 元の部品はまだ入手できますか？
• 最適な調達方法は何ですか？

---

PARTS データモデル

PARTS INTELLIGENCE では、システムの記録管理に Supabase を使用します。

主なテーブル：

parts_catalog

正規化された部品の識別情報です。

主なフィールド：

• メーカー
• ブランド
• 部品番号
• 正規化された部品番号
• 名称
• カテゴリ
• ライフサイクル状況
• 廃番日
• 後継部品番号
• 仕様
• 寸法
• 電気的特性
• 機械的特性
• 公式 URL
• ソースの信頼度

parts_relations

部品間の明示的な関係です。

対応する関係タイプ：

• successor
• substitute
• compatible
• incompatible
• used_in

このテーブルは、サービスの最も重要な資産の 1 つです。

parts_documents

根拠資料と公式参照文書です。

例：

• 公式 PDF
• カタログ
• マニュアル
• データシート
• 仕様書
• 交換品一覧
• 互換性に関する注記

parts_offers

確認された調達情報です。

例：

• 販売業者
• 価格
• 通貨
• 状態
• 在庫状況
• URL
• 確認日時

parts_sources

設定済みのメーカー公式情報源です。

初期ソースレジストリには、以下が含まれます。

• OMRON
• Mitsubishi Electric
• SMC
• IDEC
• Panasonic Industry
• Yaskawa
• Oriental Motor
• THK
• NSK
• Azbil

---

PARTS 互換性ポリシー

PARTS INTELLIGENCE では、次のような理由だけで互換性があると推測することはありません。

• 製品名が似ている
• 寸法が似ている
• 型番が似ている
• マーケットプレイスの販売者が互換性を主張している

代替品／互換性を肯定的に推奨するには、根拠資料で裏付けられた明示的な関係レコードが必要です。

未検証の候補は別途返されます。

これは、安全性とデータ品質を確保するための意図的なルールです。

---

PARTS エンドポイント

GET /v1/parts/status

PARTS データベースと取り込みの状況を返します。

GET /v1/parts/search

部品を自由検索します。

例：

/v1/parts/search?part_number=E2E-X5ME1

または：

/v1/parts/search?query=OMRON%20sensor

GET /v1/parts-intelligence

有料の PARTS インテリジェンス全機能です。

価格：

0.05 USDC

通常、次の情報が出力に含まれます。

• 正規化された部品の識別情報
• ライフサイクル状況
• 廃番状況
• 後継品の関係
• 検証済みの代替品との関係
• 未検証候補との関係
• 非互換性の根拠
• 公式文書
• 調達情報
• 購入／調達に関する判断

---

4. v3.10.2 の PARTS 取り込みモード

バージョン 3.10.1 には、より大規模なメーカーサイト自律クローラーが含まれていました。

バージョン 3.10.2 では、デプロイサイズとランタイムの複雑さを抑えるため、このクローラーを Cloudflare Worker のランタイムから意図的に削除しています。

現在の取り込みモード：

Supabase bulk import + admin upsert

これにより、本番環境の Worker をより小さく、安定した状態に保ちます。

初期目標：

• 数千件の高品質な部品
• 次に、価値の高い FA／産業用部品を約 10,000 件
• その後、メーカーとカテゴリを拡大

PARTS のコア機能に新たな外部ベンダー API キーは必要ありません。

既存の Yahoo／eBay 統合は、必要に応じて調達情報の拡充に利用できます。

---

PARTS データベースのセットアップ

次を実行します。

PARTS_INTELLIGENCE_v3_10_2_SCHEMA.sql

既存の Supabase SQL Editor で一度実行してください。

このスキーマにより、以下が作成されます。

• parts_catalog
• parts_relations
• parts_documents
• parts_offers
• parts_sources
• parts_ingest_runs

また、初期の公式メーカーソースレジストリも登録されます。

---

5. 汎用コマース検索

このサーバーは、より汎用的な AI 購入インテリジェンスレイヤーも提供します。

POST /v1/commerce/search

現在、以下のドメインに対応しています。

• consumer_electronics
• automotive_parts
• enterprise_procurement
• mro_and_industrial_components
• electronic_components

現在のプロバイダー連携では、設定済みの既存コマースソースを再利用します。

---

識別情報のガード

ドメインごとに異なるレコメンデーションルールを使用します。

家電

汎用的な市場検索が可能です。

自動車部品

レコメンデーションの前に、正確な OE／MPN／部品番号が必要です。

エンタープライズ調達／MRO／電子部品

レコメンデーションの前に、正確なメーカー品番が必要です。

このサービスでは、広範なキーワードの類似性だけを根拠として、技術的に互換性のない部品を推奨しないようにしています。

---

6. 旅行アダプター

旅行関連のコードは引き続き Worker に含まれています。

現在のアーキテクチャは、以下に対応しています。

• Booking.com Demand
• Duffel
• Expedia Rapid
• Amadeus アダプタースロット

現在の本番環境のステータス：

awaiting_credentials

次のエンドポイントでプロバイダーが設定済みと報告されない限り、そのプロバイダーは稼働中とは見なされません。

GET /v1/travel/status

これらのプロバイダーには外部 API 認証情報が必要なため、現在、このサービスでは旅行を重点対象としていません。

---

7. MCP

MCP エンドポイント：

https://anime-intelligence.goodmy0312.workers.dev/mcp

このサーバーは Streamable HTTP MCP に対応しています。

関連するツールは以下のとおりです。

• search_anime_product
• 有料のアニメインテリジェンスツール
• record_purchase_intent
• commerce_search
• parts_search
• parts_intelligence
• parts_status
• 旅行関連ツール

MCP メタデータは、AI エージェントが以下を理解できるように設計されています。

• ツールを使用するタイミング
• ツールが有料である理由
• 予想される出力
• x402 の支払い動作
• 識別情報の要件
• 互換性の制限

---

8. OpenAPI とディスカバリー

OpenAPI：

/openapi.json

LLM が読み取れるサービスの説明：

/llms.txt

x402 ディスカバリーメタデータ：

/.well-known/x402

MCP ディスカバリーメタデータ：

/.well-known/mcp.json

エージェントプロフィール：

/agent/profile

エージェントサービス：

/agent/services

ヘルス：

/health

---

9. 公開購入ページ

Rakuten のアフィリエイト URL は、API レスポンスを通じて直接再配布されません。

代わりに、API は ANIME INTELLIGENCE がホストする公開商品ページを返すことができます。

URL の形式例：

/shop/product/<canonical-product-id>

公開ページには、人が読めるメディアコンテキスト内に、販売業者へのルーティングやアフィリエイトリンクを含めることができます。

この分離により、機械向けのインテリジェンスと販売業者向けのアフィリエイトルーティングの曖昧さを軽減できます。

---

10. テレメトリと KPI

このサービスは、Supabase にコンバージョンテレメトリを記録します。

重要な x402 ファネルイベントは以下のとおりです。

• API リクエスト
• 正規商品選択
• x402 ゲートへの移行
• 支払いチャレンジの発行
• 支払い再試行の受信
• 支払い試行
• 支払い確認
• 有料呼び出し
• 決済成功
• 決済失敗

重要なコマースイベントは以下のとおりです。

• 購入意向の作成
• 販売業者の選択
• 購入 URL の提供
• アフィリエイトクリック
• チェックアウト開始
• 購入確定

---

外部収益 KPI

システムでは、以下を区別します。

• 実際の外部商業トラフィック
• クローラー／モニター
• 管理者テスト
• 既知のセルフテスト
• コンテキストのない合成プローブ

重要な目標 KPI は以下のとおりです。

confirmed_external_shopping_intent_calls > 0
external_canonical_product_selected > 0
payment_retry_received > 0
external_payment_attempts > 0
external_payment_verified > 0
external_paid_calls > 0
external_revenue_usdc > 0

運営者自身のウォレットからの自己決済は、外部商業収益として扱わないでください。

---

11. ヘルスチェック

本番環境のヘルスエンドポイント：

https://anime-intelligence.goodmy0312.workers.dev/health

正常なデプロイでは、現在、以下が報告されるはずです。

{
  "ok": true,
  "version": "3.10.2",
  "supabase": "ok"
}

PARTS のステータスでは、以下が報告されるはずです。

active_supabase_core

また、以下も報告されるはずです。

new_external_api_keys_required: false

---

12. デプロイ

本番環境のメインファイル：

ANIME_INTELLIGENCE_v3_10_2_FULL_WORKER.txt

デプロイのワークフロー：

1. Cloudflare Worker エディターを開きます。
2. 既存の Worker 全体を新しい Worker ファイルに置き換えます。
3. デプロイします。
4. /health を確認します。
5. version = 3.10.2 を確認します。
6. 同じ Worker のソースを GitHub の worker.js にコピーします。
7. server.json を置き換えます。
8. README を置き換えます。
9. MCP Registry のワークフローが成功することを確認します。

---

13. Supabase

このプロジェクトでは、既存の Supabase 環境と認証情報を使用します。

PARTS INTELLIGENCE では、追加のデータベースアカウントは必要ありません。

Worker は現在の Supabase の service-role／secret 設定を再利用します。

匿名でのデータベース書き込みポリシーは必要ありません。

---

14. 現在の本番環境のステータス

v3.10.2 時点：

• Cloudflare Worker：稼働中
• Supabase：稼働中
• アニメインテリジェンス：稼働中
• x402：稼働中
• MCP：稼働中
• OpenAPI：稼働中
• PARTS INTELLIGENCE のコア：稼働中
• PARTS の外部 API キー要件：なし
• 汎用コマース検索：既存のプロバイダー認証情報が設定されている場合に稼働中
• 旅行：アダプターコードは存在しますが、稼働中のプロバイダーは未設定
• 自律型 PARTS クロール：Worker では無効
• PARTS の一括登録：Supabase インポート／管理者による upsert

---

15. 現在の優先事項

次の成長フェーズでは、PARTS データベース自体を構築します。

優先順位：

1. 数千件の正規化された産業部品を登録する
2. メーカーと部品番号の識別情報を正規化する
3. 公式ドキュメントを関連付ける
4. ライフサイクル／製造終了のステータスを追加する
5. 検証済みの後継品の関係を追加する
6. 検証済みの代替品／互換性の関係を追加する
7. 調達に関する観測情報を追加する
8. 価値の高いレコードを約10,000件まで増やす
9. 得られたインテリジェンスを MCP と x402 を通じてさらに提供する

長期的な資産は、部品の数だけではありません。

最も価値の高いデータは、根拠に裏付けられた関係グラフです。

part → successor
part → verified substitute
part → incompatible alternative
part → machine / equipment usage
part → official document
part → current sourcing option

この関係グラフによって、PARTS INTELLIGENCE は単なる検索インデックスから、有料の意思決定インテリジェンスへと変わります。