LinkRescue

Servidor MCP que expone las capacidades de escaneo de enlaces rotos, monitoreo y sugerencias de reparación de LinkRescue a agentes de IA (Claude, Cursor, etc.).

Documentación

Servidor MCP de LinkRescue

PyPI License: MIT MCPize

Encuentra enlaces de afiliados rotos rápidamente, prioriza por impacto y genera sugerencias de corrección que tu agente de IA pueda ejecutar.

Una llamada. Más de 38 redes de afiliados verificadas. Pérdida de ingresos estimada.

Instalación con un clic: Instalar en MCPize | pip install linkrescue-mcp

LinkRescue MCP expone flujos de trabajo de escaneo, monitoreo y corrección de enlaces rotos a través del Model Context Protocol (MCP), para que herramientas como Claude y Cursor puedan ejecutar operaciones de salud de enlaces directamente.

Qué Obtienes

  • check_broken_links: escanea una URL (o sitemap) y devuelve un informe estructurado de enlaces rotos
  • monitor_links: configura monitoreo recurrente para un sitio web
  • get_fix_suggestions: genera recomendaciones de corrección priorizadas
  • health_check: verifica la conectividad del servidor MCP y la API del backend

Si la API del backend de LinkRescue no está disponible, el servidor recurre a datos simulados realistas para que las pruebas locales y las demostraciones sigan funcionando.

Inicio Rápido

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

Luego pregúntale a tu agente de IA:

"Escanea example.com en busca de enlaces de afiliados rotos"

Gratis vs Pro

HerramientaGratisPro ($19/mes)Agencia ($29/mes)
health_check
check_broken_links (hasta 50 páginas)
check_broken_links (hasta 2,000 páginas)-
check_broken_links (ilimitado + rastreo de sitemap)--
get_fix_suggestions-
monitor_links (diario)-
monitor_links (cada hora + webhooks)--
Estimaciones de pérdida de ingresos-
Monitoreo multi-sitio-5 sitios25 sitios

El plan gratuito te ofrece verificaciones de enlaces rotos en una sola página. Pro desbloquea el rastreador completo + sugerencias de corrección + monitoreo recurrente. Agency añade verificaciones por hora, webhooks y número ilimitado de sitios.

Mejora a Pro en MCPize — $19/mes o $190/año. Agency $29/mes o $290/año.

Instalación

MCPize (Recomendado)

Instalación con un clic con hosting gestionado: Instalar en MCPize

PyPI

pip install linkrescue-mcp
linkrescue-mcp

Desde el código fuente

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

Endpoint MCP:

  • http://localhost:8000/mcp

Configuración

VariableDescripciónPredeterminado
LINKRESCUE_API_BASE_URLURL base para la API de LinkRescuehttp://localhost:3000/api/v1
LINKRESCUE_API_KEYClave API para solicitudes autenticadasvacío

Ejemplo:

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

Obtén una clave API en linkrescue.io/settings/api (solo planes Pro y Agency).

Opciones de Ejecución

Ejecuta mediante el punto de entrada instalado:

linkrescue-mcp

Ejecuta directamente desde el código fuente:

python main.py

Ejecuta mediante la CLI de FastMCP:

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

Conectar un Cliente MCP

Claude Desktop

Añade esto a claude_desktop_config.json:

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

Claude Code

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

Pruébalo

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

Entradas y Salidas de Herramientas

check_broken_links

Entradas:

  • url (obligatorio): URL del sitio a escanear
  • sitemap_url (opcional, plan Agency): rastreo desde sitemap
  • max_depth (opcional, predeterminado 3): profundidad de rastreo

Devuelve metadatos del escaneo, detalles de enlaces rotos y estadísticas resumidas. Los planes Pro y Agency incluyen la pérdida mensual estimada de ingresos por enlaces de afiliados rotos.

monitor_links

Entradas:

  • url (obligatorio)
  • frequency_hours (opcional, predeterminado 24; el plan Agency admite 1)

Devuelve el ID de monitoreo, detalles de programación y estado. El plan gratuito devuelve un monitor simulado (sin persistencia).

get_fix_suggestions

Entrada:

  • informe completo de check_broken_links, o
  • array broken_links sin procesar, o
  • cadena JSON de cualquiera de los formatos

Devuelve acciones priorizadas y pasos de corrección sugeridos. Solo planes Pro y Agency.

health_check

Sin entrada. Devuelve el estado del servidor y la accesibilidad de la API del backend.

Despliegue

Smithery

Este repositorio incluye smithery.yaml y smithery.json.

  1. Sube el repositorio a GitHub
  2. Crea/añade el servidor en Smithery
  3. Apunta Smithery a este repositorio

Docker / Plataformas de Hosting

Se incluye un Dockerfile para Railway, Fly.io y otros hosts de contenedores.

# Railway
railway up

# Fly.io
fly launch
fly deploy

Configura LINKRESCUE_API_BASE_URL y LINKRESCUE_API_KEY en el entorno de tu host.

Arquitectura

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

Este servidor es una capa de traducción entre las llamadas de herramientas MCP y las operaciones de la API de LinkRescue.

Licencia

MIT — Creado por Freedom Engineers

Relacionados

Variantes Adicionales del README

  • Versión enfocada en desarrolladores: README.dev.md
  • Versión enfocada en marketplace: README.marketplace.md