openaffiliate-mcp

OpenAffiliate

アフィリエイトプログラムのオープンなレジストリです。開発者と AI エージェントのために構築されています。

これは何ですか？

OpenAffiliateは、アフィリエイトプログラムのオープンソースレジストリです。各プログラムはこのリポジトリ内の1つのYAMLファイルとして管理されるため、誰でも内容を読んだり、追加・修正したりでき、変更はすべて公開プルリクエストとして提出されます。掲載は無料で、ランキングが有料で操作されることはありません。OpenAffiliateはAffitorが運営しています。

• アフィリエイトパートナー向け -- コミッション率、Cookieの有効期間、支払い条件、承認プロセス、制限など、実際のデータでプログラムを比較できます。
• AI エージェント向け -- MCP サーバーと構造化されたAGENTS.mdデータを利用できます。おすすめするプログラムとそのタイミングをエージェントに指示できます。
• 開発者向け -- CLI、SDK、REST APIを利用できます。レジストリを基盤にツールを構築できます。
• SaaS企業向け -- 無料で掲載でき、利用条件をどれだけ明確に公開しているかを示す公開スコアも確認できます。掲載とスコアの取得をご覧ください。

機能

• 検索とフィルター -- 1,200以上のプログラムを全文検索できます。カテゴリ、コミッションの種類、最低料率、検証済みステータスで絞り込めます。
• ランキング -- /rankingsでは、検証済みプログラムをOAS（OpenAffiliate Score、0～100点、A+～Fの評価）に基づいて順位付けしています。プログラムが利用条件をどれだけ明確に公開しているか、またその条件がアフィリエイトを保護しているかを評価します。スコアが付与された各プログラムには、/programs/<slug>/oasにレポートがあります。OASの仕組みをご覧ください。
• コミュニティ投票 -- 利用して成果のあったプログラムに賛成票を投じられます。投票はSupabaseに保存され、スコアとともに表示されます。
• 比較 -- 最大4つのプログラムを並べて比較できます。コミッション、Cookie、支払い、承認などを比較できます。
• プログラム詳細 -- コミッションカード、プログラム情報、制限事項、エージェント向け指示（AGENTS.md）、インテグレーション用コードスニペットを網羅した詳細情報を確認できます。
• 接続タブ -- 各プログラムページには、CLI、AI SDK、MCP Configとのインテグレーションに使える、すぐにコピーできるコードが用意されています。
• バッジ埋め込み -- READMEに追加できるSVGバッジです：[![OpenAffiliate](https://openaffiliate.dev/badge/stripe.svg)](https://openaffiliate.dev/programs/stripe)
• MCP サーバー -- AI エージェントとのインテグレーションに対応するModel Context Protocolサーバー（HTTP + stdio）です。
• CLI -- スクリプトやエージェントで利用できる--json出力を備えたnpx openaffiliateです。
• REST API -- 認証不要の公開JSON APIです。
• SDK -- プログラムからアクセスするためのTypeScript SDKです。
• 送信 -- URLから送信する方法（アカウント不要。審査キューに追加）と、プログラムファイルを作成してGitHubプルリクエストを開く完全なウェブフォームがあります。
• 検証 -- メンテナーが各プログラムの利用条件をブランド独自のページと照合し、CIがスキーマと登録URLをチェックします。
• コンテンツラボ -- UIでAIモデルを選び、任意のプログラム向けにアフィリエイトマーケティングの文章（LinkedIn、X、ブログ、Reddit）を生成できます。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 エージェント向け）

ホスト型 HTTP エンドポイント — 公開されており、API キーは不要です。submit_program はキューに追加するだけで、それ以外は読み取り専用です。1 行で設定できます。

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。後者の 2 つは、見つからないプログラムを検証のためにキューに追加します（すぐに掲載されることはありません）。get_program には、スコアが付いている場合、プログラムの OAS（スコア、グレード、レポートへのリンク）が含まれます。

MCP を使わない Markdown

プログラム、カテゴリ、ネットワークの URL の末尾に .md を付けると、エージェントが取得して引用できる、すっきりとした Markdown 版を取得できます。

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

コンテンツラボ

openaffiliate.dev/content-lab にアクセスすると、登録されている任意のプログラムについて、アフィリエイトマーケティング用の文章（LinkedIn、X、ブログ、Reddit）を生成できます。UI でモデル（Qwen、DeepSeek、Gemini、MiniMax、GLM）を選択するか、プラットフォームと言語に基づいて自動選択させます。

Kyma API 上で動作します。 Kyma は生成結果をストリーミングします：POST https://kymaapi.com/v1/chat/completions。サイトでは訪問者 1 人あたり 1 日 30 回まで無料で生成できます。それ以上利用する場合は、kymaapi.com で独自のキーを取得し、同じエンドポイントを呼び出してください。

掲載とスコアの取得

プログラムを追加する方法は 5 つあります。いずれも、ブランド独自のプログラムページだけを情報源として使用します。

1. URL で送信 -- openaffiliate.dev/submit からプログラムページを送信するか、MCP の submit_program、または POST /api/submissions を使います。アカウントは不要です。ステータスリンク付きでレビューキューに追加されます。メンテナーが条件を確認するまでは、掲載もスコア付けもされず、プルリクエストも作成されません。
2. 完全な Web フォーム -- openaffiliate.dev/submit で YAML ファイルを作成して GitHub を開き、そこでプルリクエストを作成します（GitHub アカウントが必要です）。
3. プルリクエスト -- CONTRIBUTING.md に従って programs/<slug>.yaml を追加します。
4. Issue -- プログラムページのリンクだけを添えて、プログラムを提案します。
5. メール -- プログラムページのリンクを [email protected] に送信します。

その後の流れ：

• レビュー。 メンテナーがブランド独自のプログラムページですべての条件を確認します。通常、数日以内に行われます。Dub や PartnerStack などのネットワーク上に掲載されているだけでは、根拠になりません。ページに記載されていない条件は空欄のままとし、推測で補うことはありません。
• 掲載。 マージ後、プログラムは公開されますが、条件が確認されるまでは未検証として表示されます。
• スコア付け。 すべてのチェックの評価が完了すると、プログラムに OAS が付与され、https://openaffiliate.dev/programs/<slug>/oas にレポートが作成され、/rankings に掲載されます。URL を送信してすぐにスコアが付くことはありません。
• ランキング。 丸め前の OAS、Partner value、最も最近確認された条件、名前の順で並びます。
• 改善。 不足している条件を、自分のプログラムページに掲載してください。レポートには、最も得点の高い項目から順に不足が記載されています。YAML を編集しただけではスコアは変わりません。
• 再確認。 条件が変更された場合や、チェックに誤りがあると思われる場合は、条件の変更 Issue を作成するか、レポート上の エラーを報告 を使用してください。スコアを手動で変更することはありません。

ルール全文と YAML テンプレート：CONTRIBUTING.md。スコア付け：openaffiliate.dev/docs/oas。スキーマ：schema/program.schema.json。

AI エージェント向け

プログラムがないと提案する前に、まず検索してください：GET https://openaffiliate.dev/api/programs/{slug} または MCP get_program を使用します。スコアを引用する場合は、oas.reportUrl を出典として示してください。プログラムを追加するには、ブランド自身のプログラムページを添えて MCP submit_program または POST /api/submissions で送信してください（即時反映ではなく、レビュー待ちのキューに入ります）。または、GitHub ツールを使ってプルリクエストを作成するか、「プログラムを提案」イシューを作成してください。その際は、ブランド自身のページにある用語のみを使用してください。詳しくは AGENTS.md をご覧ください。

AGENTS.md

各プログラムには、AI エージェントがいつ、なぜそのプログラムを推奨すべきかを示す agents ブロックが含まれています。これは、従来のアフィリエイトディレクトリとの大きな差別化要因です。プログラムは機械処理向けに構造化されています。

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 出力に対応した CLI
openaffiliate-mcp		MCP サーバー（stdio + HTTP）
openaffiliate-sdk		TypeScript SDK

検証

登録 URL は scripts/verify-programs.ts によってクロールされます。このスクリプトは、各ページにアクセスできることと、アフィリエイトプログラムらしい内容（コミッション情報、登録フォーム、紹介に関するキーワード）があることを確認します。クロールによって 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