Youfiliate

Youfiliate MCP サーバー

Claude Desktop などの AI アシスタントから Youfiliate の Smart Links を管理するための MCP（Model Context Protocol）サーバーです。地域をターゲットにしたアフィリエイトリンクの作成、分析データの確認、YouTube の説明欄の移行をすべてチャットで行えます。

18 個のツール、4 個のリソースに対応し、stdio と streamable HTTP のトランスポートをサポートしています。

インストール

pip install youfiliate-mcp

Python 3.11 以降と Youfiliate アカウントが必要です。

API キーを生成する

1. youfiliate.com にログインします
2. Settings → API Keys に移動します
3. Create API Key をクリックします（例：「Claude Desktop」）
4. キーをコピーします（youfiliate_sk_ で始まります）。キーが表示されるのは一度だけです

Claude Desktop の設定

~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

ローカル（stdio）

{
  "mcpServers": {
    "youfiliate": {
      "command": "youfiliate-mcp",
      "env": {
        "YOUFILIATE_API_KEY": "youfiliate_sk_your_key_here"
      }
    }
  }
}

リモート（Streamable HTTP）

{
  "mcpServers": {
    "youfiliate": {
      "url": "https://mcp.youfiliate.com",
      "headers": {
        "Authorization": "Bearer youfiliate_sk_your_key_here"
      }
    }
  }
}

設定ファイルを編集した後、Claude Desktop を再起動してください。

利用可能なツール（18 個）

Smart Links の CRUD（5 個）

ツール	説明
youfiliate_create_smart_link	地域をターゲットにした新しい Smart Link を作成します
youfiliate_list_smart_links	フィルタリングとページネーションを使って Smart Links を一覧表示します
youfiliate_get_smart_link	ID を指定して Smart Link の詳細を取得します
youfiliate_update_smart_link	Smart Link を更新します（一部更新）
youfiliate_delete_smart_link	Smart Link を削除します（confirm=True が必要です）

分析（3 個）

ツール	説明
youfiliate_get_smart_link_stats	特定のリンクのクリック分析データを取得します
youfiliate_get_aggregate_stats	すべてのリンクの分析データを取得します
youfiliate_check_link_health	リンクのヘルスチェックを実行します

設定（2 個）

ツール	説明
youfiliate_get_preferences	Smart Link のデフォルト設定を取得します
youfiliate_update_preferences	新しいリンクに適用する設定を更新します

YouTube（3 個）

ツール	説明
youfiliate_get_youtube_status	YouTube の接続状態を確認します
youfiliate_connect_youtube	YouTube の OAuth フローを開始します（認証 URL を返します）
youfiliate_disconnect_youtube	YouTube の接続を解除します（confirm=True が必要です）

移行（5 個）

ツール	説明
youfiliate_preview_migration	移行範囲をプレビューします（ドライラン）
youfiliate_start_migration	YouTube の説明欄の移行を開始します（confirm=True が必要です）
youfiliate_get_migration_status	移行の進捗状況を確認します
youfiliate_list_migrations	すべての移行を一覧表示します
youfiliate_rollback_migration	移行をロールバックします（confirm=True が必要です）

利用可能なリソース（4 個）

URI	説明
youfiliate://summary	ダッシュボードの概要（リンク数、クリック数、ヘルス状態）
youfiliate://preferences	現在の設定（読み取り専用）
youfiliate://smart-link/{id}	単一の Smart Link の詳細
youfiliate://plan-limits	現在のプランの利用状況と上限

会話例

Smart Link を作成する

あなた： https://amazon.com/dp/B09V3KXJPB に対して、英国とドイツをターゲットにした Smart Link を作成してください。

Claude： （GB と DE の地域ルールを指定して youfiliate_create_smart_link を呼び出します）

完了しました。短縮 URL：youfil.to/b09v3kxjpb

• 米国（デフォルト）：amazon.com/dp/B09V3KXJPB
• 英国：amazon.co.uk/dp/B09V3KXJPB
• ドイツ：amazon.de/dp/B09V3KXJPB

分析データを確認する

あなた： 今月、リンクのパフォーマンスはどうですか？

Claude： （period="30d" を指定して youfiliate_get_aggregate_stats を呼び出します）

1,234 回クリックされました。上位の国：米国（500）、英国（200）、ドイツ（150）。トラフィックの大部分は YouTube からです（900 回クリック）。

YouTube の移行

あなた： YouTube の説明欄にあるリンクをすべてスマートリンクに変換してください。

Claude： （youfiliate_preview_migration を呼び出します） 15 本の動画／42 件のリンクに影響します。実行しますか？

あなた： はい。

Claude： （confirm=True を指定して youfiliate_start_migration を呼び出します）

セキュリティモデル

1. API キー認証。 お使いの youfiliate_sk_... キーで MCP サーバーを認証します。
2. JWT ブリッジ。 サーバーは、お使いの API キーを Youfiliate API に対する短期間有効な JWT と交換します。
3. トークンのキャッシュ。 JWT はメモリにキャッシュされ、自動的に更新されます。
4. スコープを限定したデータアクセス。 サーバーには、API キーの所有者に属するデータのみが表示されます。
5. 破壊的な操作の保護。 削除、切断、移行の開始、ロールバックには、明示的な confirm=True が必要です。

レート制限

• MCP レイヤー：API キーごとに 1 分あたり 60 リクエスト
• ヘルスチェック：リンクごとに 5 分あたり 1 回
• API キーの交換：Youfiliate バックエンドによるレート制限

環境変数

変数	デフォルト	説明
YOUFILIATE_API_KEY	（必須）	お使いの API キー
YOUFILIATE_API_BASE_URL	https://app.youfiliate.com	バックエンド URL
MCP_SERVER_SECRET	（空）	verify-api-key 用の共有シークレット（サーバー運用者のみ）
TRANSPORT	stdio	stdio または streamable-http
PORT	8080	HTTP トランスポート用のポート
HOST	127.0.0.1	バインドアドレス（Docker では 0.0.0.0 を使用）

開発

git clone https://github.com/andrewmpierce/youfiliate-mcp.git
cd youfiliate-mcp
pip install -e ".[dev]"
pytest -v

MCP Inspector でテストする

npx @modelcontextprotocol/inspector youfiliate-mcp

Docker

docker build -t youfiliate-mcp .
docker run -p 8080:8080 \
  -e YOUFILIATE_API_KEY=youfiliate_sk_... \
  youfiliate-mcp

トラブルシューティング

「認証に失敗しました」 — API キーを確認してください。必要に応じて、youfiliate.com/settings で再生成してください。

「Youfiliate API に接続できませんでした」 — YOUFILIATE_API_BASE_URL を確認してください。デフォルトは https://app.youfiliate.com です。

「レート制限を超えました」 — 少し待ってください。ヘルスチェックはリンクごとに 5 分あたり 1 回です。

Claude Desktop にツールが表示されない — claude_desktop_config.json の構文を確認し、Claude Desktop を再起動してください。また、youfiliate-mcp --help を実行して、バイナリが PATH 上にあることを確認してください。

ライセンス

MIT

リンク

• ウェブサイト：youfiliate.com
• イシュー：github.com/andrewmpierce/youfiliate-mcp/issues
• 変更履歴：CHANGELOG.md