affiliate-router-mcp

affiliate-router-mcp

为 Agent 工具提供与供应商无关的变现路由。一个 MCP 服务即可发现、路由并归因付费 API、推荐链接和联盟计划带来的收入。

来源： https://github.com/forgemeshlabs/affiliate-router-mcp

路由器不绑定任何单一支付网络或联盟系统。适配器可插拔。注册表是由你控制的本地 JSON 文件。

状态： 实验性 · v0.1.12

免责声明： 此 MCP 不保证付款。它会根据各供应商／计划的规则路由归因数据。佣金分配由供应商的支付系统执行，而非此路由器。

---

功能

Agent 需要一种调用可变现工具的方式，而不必为每个联盟或支付系统都硬编码。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 密钥合作伙伴计划，以及其他新兴的 Agent 商务协议。

---

安装

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 主网以外的任何网络、除 USDC 以外的任何资产，或超过每次调用内置上限（$0.15 和 $0.10）及每个会话 $10 预算的金额签名。环境变量 X402_MAX_PRICE_USD 和 X402_SESSION_BUDGET_USD 只能降低这些上限，不能提高。请使用专用的低余额钱包。

环境变量

变量	必填	说明
WALLET_PRIVATE_KEY	对于使用 x402 适配器的 call_affiliate_product	Base 钱包，需包含 USDC 和用于支付 Gas 的 ETH
X402_MAX_PRICE_USD	否	降低每次调用的支付上限（绝不会提高上限）
X402_SESSION_BUDGET_USD	否	降低每个会话的支付预算（绝不会提高预算）
GUMROAD_AFFILIATE_ID	否	Gumroad 跟踪 ID
PARTNERSTACK_CODE	否	PartnerStack 推荐代码

---

包含的供应商

CoinOpAI（x402_direct）— Base 主网上的加密货币情报 API

• Kronos Signals — 每次调用 $0.05
• Kronos Decision — 每次调用 $0.15
• Trade Preflight — 每次调用 $0.05
• Trade Audit — 每次调用 $0.07
• Image Generation — 每次调用 $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 — 向 generate_affiliate_link 传入 extra_params: {vin: "..."}，即可预填 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 卡片，作为普通的带标签数据字段——绝不会使用模型可能读作指令的文本：

"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 集成
• Web 控制面板
• 多级佣金
• 链接的服务器端重定向跟踪

---

ForgeMesh 生态系统的一部分

面向可变现 Agent 生态系统的基础设施。

软件包	用途	安装
affiliate-router-mcp	供应商中立的变现路由（此软件包）	npm i affiliate-router-mcp
coinopai-mcp	通过 x402 提供付费加密货币情报	npm i coinopai-mcp
forgemesh-imagegen	付费图像生成 MCP	npm i forgemesh-imagegen

每个软件包都可独立运行，无需共享依赖项。

---

许可证

MIT — CoinOpAI