mcp-dealfinder

MCP DealFinder

アフィリエイトフィードを、トラッキングリンクと明確な開示を含む AI のショッピング回答に変換します。

Awin、Amazon、Commission Junction、Impact、2Performant、その他あらゆるネットワークの商品フィードを AI アシスタントが検索し、ご自身のアフィリエイト ID を使った購入リンクを返す、アフィリエイトマーケター向けの MCP サーバーです。Claude、ChatGPT、Cursor、その他あらゆる MCP 対応 AI で利用できます。

---

⚡ クイックインストール

Cursor に追加

ワンクリックでインストール： 上のバッジをクリックするか、次のディープリンクを使用してください。

cursor://anysphere.cursor-deeplink/mcp/install?name=dealfinder&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm1jcC1kZWFsZmluZGVyIl19

手動で設定： Cursor の MCP 設定または .cursor/mcp.json に追加してください。

{
  "mcpServers": {
    "dealfinder": {
      "command": "npx",
      "args": ["-y", "mcp-dealfinder"],
      "env": { "DEALFINDER_CONFIG": "/absolute/path/to/dealfinder.config.json" }
    }
  }
}

Claude に追加

Claude Code（CLI）：

claude mcp add dealfinder -- npx -y mcp-dealfinder

Claude Desktop： claude_desktop_config.json に追加してください。

{
  "mcpServers": {
    "dealfinder": {
      "command": "npx",
      "args": ["-y", "mcp-dealfinder"],
      "env": { "DEALFINDER_CONFIG": "/absolute/path/to/dealfinder.config.json" }
    }
  }
}

VS Code に追加

ワンクリックでインストール： VS Code にインストール

手動で設定： ワークスペース内の .vscode/mcp.json を作成または編集してください。

{
  "mcpServers": {
    "dealfinder": {
      "command": "npx",
      "args": ["-y", "mcp-dealfinder"],
      "env": { "DEALFINDER_CONFIG": "/absolute/path/to/dealfinder.config.json" }
    }
  }
}

npx で実行

npx -y mcp-dealfinder

環境変数

DEALFINDER_CONFIG に、アフィリエイトネットワークの認証情報とフィード URL を含む設定ファイルの絶対パスを設定してください。

デモモード： DEALFINDER_CONFIG を指定せずに実行すると、架空の商品を使ってテストできます。

「150 EUR 未満のノイズキャンセリングヘッドホンを探して、上位 2 件を比較して」

⭐ このリポジトリが役に立ったら、スターを付けてください！ → スターを付ける

---

🎬 デモ

---

---

📋 目次

• MCP DealFinder を選ぶ理由
• 機能
• ユースケースとプロンプト例
• 比較
• フィードの設定
• 対応ネットワーク
• コンプライアンス
• 活用方法（ライブラリ API）
• 開発
• よくある質問
• コントリビューション
• ライセンス
• 作者について

---

MCP DealFinder を選ぶ理由

あなたはアフィリエイトマーケターです。 自分のフィードにある商品を、自分のトラッキングリンク付きで AI におすすめしてほしいと考えています。他人のアフィリエイト ID が付いた Amazon リンクへ顧客を誘導したり、商品情報をでっち上げたりすることは望んでいません。

DealFinder がこれを解決します。

• ✅ あらゆるアフィリエイトネットワークの自分の商品フィードを検索
• ✅ すべてのリンクに自分のアフィリエイト IDを含めます（汎用 ID や ID の欠落はありません）
• ✅ すべてのトラッキングリンクに明確な開示文を添付
• ✅ Awin、Amazon、CJ、Impact、2Performant、その他あらゆるディープリンク対応ネットワークで利用可能
• ✅ 関連性または価格で順位付けし、報酬額では順位付けしません（公正さを保ちます）
• ✅ ローカルの CSV/JSON フィードに対応（API キー、レート制限、外部依存関係は不要）

---

機能

ツール

ツール	説明	主なパラメーター
search_products	キーワードでアフィリエイト商品フィードを検索します。価格、販売元、購入リンクを含む商品を返します。価格帯、通貨（換算なし）、ネットワーク、販売元で絞り込めます。ダイアクリティカルマークは区別されません。関連度または価格順でランク付けされた最大 20 件の結果を返します。	query（必須）、max_price、min_price、currency、network、merchant、sort、limit、sub_id
compare_products	ref を使って 2～5 件の商品を横並びで比較します。すべての通貨が同じ場合は最安値の商品を示します。商品情報の詳細もすべて含まれます。	refs（2～5 件の参照、必須）、sub_id
get_buy_link	1 件の商品へのアフィリエイトリンク（お客様の ID と開示文を含む）を返します。検索結果の ref を使用してください。	ref（必須）、sub_id
dealfinder_status	読み込まれたフィード（件数、最終更新日時、エラー）と、トラッキング対象のリンクを生成するネットワークを表示します。設定の診断も行います。	なし

すべてのツールで、トラッキング用にリンクをタグ付けする任意の sub_id パラメーターを指定できます（キャンペーン名、投稿 ID、ページスラッグなど）。この値は、利用するネットワークのレポートに表示されます。

主な機能

• 複数ネットワークのサポート：Awin、Amazon Associates、CJ、Impact、2Performant、Profitshare、またはディープリンクテンプレートに対応する任意のネットワーク
• 柔軟なフィード形式：CSV または JSON、ローカルファイルまたは URL、.gz は自動的に展開されます
• ヨーロッパ形式の価格解析：1.299,99、19,99、€ 24.50 形式に対応します
• 柔軟なフォールバック：トラッキングリンクを生成できない場合（設定不足）、通常の販売元 URL を返し、tracked: false として示します
• 検証ツール：AI に接続する前に、npm run check でフィードを読み込み、商品数、カバー率、価格帯、サンプルリンクを報告します

---

使用例とプロンプトの例

1. 商品のおすすめ

「300 ドル以下で最も優れた人間工学に基づいたオフィスチェアを探してください」

「次の販売元から購入できるノイズキャンセリングヘッドホンを教えてください：TechGear、SoundPro」

2. 価格比較

「200～400 EUR のエスプレッソマシン上位 3 件を比較してください」

「Awin フィードから、16GB RAM を搭載した最安のノートパソコンを探してください」

3. ニッチな商品調査

「Impact の販売元からヴィーガン向けプロテインパウダーを探してください」

「現在のフィードに、800 EUR 以下のカメラはありますか？」

4. コンテンツ作成

「150 ドル以下の冬用ジャケットを 5 着探し、アフィリエイトリンク付きの比較記事を書いてください」

「手頃な価格のゲーミングキーボードを探し、購入ガイドを作成してください」

---

比較

2026年10月現在。修正は歓迎します。

機能	MCP DealFinder	OpenAffiliate	Affiliate.com MCP	Fewsats amazon-mcp
独自のアフィリエイト ID	✅ すべてのネットワーク	❌ レジストリのみ。パーソナライズなし	✅ アカウントベース	✅ Amazon のみ
ローカルフィード（API 不要）	✅ CSV/JSON	❌ ホスト型レジストリ	❌ API サブスクリプションが必要	❌ ホスト型バックエンド
複数ネットワーク対応	✅ Awin、Amazon、CJ、Impact、2Performant、汎用テンプレート	✅ 349 以上のプログラム（レジストリ）	✅ ネットワーク検索	❌ Amazon のみ
商品検索	✅ キーワード、価格、販売業者のフィルター	✅ プログラム検索	✅ 商品検索	⚠️ 提供終了
トラッキングリンクの生成	✅ ネットワークごとの設定	❌ プログラム情報のみ	✅ OAuth ベース	⚠️ サービス停止中
ディスクロージャーの記載	✅ すべてのリンクに記載	➖ 該当なし	➖ ネットワークによる	➖ 該当なし
セットアップの複雑さ	⭐⭐（設定ファイル＋フィード）	⭐（URL 1 つ）	⭐⭐⭐（OAuth＋サブスクリプション）	⚠️ メンテナンス終了
費用	無料、MIT	無料、MIT	有料サブスクリプション	有料（現在は終了）

次のような場合は DealFinder が適しています。

• Awin、Amazon、その他のネットワークのアフィリエイトフィードをすでにお持ちの場合
• データを完全に管理したい場合（ローカル CSV、外部 API への依存なし）
• プログラムの検索ではなく、ご自身の ID を使ったトラッキングリンクが必要な場合

次の場合は代替サービスをご検討ください。

• OpenAffiliate — 新しいアフィリエイトプログラムを探していて、検索可能なレジストリが必要な場合（商品検索ではありません）。
• Affiliate.com MCP — すでに Affiliate.com をご利用で、OAuth と統合された商品検索が必要な場合。

---

フィードの設定

examples/dealfinder.config.example.json を dealfinder.config.json（Gitignore 対象）にコピーし、DEALFINDER_CONFIG 環境変数を設定します。

設定の構成

{
  "networks": {
    "awin": {
      "kind": "awin",
      "publisherId": "YOUR_PUBLISHER_ID",
      "apiKey": "YOUR_API_KEY"
    },
    "amazon": {
      "kind": "amazon",
      "tag": "yourtag-20"
    }
  },
  "feeds": [
    {
      "url": "https://example.com/feed.csv.gz",
      "network": "awin",
      "refreshHours": 6,
      "columns": {
        "name": "product_name",
        "price": "price",
        "currency": "currency",
        "url": "deep_link"
      }
    }
  ]
}

• networks — ネットワーク名ごとのアフィリエイトアカウント情報（トラッキングリンクの生成に使用）
• feeds — 商品データソース：CSV または JSON、ローカルファイルパスまたは URL。.gz は自動的に処理されます
• columns — フィードの列名を DealFinder が想定するフィールドに対応付けます

**セキュリティ：**フィード URL には API キーが含まれていることがよくあります。dealfinder.config.json に保存し、バージョン管理には絶対にコミットしないでください。

---

対応ネットワーク

ネットワーク kind	リンクの生成方法	要件
amazon	amazon.* の商品 URL に tag（および ascsubtag）を追加します	フィードに商品 URL が含まれている必要があります。Amazon は公式フィードを提供していないため、商品リストはご自身で用意してください。
awin	awin1.com/cread.php のディープリンクを生成します	フィードごとに publisherId と merchantId（awinmid）が必要です。
template	CJ、Impact、2Performant などに対応する汎用テンプレートです	ネットワークのリンクビルダーからディープリンクの形式をコピーし、遷移先 URL の位置に {urlEncoded} を指定します。{url}、{subId}、params 内の任意のキーも使用できます。

リンクテンプレートの作成（CJ、Impact など）

ネットワークのリンク形式がわからない場合は、ネットワークのダッシュボードでテストリンクを 1 つ生成してから、次を実行します。

npm run link-template -- --link "<generated link>" --url "<product URL>" --name mynetwork

ID を抽出し、遷移先を {urlEncoded} に置き換えて、networks の設定項目を出力し、リンクを再生成して検証します。

フォールバック処理

トラッキングリンクを生成できない場合（アカウント設定の欠落またはプレースホルダーがある場合）、DealFinder は販売業者の通常の URL を返し、tracked: false としてマークします。リンクが壊れることはありません。

接続前の検証

DEALFINDER_CONFIG=$PWD/dealfinder.config.json npm run check

すべてのフィードを読み込み、次の情報を報告します。

• 商品数とフィールドの網羅状況
• 価格帯と通貨の分布
• リンクのサンプル（トラッキングあり、通常）
• トラッキングを妨げる設定エラー

---

コンプライアンス — 必ずお読みください

法的要件

• ✅ 公式フィード／APIのみを使用してください。スクレイピングは、ほとんどのネットワークの利用規約に違反します。
• ✅ 使用前に、AI を利用したプロモーションが許可されているかどうかも含め、各プログラムの利用規約を確認してください。
• ✅ ご自身のトラフィックには、ご自身のアフィリエイト ID を使用してください。ネットワークでは、訪問者を紹介したパブリッシャーに売上が帰属します。ID をローテーションしたり、共有したりしないでください。
• ❌ ご自身のアフィリエイトリンクから購入しないでください。ほとんどのプログラムでは、自己紹介を禁止しています。
• ✅ アフィリエイトリンクの隣に、開示文を表示してください。DealFinder は、トラッキング対象のリンクごとに開示文を含めます。AI にも必ず表示させてください。

データの正確性

• 価格には、最後にフィードを更新した時点の情報が反映されます（refreshHours のデフォルト値は 6）。通貨換算は行われません。
• 顧客に誤解を与えないよう、商品の現地通貨を必ず表示してください。

---

拡張する

DealFinder はライブラリ APIを提供します。startServer または createServer と registerExtras(server, toolkit) コールバックを使用すると、商品表示とリンク生成を再利用しながら、独自の MCP ツールを追加できます。

import { startServer, z } from "mcp-dealfinder";

await startServer({
  name: "my-dealfinder",
  registerExtras: (server, kit) => {
    server.registerTool(
      "cheapest_of",
      { inputSchema: { refs: z.array(z.string()).min(2) } },
      async ({ refs }) => {
        const { products } = kit.resolveRefs(refs);
        const cheapest = [...products].sort((a, b) => a.price - b.price)[0]!;
        return kit.text(kit.present(cheapest));
      }
    );
  },
});

この例では、商品参照を受け取り、最も安い商品を返す cheapest_of ツールを追加しています。フォークせずに、独自のフィルタリング、スコアリング、統合ロジックで DealFinder を拡張できます。

---

開発

npm install
npm test             # node:test: links, link-template, feeds, search, check, MCP server
npm run dev          # run from source over stdio
npm run build        # compile TypeScript to dist/

プロジェクト構成

src/
  config.ts         Config schema + loader (falls back to demo data)
  feeds.ts          CSV/JSON/gzip loading, price parsing, FeedStore
  search.ts         Ranked keyword search (relevance or price)
  links.ts          Affiliate deep-link builders per network
  link-template.ts  Derive a network template from one generated link
  check.ts          Config/feed validation report
  server.ts         MCP tools + extension hook
  bootstrap.ts      Config → feeds → server over stdio
  lib.ts            Public library API

---

よくある質問

DealFinder にアフィリエイト ID が必要なのはなぜですか？

ID がないと、AI は通常の販売者 URL（ご自身にはコミッションが発生しません）か、他人のアフィリエイトリンクを返すことになります。DealFinder は、トラッキング対象のすべてのリンクにご自身の認証情報が使用されるようにします。

DealFinder を Amazon Associates で使用できますか？

はい。ただし、Amazon は公式の商品フィードを提供しておらず、Creators API を利用するには 30 日間で 10 件以上の条件を満たす売上が必要です。Amazon 商品 URL のリストは、ご自身で用意する必要があります。DealFinder は各リンクに tag を追加します。

DealFinder はネットワークの API に対応していますか？それとも CSV フィードのみですか？

現在は CSV／JSON フィード（ローカルまたは URL）に対応しています。API 連携（Awin Product API、CJ Product Catalog など）は、今後のリリースで予定されています。

フィード更新後に商品の価格が変わった場合はどうなりますか？

AI には、最後に更新した時点の価格が表示されます。鮮度と負荷のバランスを取るには、フィード設定の refreshHours（デフォルトは 6 時間）を設定してください。開示文には、必ず「価格は変更される場合があります」と記載してください。

どのページや投稿から売上が発生したかを追跡できますか？

はい！すべてのツールで、オプションの sub_id パラメーターを使用できます。一意の識別子（例：post-123、email-campaign-nov）を渡すと、アフィリエイトリンクに含まれ、ネットワークのレポートで確認できます。

フィードデータはどこかに送信されますか？

いいえ。DealFinder は stdio 経由でローカルに動作します。フィードはメモリに読み込まれ、外部に送信されることはありません。API キーが含まれる場合もある設定ファイルは、ご自身のマシンに保存されます。

---

コントリビューション

コントリビューションを歓迎します！以下をお願いします。

• 変更の範囲を絞り、十分にテストする
• 新しいネットワークテンプレートのテストを追加する
• 新機能についてドキュメントを更新する

未対応のタスクや機能リクエストについては、GitHub Issues をご覧ください。

---

ライセンス

MIT ライセンスです。詳細はLICENSEをご覧ください。

Copyright © 2026 Stefan Petrovici

本ソフトウェアおよび関連するドキュメントファイル（以下「本ソフトウェア」）の複製を入手したすべての人に対し、使用、複製、変更、統合、公開、配布、サブライセンス、および／または販売を含め、本ソフトウェアを制限なく取り扱うことを無償で許可します。また、本ソフトウェアの提供を受けた人に対し、以下の条件に従うことを許可します。

上記の著作権表示および本許諾表示は、本ソフトウェアのすべての複製または実質的な部分に記載するものとします。

本ソフトウェアは「現状のまま」提供され、明示または黙示を問わず、商品性、特定目的への適合性、および非侵害性の保証を含む一切の保証はありません。いかなる場合も、著作者または著作権者は、本ソフトウェアまたは本ソフトウェアの使用その他の取り扱いに起因または関連する契約上の行為、不法行為、その他の理由による請求、損害、その他の責任について、一切責任を負いません。

---

作者について

ルーマニアのヤシを拠点とするソフトウェアエンジニア、Stefan Petrovici が開発しました。

現在、仕事を探しています。 Web アプリやモバイルアプリを開発し、最初のスケッチから本番環境までアイデアを形にします。世界中のお客様と、プロジェクト単位または時間単位でお仕事をしています。MCP サーバー、お店向けの AI アシスタント、またはアフィリエイトマーケティングと AI の連携でお困りでしたら、お気軽にご連絡ください。

---

⭐ このプロジェクトを応援してください

MCP DealFinder が役に立ったら、このリポジトリにスターを付けてください！

GitHub のスターは、ほかのアフィリエイトマーケターがこのプロジェクトを見つける助けとなり、メンテナンスを続ける励みになります。オープンソースへのご支援、ありがとうございます！

---

作者のその他のプロジェクト

Stefan Petrovici による MCP サーバー：

プロジェクト	説明
mcp-security-guard	MCP サーバーを監査し、ツールポイズニング、ラグプル、OWASP MCP Top 10 の脆弱性を検出します
mcp-cost-optimizer	プロバイダーをまたいで AI API のコストを追跡し、削減します
mcp-database-doctor	データベーススキーマの分析と最適化の推奨を行います
mcp-dependency-doctor	依存関係の健全性チェックと脆弱性スキャンを行います
mcp-seo-auditor	Web サイトの SEO 分析と改善案の提示を行います
mcp-api-guardian	API のセキュリティとレート制限を分析します
mcp-marketplace	MCP サーバーの全コレクションを閲覧できます

mcp-marketplace でコレクション全体をご覧ください。

---

MCP DealFinder は、Awin、Amazon、Commission Junction、Impact、2Performant、または本書で言及されているその他のアフィリエイトネットワークとは提携していません。