Youfiliate Smart Links
概要
作者による説明(英語の原文)
Create geo-targeted affiliate smart links, pull analytics, and rewrite YouTube descriptions.
PopNx MCPの3つの柱
この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。
- 利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
- 私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
- 利用状況iとても新しい↓ 14/週 · ★ –
できること
このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。
- 接続方法: パソコンでもクラウドでも
- トランスポート: stdio, Streamable HTTP
- カテゴリ: マーケティング・SNS
- 入力が必要なもの:YOUFILIATE_API_KEY, Authorization
インストール
使っているAIアプリを選んで、設定をコピーしてください。
インストールの前に
- 基本チェック:1項目中1項目に合格
- 作者のサーバーで動きます。あなたが頼んだ内容は、作者のサーバーを通ります。
- 自分で入力するもの:
YOUFILIATE_API_KEY,YOUFILIATE_API_BASE_URL,Authorization
「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。
必要なもの
どのアプリを使っていますか?
上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。
このアドレスはリクエストの header にキーが必要ですが、コネクタを追加するメニューでは設定できません。代わりにClaude Code、Cursor、VS Codeを使ってください。
または、パソコンで動かす
Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます
{
"mcpServers": {
"youfiliate": {
"command": "uvx",
"args": [
"youfiliate-mcp"
],
"env": {
"YOUFILIATE_API_KEY": "your-value",
"YOUFILIATE_API_BASE_URL": "your-value"
}
}
}
}ターミナルでこれを実行します
claude mcp add --transport http youfiliate https://youfiliate-mcp.onrender.com/mcp --header 'Authorization: your-value'または、パソコンで動かす
claude mcp add youfiliate --env YOUFILIATE_API_KEY=your-value --env YOUFILIATE_API_BASE_URL=your-value -- uvx youfiliate-mcp動かす前に、空欄の値を入力してください。
または、設定を自分でコピーする
プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます
{
"mcpServers": {
"youfiliate": {
"url": "https://youfiliate-mcp.onrender.com/mcp",
"headers": {
"Authorization": "your-value"
}
}
}
}または、パソコンで動かす
または、設定を自分でコピーする
プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます
{
"mcpServers": {
"youfiliate": {
"command": "uvx",
"args": [
"youfiliate-mcp"
],
"env": {
"YOUFILIATE_API_KEY": "your-value",
"YOUFILIATE_API_BASE_URL": "your-value"
}
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
または、設定を自分でコピーする
プロジェクトの .vscode/mcp.json に貼り付けます
{
"servers": {
"youfiliate": {
"type": "http",
"url": "https://youfiliate-mcp.onrender.com/mcp",
"headers": {
"Authorization": "your-value"
}
}
}
}または、パソコンで動かす
または、設定を自分でコピーする
プロジェクトの .vscode/mcp.json に貼り付けます
{
"servers": {
"youfiliate": {
"type": "stdio",
"command": "uvx",
"args": [
"youfiliate-mcp"
],
"env": {
"YOUFILIATE_API_KEY": "your-value",
"YOUFILIATE_API_BASE_URL": "your-value"
}
}
}
}ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。
このアドレスはリクエストの header にキーが必要ですが、コネクタを追加するメニューでは設定できません。代わりにClaude Code、Cursor、VS Codeを使ってください。
選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。
自分で入力する値
- Your Youfiliate API key (starts with youfiliate_sk_). Generate one at https://youfiliate.com/settings.
YOUFILIATE_API_BASE_URLenvYoufiliate backend URL.Authorization秘密 必須 HTTP headerBearer token using your Youfiliate API key. Format: 'Bearer youfiliate_sk_your_key_here'.
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
できること
このサーバーのツール一覧はまだ読み取っていません。エンドポイントは順番にチェックしています。
基本チェックi
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月9日にチェック
- ✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント andrewmpierce で確認済みです
- … 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
- … 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
- … 未チェック
エンドポイントが応答する
まだチェックしていません。エンドポイントは順番にチェックしています
- … 未チェック
OAuthでサインイン
まだチェックしていません。エンドポイントは順番にチェックしています
- … 未チェック
ツールの説明に隠れた指示がない
まだチェックしていません。エンドポイントをチェックするときにツール一覧を読み取ります
マーケティング・SNSのほかのサーバーとの比較i
- このカテゴリのほかの3631件のうち0%よりスターが多い
- このカテゴリのほかの3631件のうち7%より最近レジストリに公開
- 基本チェックの結果が、このカテゴリのほかの3631件のうち100%と同じかそれ以上
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
よくある質問
Youfiliate Smart Linksは安全ですか?
当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
どんなキーやコードが必要ですか?
入力が必要なもの:YOUFILIATE_API_KEY, Authorization
パソコンで動きますか、それともクラウドですか?
どちらでも使えます。パソコンにインストールしても、クラウド版につないでもかまいません。
今もメンテナンスされていますか?
GitHubリポジトリの最終更新は–、最新バージョン(0.1.1)がレジストリに届いたのは6 か月前です。
どのアプリで使えますか?
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URLでつながるので、リモートMCPサーバーに対応したアプリ(開発者モードのChatGPTなど)でも使えます。
代わりに使えるものは?
同じカテゴリには:MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer
代わりの候補
同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
Google Analytics MCP
GA4 MCP server for AI agents: schema discovery, server-side aggregation, analysis-ready defaults.
BibiGPT YouTube Video Summarizer
AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.
作者のREADME
READMEを開く
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
Youfiliate MCP Server
MCP (Model Context Protocol) server for managing Youfiliate Smart Links from AI assistants like Claude Desktop. Create geo-targeted affiliate links, view analytics, and run YouTube description migrations — all from a chat conversation.
18 tools, 4 resources, supports stdio + streamable HTTP transports.
Installation
pip install youfiliate-mcp
Requires Python 3.11+ and a Youfiliate account.
Generate an API key
- Log in at youfiliate.com
- Go to Settings → API Keys
- Click Create API Key (e.g. "Claude Desktop")
- Copy the key (starts with
youfiliate_sk_) — shown only once
Claude Desktop Configuration
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
Local (stdio)
{
"mcpServers": { "youfiliate": { "command": "youfiliate-mcp", "env": { "YOUFILIATE_API_KEY": "youfiliate_sk_your_key_here" } } } }
Remote (Streamable HTTP)
{
"mcpServers": { "youfiliate": { "url": "https://mcp.youfiliate.com", "headers": { "Authorization": "Bearer youfiliate_sk_your_key_here" } } } }
Restart Claude Desktop after editing the config.
Available Tools (18)
Smart Links CRUD (5)
| Tool | Description |
|---|---|
youfiliate_create_smart_link | Create a new geo-targeted smart link |
youfiliate_list_smart_links | List smart links with filtering and pagination |
youfiliate_get_smart_link | Get full details of a smart link by ID |
youfiliate_update_smart_link | Update a smart link (partial update) |
youfiliate_delete_smart_link | Delete a smart link (requires confirm=True) |
Analytics (3)
| Tool | Description |
|---|---|
youfiliate_get_smart_link_stats | Get click analytics for a specific link |
youfiliate_get_aggregate_stats | Get analytics across all links |
youfiliate_check_link_health | Trigger a health check on a link |
Preferences (2)
| Tool | Description |
|---|---|
youfiliate_get_preferences | Get default smart link preferences |
youfiliate_update_preferences | Update preferences for new links |
YouTube (3)
| Tool | Description |
|---|---|
youfiliate_get_youtube_status | Check YouTube connection status |
youfiliate_connect_youtube | Start YouTube OAuth flow (returns auth URL) |
youfiliate_disconnect_youtube | Disconnect YouTube (requires confirm=True) |
Migrations (5)
| Tool | Description |
|---|---|
youfiliate_preview_migration | Preview migration scope (dry run) |
youfiliate_start_migration | Start YouTube description migration (requires confirm=True) |
youfiliate_get_migration_status | Check migration progress |
youfiliate_list_migrations | List all migrations |
youfiliate_rollback_migration | Rollback a migration (requires confirm=True) |
Available Resources (4)
| URI | Description |
|---|---|
youfiliate://summary | Dashboard summary (link counts, clicks, health) |
youfiliate://preferences | Current preferences (read-only) |
youfiliate://smart-link/{id} | Single smart link details |
youfiliate://plan-limits | Current plan usage and limits |
Example Conversations
Creating a Smart Link
You: Create a smart link for
https://amazon.com/dp/B09V3KXJPBwith geo-targeting for UK and Germany.
Claude: *(calls
youfiliate_create_smart_linkwith geo rules for GB and DE)*
Done. Short URL:
youfil.to/b09v3kxjpb
- US (default): amazon.com/dp/B09V3KXJPB
- UK: amazon.co.uk/dp/B09V3KXJPB
- Germany: amazon.de/dp/B09V3KXJPB
Checking Analytics
You: How are my links performing this month?
Claude: *(calls
youfiliate_get_aggregate_statswithperiod="30d")*
1,234 clicks. Top countries: US (500), UK (200), Germany (150). Most traffic from YouTube (900 clicks).
YouTube Migration
You: Convert all my YouTube description links to smart links.
Claude: *(calls
youfiliate_preview_migration)* Would affect 15 videos / 42 links. Proceed?
You: Yes.
Claude: *(calls
youfiliate_start_migrationwithconfirm=True)*
Security Model
- API key auth. Your
youfiliate_sk_...key authenticates the MCP server. - JWT bridge. The server exchanges your API key for short-lived JWTs against the Youfiliate API.
- Token caching. JWTs are cached in memory and auto-refreshed.
- Scoped data access. The server only sees data belonging to the API key's owner.
- Destructive actions guarded. Delete, disconnect, start migration, and rollback require explicit
confirm=True.
Rate Limits
- MCP layer: 60 requests/minute per API key
- Health checks: 1 per link per 5 minutes
- API key exchange: rate-limited by the Youfiliate backend
Environment Variables
| Variable | Default | Description |
|---|---|---|
YOUFILIATE_API_KEY | (required) | Your API key |
YOUFILIATE_API_BASE_URL | https://app.youfiliate.com | Backend URL |
MCP_SERVER_SECRET | (empty) | Shared secret for verify-api-key (server operators only) |
TRANSPORT | stdio | stdio or streamable-http |
PORT | 8080 | Port for HTTP transport |
HOST | 127.0.0.1 | Bind address (use 0.0.0.0 in Docker) |
Development
git clone https://github.com/andrewmpierce/youfiliate-mcp.git
cd youfiliate-mcp pip install -e ".[dev]" pytest -v
Test with 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
Troubleshooting
"Authentication failed" — verify your API key, regenerate at youfiliate.com/settings if needed.
"Could not connect to the Youfiliate API" — check YOUFILIATE_API_BASE_URL. Defaults to https://app.youfiliate.com.
"Rate limit exceeded" — wait a moment. Health checks are 1 per 5 minutes per link.
Tools not appearing in Claude Desktop — check claude_desktop_config.json syntax, restart Claude Desktop, run youfiliate-mcp --help to verify the binary is on your PATH.
License
MIT
Links
- Website: youfiliate.com
- Issues: github.com/andrewmpierce/youfiliate-mcp/issues
- Changelog: CHANGELOG.md