Referralmeter

Name: Referralmeter
Author: referralmeter.com

远程服务

referralmeter.com商业与营销03 天前更新

代码仓库访问官网

关于 Referralmeter

Referralmeter 是一个轻量、无依赖的 JavaScript 服务端 SDK，通过 Referralmeter REST API 记录联盟注册。适用于在服务端完成注册，或使用 Referralmeter 未原生连接的计费服务商的应用。

主要功能

01在服务端记录注册
02调用 Referralmeter REST API
03无需安装依赖
04支持 Node 18+
05支持提供全局 fetch 的运行时

适用场景

01浏览器脚本被拦截时记录注册
02跟踪服务端完成的注册
03为未支持的计费服务商接入注册跟踪

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://referralmeter.com/api/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http com-referralmeter https://referralmeter.com/api/mcp

Cursor.cursor/mcp.json{"mcpServers":{"com-referralmeter":{"type":"http","url":"https://referralmeter.com/api/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"com-referralmeter":{"type":"http","url":"https://referralmeter.com/api/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"com-referralmeter":{"type":"http","url":"https://referralmeter.com/api/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"com-referralmeter":{"serverUrl":"https://referralmeter.com/api/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

referralmeter-js

适用于服务端的精简、零依赖 SDK，供 Referralmeter 使用——面向 AI 应用的联盟营销计划。编码 Agent 只需一条提示词即可安装 Referralmeter；佣金根据你自己的计费服务商提供的签名 Webhook 计算（Stripe、Polar、Lemon Squeezy、Paddle、Creem、Dodo Payments），因此大多数应用根本不需要这个软件包——安装跟踪脚本，并连接计费服务商即可。

仅在以下情况下使用此软件包：

注册在你的服务器上完成，而你希望即使浏览器脚本被拦截，也能记录注册信息；或
你使用的计费服务商不在 Referralmeter 原生支持范围内。

这是对 REST API 的轻量封装——零依赖，可在 Node 18+ 以及任何提供全局 fetch 的运行时中使用。

安装

npm install github:ajussis/referralmeter-js

（不在 npm 仓库中——直接从 GitHub 安装，或者直接复制 src/index.js，它只有一个文件。）

使用方法

import { createClient } from "referralmeter-js";

const referralmeter = createClient({ secretKey: process.env.REFERRALMETER_SECRET_KEY });

// After your own signup completes server-side:
await referralmeter.recordSignup({
  email: "[email protected]",
  external_id: "user_42",
  referral: req.cookies.sf_ref, // what referralmeter.ref() returned in the browser, or an affiliate code
  ip: req.ip,
});

// Billing you don't connect to natively:
await referralmeter.recordSale({
  event_id: "pay_123", // your idempotency key — sending it twice records it once
  amount: 4900, // integer cents
  currency: "usd",
  customer_external_id: "user_42",
  kind: "subscription", // subscription | one_time | credits | usage
});

await referralmeter.recordRefund({
  event_id: "ref_9",
  payment_id: "pay_123",
  amount: 4900,
});

完整字段参考：referralmeter.com/docs/server-side。

为什么要开发这个软件包

Referralmeter 以 Agent 为先：AI 编码 Agent 应该只需一条提示词，就能安装联盟营销跟踪功能，无需猜测 curl 语法。开发这个软件包，是为了让提示词可以写成 npm install github:ajussis/referralmeter-js，而不必手动编写 fetch 调用；同时也让 Agent（或用户）在 GitHub 上搜索联盟营销跟踪 SDK 时能找到 Referralmeter。