affiliate-router-mcp

affiliate-router-mcp

エージェントツール向けの、ベンダー中立な収益化ルーティングです。1 つの MCP サーバーで、有料 API、紹介リンク、アフィリエイトプログラムを通じた収益を検出、ルーティング、計測します。

ソース： https://github.com/forgemeshlabs/affiliate-router-mcp

このルーターは、特定の決済ネットワークやアフィリエイトシステムに依存しません。 アダプターはプラグイン形式で追加できます。レジストリは、ユーザーが管理するローカルの JSON ファイルです。

ステータス： 実験的 · v0.1.12

免責事項： この MCP は報酬の支払いを保証するものではありません。各ベンダー／プログラムのルールに従って、アトリビューションデータをルーティングします。報酬の分配はベンダーの決済システムによって行われ、このルーターでは行われません。

---

機能

エージェントが、あらゆるアフィリエイトや決済システムをハードコードせずに、収益化可能なツールを呼び出せるようにします。affiliate-router-mcp では、次のことができます。

• 検出 — カテゴリや目的に応じてベンダーや製品を検索します
• ルーティング — 適切な決済／アトリビューション経路を自動的に選択します
• 呼び出し — アフィリエイトアトリビューション付きで決済を実行します
• リンク生成 — 紹介 URL にトラッキングパラメーターを追加します
• テレメトリー — アトリビューション付きの呼び出しをすべてローカルに記録して追跡します

---

9 個のツール

ツール	コスト	説明
list_tools	無料	すべての x402 Router ツールと現在の価格を表示します — ウォレット不要で GET https://router.forgemesh.io/menu をそのまま取得します
search_opportunities	無料	カテゴリやキーワードで製品を検索します
list_affiliate_programs	無料	すべてのベンダーとそのプログラムを一覧表示します
get_opportunity_details	無料	特定のベンダー／製品の詳細を表示します
get_best_route	無料	目的に応じた最適な経路を提案します
generate_affiliate_link	無料	トラッキング付きの紹介 URL を作成します
call_affiliate_product	変動	アトリビューション付きで製品への支払いと呼び出しを行います
estimate_commission	無料	呼び出し量に基づいて月間収益を予測します
get_affiliate_telemetry	無料	ローカルのアトリビューションログを表示します

---

アダプター

決済システムまたはアトリビューションシステムごとに、個別のアダプターを使用します。新しいアダプターを追加しても、既存のアダプターには影響しません。

アダプター	仕組み	決済	ステータス
x402_direct	Coinbase facilitator を介した EIP-3009 transferWithAuthorization	ベンダーにオンチェーンで USDC を送金	テスト済み
referral_link / query_param_link	URL にアフィリエイトパラメーターを追加します。optional_params（例：VIN）と、変更してはならないトラッキング済み URL 用の fixed_link モードをサポートします	なし — プログラムによります	実装済み
awin_link	ベンダーの awinmid／awinaffid を使い、製品の destination_url を Awin の cread.php リダイレクト経由にします	なし — プログラムによります	実装済み

このルーターは、特定の決済ネットワークやアフィリエイトシステムに依存しません。今後、PartnerStack、Rewardful、Impact、Commission Junction、クーポン／プロモーションコードの挿入、API キーを使うパートナープログラム、その他の新しいエージェントコマースプロトコル向けのアダプターが追加される可能性があります。

---

インストール

npm install -g affiliate-router-mcp

または、Claude Code／任意の MCP クライアントで使用します。

{
  "mcpServers": {
    "affiliate-router": {
      "command": "affiliate-router-mcp",
      "env": {
        "WALLET_PRIVATE_KEY": "0x...",
        "GUMROAD_AFFILIATE_ID": "your-gumroad-id"
      }
    }
  }
}

---

要件

• Node.js 18 以降。さらに、有料の呼び出しには残高を少額に抑えた専用の Base ウォレット（WALLET_PRIVATE_KEY）が必要です。無料ツールにはウォレットは不要です。
• 支出上限：call_affiliate_product は adapters/x402-direct.js に記載された CoinOpAI の送金先のみに支払いを行い、それ以外の支払先、Base mainnet 以外のネットワーク、USDC 以外の資産、組み込みの 1 回あたりの上限（$0.15 および $0.10）、またはセッションあたり $10 の予算を超える金額については署名を拒否します。環境変数 X402_MAX_PRICE_USD と X402_SESSION_BUDGET_USD では、上限を引き下げることはできますが、引き上げることはできません。残高を少額に抑えた専用ウォレットを使用してください。

環境変数

変数	必須	備考
WALLET_PRIVATE_KEY	x402 アダプターで call_affiliate_product を使用する場合	USDC とガス代用の ETH があるベースウォレット
X402_MAX_PRICE_USD	いいえ	1 回あたりの支払い上限を引き下げます（引き上げることはありません）
X402_SESSION_BUDGET_USD	いいえ	セッションあたりの支払い予算を引き下げます（引き上げることはありません）
GUMROAD_AFFILIATE_ID	いいえ	Gumroad のトラッキング ID
PARTNERSTACK_CODE	いいえ	PartnerStack の紹介コード

---

対応ベンダー

CoinOpAI（x402_direct）— Base メインネット上の暗号資産インテリジェンス API

• Kronos Signals — 1 回あたり $0.05
• Kronos Decision — 1 回あたり $0.15
• Trade Preflight — 1 回あたり $0.05
• Trade Audit — 1 回あたり $0.07
• 画像生成 — 1 回あたり $0.10

Gumroad（referral_link）— デジタル製品マーケットプレイス。製品ごとに約 30％のコミッション

PartnerStack（referral_link）— SaaS アフィリエイトプログラム

• ElevenLabs — AI 音声／TTS。12 か月間、支払い額の 22％（fixed_link、追加パラメーターなし）

Ledger（referral_link、fixed_link）— ハードウェアウォレット。コミッション 10％

• Nano X、Nano S Plus、Stax — トラッキング情報を組み込んだ製品別のディープリンク

DigitalOcean（awin_link）— クラウドホスティング。12 か月間、継続コミッション 10％、Cookie の有効期間は 30 日

• ホームページ、Droplets の料金ページ — Awin の cread.php を介してラップされています

Amazon Influencer Storefront（referral_link、fixed_link）— ai_tinkers のストアフロント。標準の Associates 報酬率。製品別のタグ付けには対応していません

ForgeMesh Vehicle History Reports（referral_link）— トラッキング付きの forgemesh.io/go/ リダイレクト。販売ごとに 25％

• EpicVIN、Detailed Vehicle History — VIN を事前入力するには、generate_affiliate_link に extra_params: {vin: "..."} を渡します

---

ルーティングロジック

call_affiliate_product(vendor_id, product_id, params)
    ↓
adapter = vendor.affiliate_system
    ↓
x402_direct → EIP-3009 payment, no affiliate split
referral_link → inject tracking param, no payment

---

パッケージの更新と製品の更新

これらは独立した項目です。

パッケージの更新（このリポジトリ）：

• アダプターの追加や修正
• ツールスキーマの更新
• ルーティングやキャッシュのロジックの変更
• 依存関係の更新

製品／カタログの更新（registry.json）：

• 新しいベンダーエンドポイントの登録
• 価格やコミッション率の変更
• 製品のアフィリエイト対象化

registry.json にベンダーを追加するために、パッケージのリリースは必要ありません。 新しいパッケージバージョンをリリースするために、製品の再登録は必要ありません。

---

ベンダーの追加

registry.json を編集します。紹介リンク型のベンダーでは、コードの変更は不要です。 x402 ベンダーには、入金済みのウォレットと adapters/x402-direct.js の支払い先許可リストへの登録が必要です。これはコードの変更にあたるため、パッケージのリリースが必要です。

{
  "id": "my_vendor",
  "name": "My Vendor",
  "affiliate_system": "referral_link",
  "affiliate_config": {
    "tracking_param": "ref",
    "affiliate_id_env": "MY_VENDOR_REF_CODE",
    "commission_pct": 25
  },
  "products": [...]
}

---

スポンサーカード（Lulu Ads）

list_tools は GET https://router.forgemesh.io/menu を取得するだけです。ForgeMesh は、無料の応答に開示済みの Lulu Ads カードを 1 つ、サーバー側で単なるラベル付きデータフィールドとして添付します。モデルが指示として読み取れるテキストにはしません。

"sponsored": { "label": "Sponsored", "text": "...", "url": "https://..." }

このパッケージには広告の認証情報は含まれず、広告ネットワークへの呼び出しも行いません。フィールドは変更せずにそのまま渡します。カードを含む他のツールはありません。delete result.sponsored で削除できます。

テレメトリー

すべての call_affiliate_product の呼び出しは logs/affiliate-telemetry.jsonl に追記されます。

{
  "ts": "2026-05-14T17:07:01Z",
  "vendor_id": "coinopai",
  "product_id": "kronos_signals",
  "amount_usd": 0.05,
  "affiliate_id": null,
  "payment_type": "x402_direct",
  "commission_est_usd": null,
  "status": "success",
  "tx_hash": "0x..."
}

---

v0 に含まれない機能

• リモートレジストリとの同期
• PartnerStack／Impact.com／Rewardful API との連携
• ウェブダッシュボード
• 多段階コミッション
• リンクのサーバー側リダイレクトトラッキング

---

ForgeMesh エコシステムの一部

収益化されたエージェントエコシステムのためのインフラストラクチャです。

パッケージ	内容	インストール
affiliate-router-mcp	ベンダーに依存しない収益化ルーティング（このパッケージ）	npm i affiliate-router-mcp
coinopai-mcp	x402 による有料の暗号資産インテリジェンス	npm i coinopai-mcp
forgemesh-imagegen	有料の画像生成 MCP	npm i forgemesh-imagegen

各パッケージは単体で動作します。共通の依存関係は必要ありません。

---

ライセンス

MIT — CoinOpAI