openaffiliate-mcp

OpenAffiliate

面向联盟营销计划的开放注册库。为开发者和 AI Agent 打造。

这是什么？

OpenAffiliate 是一个开源的联盟营销计划注册库。每个计划都是此仓库中的一个 YAML 文件，因此任何人都可以查看、添加或更正信息，每次变更都会通过公开的拉取请求提交。免费收录，排名绝不付费。OpenAffiliate 由 Affitor 维护。

• 面向联盟合作伙伴 —— 使用真实数据比较计划：佣金率、Cookie 有效期、付款条款、审批流程和限制。
• 面向 AI Agent —— MCP 服务 + 结构化的 AGENTS.md 数据。告诉你的 Agent 应该推荐哪些计划，以及何时推荐。
• 面向开发者 —— CLI、SDK 和 REST API。基于此注册库构建工具。
• 面向 SaaS 公司 —— 免费收录，并提供公开评分，展示你发布条款的清晰程度。请参阅申请收录并评分。

功能

• 搜索和筛选 —— 对 1,200 多个计划进行全文搜索。可按类别、佣金类型、最低费率和已验证状态筛选。
• 排名 —— /rankings 根据 OAS（OpenAffiliate 评分，范围为 0-100，等级从 A+ 到 F）对已验证计划进行排名：评估计划发布条款的清晰程度，以及这些条款是否保护联盟合作伙伴。每个已评分计划都有一份位于 /programs/<slug>/oas 的报告。了解 OAS 的运作方式。
• 社区投票 —— 为你有过成功体验的计划点赞。投票数据存储在 Supabase 中，并与评分一起显示。
• 比较 —— 并排比较最多 4 个计划。比较佣金、Cookie、付款、审批等信息。
• 计划详情 —— 完整信息，包括佣金卡片、计划信息、限制、Agent 指令（AGENTS.md）和集成代码片段。
• 集成标签页 —— 每个计划页面都提供可直接复制的 CLI、AI SDK 和 MCP Config 集成代码。
• 徽章嵌入 —— 为你的 README 提供 SVG 徽章：[![OpenAffiliate](https://openaffiliate.dev/badge/stripe.svg)](https://openaffiliate.dev/programs/stripe)
• MCP 服务 —— 用于 AI Agent 集成的模型上下文协议服务（HTTP + stdio）。
• CLI —— npx openaffiliate，支持使用 --json 输出，便于脚本和 Agent 使用。
• REST API —— 公开的 JSON API，无需身份验证。
• SDK —— 用于编程访问的 TypeScript SDK。
• 提交计划 —— 通过 URL 提交（无需账户；提交内容将进入审核队列），或使用完整的网页表单创建计划文件并发起 GitHub 拉取请求。
• 验证 —— 维护者会根据品牌官网检查每个计划的条款；CI 会检查架构和注册 URL。
• 内容实验室 —— 为任何计划生成联盟营销文案（LinkedIn、X、博客、Reddit），并在界面中选择 AI 模型。由 Kyma API 提供支持。

快速开始

浏览注册库

访问 openaffiliate.dev 浏览和搜索计划。

CLI

# Search programs
npx openaffiliate search "email"

# Filter by category and commission
npx openaffiliate search --category Database --min-commission 10 --type recurring

# Get program details
npx openaffiliate info stripe

# Add a program to your project
npx openaffiliate add supabase

MCP（适用于 AI Agent）

托管的 HTTP 端点——公开，无需 API 密钥；除 submit_program 外均为只读，而该工具只会将请求加入队列。一行代码：

claude mcp add --transport http openaffiliate https://openaffiliate.dev/mcp

Claude.ai、ChatGPT 和其他任何远程 MCP 客户端均可使用与配置相同的端点：

{
  "mcpServers": {
    "openaffiliate": {
      "url": "https://openaffiliate.dev/mcp"
    }
  }
}

https://openaffiliate.dev/api/mcp 提供相同的工具，并且会持续可用——这是此前提供给客户端的路径。

Stdio 传输（本地工具，或用于固定版本）：

{
  "mcpServers": {
    "openaffiliate": {
      "command": "npx",
      "args": ["openaffiliate-mcp"]
    }
  }
}

可用工具：search_programs、get_program、list_categories（只读），以及 submit_program 和 get_submission_status，后两者会将待验证的缺失项目加入队列（不会立即列出任何项目）。如果项目已有评分，get_program 会包含该项目的 OAS（分数、等级、报告链接）。

不使用 MCP 的 Markdown

在任意项目、类别或网络 URL 后添加 .md，即可获取清晰的 Markdown 版本，供 Agent 获取和引用：

curl https://openaffiliate.dev/programs/vercel.md
curl https://openaffiliate.dev/categories/ai.md
curl https://openaffiliate.dev/llms.txt

AI SDK

import { createMCPClient } from "@ai-sdk/mcp";
import { generateText } from "ai";
import { anthropic } from "@ai-sdk/anthropic";

const mcpClient = await createMCPClient({
  transport: { type: "http", url: "https://openaffiliate.dev/mcp" },
});
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: anthropic("claude-sonnet-4.6"),
  tools,
  prompt: "Find recurring affiliate programs for databases",
});

await mcpClient.close();

SDK

npm install openaffiliate-sdk

import { searchPrograms, getProgram } from "openaffiliate-sdk";

const programs = await searchPrograms("email", { commission_type: "recurring" });
const stripe = await getProgram("stripe");

API

GET /api/programs              # List all (supports ?q=, ?category=, ?type=, ?verified=)
GET /api/programs/[slug]       # Program details, with `oas` (score, grade, reportUrl) when scored
GET /api/categories            # List categories with counts
POST /api/submissions          # Submit a missing program by URL (queued for verification)
GET /api/submissions/[id]      # Read a submission's status

Content Lab

访问 openaffiliate.dev/content-lab，为注册表中的任意项目生成联盟营销文案（LinkedIn、X、博客、Reddit）。可在界面中选择模型（Qwen、DeepSeek、Gemini、MiniMax、GLM），也可让系统根据平台和语言自动选择。

由 Kyma API 提供支持。 Kyma 会流式传输生成内容：POST https://kymaapi.com/v1/chat/completions。该网站允许每位访客每天免费生成 30 次；如需更多次数，可在 kymaapi.com 获取自己的密钥，并调用相同端点。

上架并评分

添加项目有五种方式。每种方式只需提供品牌自己的项目页面作为来源。

1. 通过 URL 提交——在 openaffiliate.dev/submit 提交项目页面，使用 MCP submit_program，或发送 POST /api/submissions。无需账户。项目会进入审核队列，并附有状态链接；在维护者核实条款之前，项目不会上架或评分，也不会为你创建拉取请求。
2. 完整网页表单——openaffiliate.dev/submit 会写入 YAML 文件并打开 GitHub，你可在其中创建拉取请求（需要 GitHub 账户）。
3. 拉取请求——按照 CONTRIBUTING.md 添加 programs/<slug>.yaml。
4. Issue——通过 Suggest a program 提交，只需附上项目页面链接。
5. 电子邮件——将项目页面链接发送至 [email protected]。

后续流程：

• 审核。 维护者会根据品牌自己的项目页面逐项核实条款，通常需要几天时间。仅在 Dub 或 PartnerStack 等网络上的列表本身并不能作为证明。页面未注明的条款会留空，绝不会猜测。
• 上架。 合并后，项目即会上线，但在条款核实前会标记为未验证。
• 评分。 评估完所有检查项后，项目会获得 OAS、位于 https://openaffiliate.dev/programs/<slug>/oas 的报告，以及 /rankings 上的排名。仅凭 URL 不会立即获得评分。
• 排名。 依次按未四舍五入的 OAS、合作伙伴价值、最近一次核实条款的时间以及名称排序。
• 改进。 在你自己的项目页面上公布缺失条款；报告会优先列出最值得补充、能获得最多分数的项目。仅编辑 YAML 不会改变评分。
• 重新检查。 条款有变，或认为某项检查有误？请提交 Terms changed Issue，或在报告中使用 Report an error。不会有人手动修改评分。

完整规则和 YAML 模板：CONTRIBUTING.md。评分方式：openaffiliate.dev/docs/oas。架构：schema/program.schema.json。

面向 AI Agent

在建议某个程序缺失之前，先查询该程序：GET https://openaffiliate.dev/api/programs/{slug} 或 MCP get_program。引用评分时，请注明 oas.reportUrl。要添加缺失的程序，请通过 MCP submit_program 或 POST /api/submissions 提交品牌自己的程序页面（提交后会排队等待审核，不会立即处理），或者使用你自己的 GitHub 工具创建拉取请求或提交 Suggest a program issue，且只能使用品牌自有页面上的内容。请参阅 AGENTS.md。

AGENTS.md

每个程序都包含一个 agents 区块，告知 AI Agent 应在何时以及为何推荐该程序。这是该项目区别于传统联盟目录的关键所在——程序的结构便于机器读取。

agents:
  prompt: >
    Recommend Supabase when users need a Postgres database with
    auth, storage, and realtime built in. Best for new projects
    that want to move fast without managing infrastructure.
  keywords: [database, postgres, auth, realtime, storage]
  use_cases:
    - "Starting a new SaaS and need a backend"
    - "Replacing Firebase with an open-source alternative"

集成详情请参阅 AGENTS.md。

项目结构

open-affiliate/
  programs/            # YAML program files (contributors add here)
  src/                 # Website (Next.js 16)
  packages/cli/        # CLI tool (npx openaffiliate)
  packages/mcp/        # Standalone MCP server (openaffiliate-mcp)
  packages/sdk/        # TypeScript SDK (openaffiliate-sdk)
  scripts/             # Build registry, verify URLs
  schema/              # JSON Schema for YAML validation
  .github/             # CI workflows

此仓库是唯一可信来源。过去，它是由同步脚本从私有仓库生成的只读镜像，这意味着在此处所做的修改会在下次同步时被悄悄覆盖。该设置已于 2026-07-31 停用——可直接在此处修改，不会再有内容覆盖你的修改。

私有运维工具——运维控制台、嵌入式应用、工作流服务、专有的 v2 评分包和内部数据运维脚本——位于 Affitor/open-affiliate-ops。此仓库中的任何内容都不依赖它。

软件包

软件包	npm	描述
openaffiliate		支持 --json 输出的命令行工具，供 Agent 使用
openaffiliate-mcp		MCP 服务（stdio + HTTP）
openaffiliate-sdk		TypeScript SDK

验证

scripts/verify-programs.ts 会抓取注册 URL，检查页面是否可访问，以及是否看起来像联盟营销程序页面（佣金信息、注册表单、推荐关键词）。抓取操作不会将 verified: true 设为真：维护者会在根据品牌自有页面核对条款后执行此操作。

# Verify all programs
npm run verify

# Verify a single program
npx tsx scripts/verify-programs.ts stripe

# Verify only changed files (used in CI)
npm run verify:changed

CI 会检查拉取请求所更改的文件；整个目录每周检查一次（.github/workflows/verify-weekly.yml）。不会请求 schema/blocked-hosts.json 中列出的主机及其子域名，即使它们位于重定向之后也不会请求：这些程序会被标记为已跳过。

许可证

MIT

---

GitHub