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.).

GitHub

Documentación

Servidor MCP de LinkRescue

Encuentra enlaces de afiliados rotos rápidamente, prioriza por impacto y genera sugerencias de corrección en las que tu agente de IA puede actuar.

Una llamada. Más de 38 redes de afiliados verificadas. Fallos de seguimiento silenciosos detectados.

Instalación en 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 Protocolo de Contexto de Modelo (MCP), para que herramientas como Claude y Cursor puedan ejecutar operaciones de salud de enlaces directamente.

Lo que obtienes

check_broken_links: escanea una URL (o un 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 de la API del backend

Si la API del backend de LinkRescue no está disponible, las herramientas generan un error que nombra el endpoint al que no pudieron acceder. Nunca devuelven hallazgos inventados. Para pruebas locales, establece LINKRESCUE_DEMO_MODE=1 para obtener datos de muestra: cada payload simulado incluye "simulated": true y una advertencia explícita.

Endpoint alojado (sin instalación)

LinkRescue ejecuta un servidor MCP remoto en https://www.linkrescue.io/api/mcp (HTTP transmisible). Obtén una clave de API gratuita en linkrescue.io/signup y luego apunta cualquier cliente MCP compatible con remoto hacia él:

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

El servidor alojado expone check_links, start_site_scan, get_scan y get_fix_suggestions. Nunca devuelve datos simulados. El paquete stdio a continuación es para uso local y sin conexión.

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

Herramienta	Gratis	Pro	Agencia
`health_check`	Sí	Sí	Sí
`check_broken_links` (hasta 50 páginas)	Sí	Sí	Sí
`check_broken_links` (hasta 2,000 páginas)	-	Sí	Sí
`check_broken_links` (ilimitado + rastreo de sitemap)	-	-	Sí
`get_fix_suggestions`	-	Sí	Sí
`monitor_links` (diario)	-	Sí	Sí
`monitor_links` (cada hora + webhooks)	-	-	Sí
Monitoreo de múltiples sitios	-	5 sitios	25 sitios

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

Los precios actuales están en linkrescue.io/pricing — esa página es la única fuente de verdad. Instalar en MCPize.

Instalación

MCPize (Recomendado)

Instalación en un clic con alojamiento 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 de MCP:

http://localhost:8000/mcp

Configuración

Variable	Descripción	Predeterminado
`LINKRESCUE_API_BASE_URL`	URL base para la API de LinkRescue	`https://www.linkrescue.io/api/v1`
`LINKRESCUE_API_KEY`	Clave de API para solicitudes autenticadas	vacío
`LINKRESCUE_DEMO_MODE`	Devuelve datos de muestra etiquetados en lugar de generar un error cuando la API no está disponible. Desactivado por defecto: nunca lo actives contra un sitio real.	vacío (desactivado)

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 de API en linkrescue.io/settings/api (solo niveles Pro y Agencia).

Opciones de ejecución

Ejecuta a través del punto de entrada instalado:

linkrescue-mcp

Ejecuta directamente desde el código fuente:

python main.py

Ejecuta a través de la CLI de FastMCP:

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

Conecta 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 las herramientas

`check_broken_links`

Entradas:

url (obligatorio): URL del sitio a escanear
sitemap_url (opcional, nivel Agencia): rastrear desde sitemap
max_depth (opcional, predeterminado 3): profundidad de rastreo

Devuelve metadatos del escaneo, detalles de enlaces rotos y estadísticas de resumen. Los enlaces de afiliados que se resuelven pero han perdido sus parámetros de seguimiento se reportan como exposición: un recuento de enlaces que no generan ingresos al hacer clic. LinkRescue no estima ingresos perdidos; multiplícalo por tu propio RPM.

`monitor_links`

Entradas:

url (obligatorio)
frequency_hours (opcional, predeterminado 24; el nivel Agencia admite 1)

Devuelve el ID de monitoreo, los detalles del programa y el estado. El nivel gratuito devuelve un monitor simulado (sin persistencia).

`get_fix_suggestions`

Entrada:

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

Devuelve acciones priorizadas y pasos de corrección sugeridos. Solo niveles Pro y Agencia.

`health_check`

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

Implementación

Smithery

Este repositorio incluye smithery.yaml y smithery.json.

Sube el repositorio a GitHub
Crea/añade el servidor en Smithery
Apunta Smithery a este repositorio

Docker / Plataformas de alojamiento

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

# Railway
railway up

# Fly.io
fly launch
fly deploy

Establece 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

SelfHeal MCP — Proxy de autocuración para servidores MCP
SiteHealth MCP — Auditoría completa de salud de sitios web
LeadEnrich MCP — Enriquecimiento de leads en cascada

Variantes adicionales del README

Versión centrada en desarrolladores: README.dev.md
Versión centrada en el mercado: README.marketplace.md