linkrescue-mcp

LinkRescue MCP Server

壊れたアフィリエイトリンクをすばやく見つけ、影響度に基づいて優先順位を付け、AI エージェントが実行できる修正案を生成します。

1 回の呼び出しで、38 以上のアフィリエイトネットワークをチェック。追跡の不具合も見逃しません。

ワンクリックでインストール： MCPize にインストール | pip install linkrescue-mcp

LinkRescue MCP は、Model Context Protocol（MCP）を通じてリンク切れのスキャン、監視、修正ワークフローを提供するため、Claude や Cursor などのツールからリンクの健全性チェックを直接実行できます。

利用できる機能

• check_broken_links：URL（またはサイトマップ）をスキャンし、リンク切れの構造化レポートを返します
• monitor_links：ウェブサイトの定期監視を設定します
• get_fix_suggestions：優先順位付けされた修正案を生成します
• health_check：MCP サーバーとバックエンド API の接続を確認します

LinkRescue バックエンド API に接続できない場合、ツールは接続できなかったエンドポイントを示すエラーを発生させます。見つかっていない問題を作り上げて返すことはありません。ローカルテストでは、LINKRESCUE_DEMO_MODE=1 を設定するとサンプルデータを取得できます。シミュレーションされた各ペイロードには "simulated": true と明示的な警告が含まれます。

ホステッドエンドポイント（インストール不要）

LinkRescue は、https://www.linkrescue.io/api/mcp（ストリーミング可能な HTTP）でリモート MCP サーバーを稼働させています。 linkrescue.io/signup で無料の API キーを取得し、リモート対応の MCP クライアントを接続してください。

{
  "mcpServers": {
    "linkrescue": {
      "url": "https://www.linkrescue.io/api/mcp",
      "headers": { "Authorization": "Bearer lr_your_api_key" }
    }
  }
}

ホステッドサーバーは check_links、start_site_scan、get_scan、get_fix_suggestions を提供します。 シミュレーションデータを返すことはありません。以下の stdio パッケージはローカルおよびオフラインでの使用を目的としています。

クイックスタート

{
  "mcpServers": {
    "linkrescue": {
      "command": "linkrescue-mcp"
    }
  }
}

続いて、AI エージェントに次のように依頼します。

「example.com の壊れたアフィリエイトリンクをスキャンしてください」

Free と Pro の比較

ツール	Free	Pro	Agency
health_check	はい	はい	はい
check_broken_links（最大 50 ページ）	はい	はい	はい
check_broken_links（最大 2,000 ページ）	-	はい	はい
check_broken_links（無制限＋サイトマップのクロール）	-	-	はい
get_fix_suggestions	-	はい	はい
monitor_links（毎日）	-	はい	はい
monitor_links（毎時＋ウェブフック）	-	-	はい
複数サイトの監視	-	5 サイト	25 サイト

Free プランでは、1 ページ単位のリンク切れチェックを利用できます。Pro では、フルクローラー、修正案、定期監視が利用可能になります。Agency では、毎時のチェック、ウェブフック、サイト数の無制限が追加されます。

現在の価格は linkrescue.io/pricing に掲載されています。このページが唯一の正式な情報源です。MCPize にインストール。

インストール

MCPize（推奨）

ホスティング管理付きのワンクリックインストール：MCPize にインストール

PyPI

pip install linkrescue-mcp
linkrescue-mcp

ソースから

git clone https://github.com/carsonroell-debug/linkrescue-mcp.git
cd linkrescue-mcp
pip install -r requirements.txt
python main.py

MCP エンドポイント：

• http://localhost:8000/mcp

設定

変数	説明	デフォルト
LINKRESCUE_API_BASE_URL	LinkRescue API のベース URL	https://www.linkrescue.io/api/v1
LINKRESCUE_API_KEY	認証リクエスト用の API キー	空
LINKRESCUE_DEMO_MODE	API に接続できない場合、エラーの代わりにラベル付きのサンプルデータを返します。デフォルトではオフです。実際のサイトに対しては絶対に有効にしないでください。	空（オフ）

例：

export LINKRESCUE_API_BASE_URL="https://www.linkrescue.io/api/v1"
export LINKRESCUE_API_KEY="your-api-key"
linkrescue-mcp

linkrescue.io/settings/api で API キーを取得してください（Pro および Agency プランのみ）。

実行方法

インストール済みのエントリーポイントから実行：

linkrescue-mcp

ソースから直接実行：

python main.py

FastMCP CLI から実行：

fastmcp run main.py --transport streamable-http --port 8000

MCP クライアントを接続する

Claude Desktop

claude_desktop_config.json に次の内容を追加します。

{
  "mcpServers": {
    "linkrescue": {
      "command": "linkrescue-mcp"
    }
  }
}

Claude Code

claude mcp add linkrescue --transport http http://localhost:8000/mcp

試してみる

fastmcp list-tools main.py
fastmcp call-tool main.py health_check '{}'
fastmcp call-tool main.py check_broken_links '{"url":"https://example.com"}'

ツールの入力と出力

check_broken_links

入力：

• url（必須）：スキャンするサイトの URL
• sitemap_url（任意、Agency ティア）：サイトマップからクロールします
• max_depth（任意、デフォルトは 3）：クロールの深さ

スキャンのメタデータ、リンク切れの詳細、概要統計を返します。解決可能でもトラッキングパラメーターが失われたアフィリエイトリンクは、クリックされても収益を生まないリンク数として、収益機会の損失に計上されます。LinkRescue は損失収益を推定しません。ご自身の RPM を掛けてください。

monitor_links

入力：

• url（必須）
• frequency_hours（任意、デフォルトは 24。Agency ティアでは 1 をサポート）

モニター ID、スケジュールの詳細、ステータスを返します。Free ティアでは、シミュレーションされたモニターが返されます（永続化されません）。

get_fix_suggestions

入力：

• check_broken_links の完全なレポート、または
• 生の broken_links 配列、または
• いずれかの形式の JSON 文字列

優先順位付けされたアクションと、推奨される修正手順を返します。Pro および Agency ティアのみで利用できます。

health_check

入力はありません。サーバーのステータスとバックエンド API の到達可能性を返します。

デプロイ

Smithery

このリポジトリには smithery.yaml と smithery.json が含まれています。

1. リポジトリを GitHub にプッシュします
2. Smithery でサーバーを作成／追加します
3. Smithery の参照先をこのリポジトリに設定します

Docker／ホスティングプラットフォーム

Railway、Fly.io、その他のコンテナホスト向けに Dockerfile が含まれています。

# Railway
railway up

# Fly.io
fly launch
fly deploy

ホスト環境で LINKRESCUE_API_BASE_URL と LINKRESCUE_API_KEY を設定します。

アーキテクチャ

Agent (Claude, Cursor, etc.)
  -> MCP
LinkRescue MCP Server (this repo)
  -> HTTP API
LinkRescue Backend API (linkrescue.io)

このサーバーは、MCP ツール呼び出しと LinkRescue API 操作の間の変換レイヤーです。

ライセンス

MIT — Freedom Engineers が開発

関連項目

• SelfHeal MCP — MCP サーバー向けの自己修復プロキシ
• SiteHealth MCP — ウェブサイト全体のヘルス監査
• LeadEnrich MCP — 段階的なリード情報の拡充

README の別バージョン

• 開発者向けバージョン：README.dev.md
• マーケットプレイス向けバージョン：README.marketplace.md