LinkRescue

Servidor MCP que expõe as capacidades de escaneamento de links quebrados, monitoramento e sugestão de correção do LinkRescue para agentes de IA (Claude, Cursor, etc.).

Documentação

Servidor MCP LinkRescue

PyPI License: MIT MCPize

Encontre links de afiliados quebrados rapidamente, priorize pelo impacto e gere sugestões de correção que seu agente de IA pode executar.

Uma chamada. Mais de 38 redes de afiliados verificadas. Perda de receita estimada.

Instalação em um clique: Instalar no MCPize | pip install linkrescue-mcp

O LinkRescue MCP expõe fluxos de trabalho de verificação, monitoramento e correção de links quebrados por meio do Model Context Protocol (MCP), para que ferramentas como Claude e Cursor possam executar operações de saúde de links diretamente.

O Que Você Obtém

  • check_broken_links: verifique uma URL (ou sitemap) e retorne um relatório estruturado de links quebrados
  • monitor_links: configure monitoramento recorrente para um site
  • get_fix_suggestions: gere recomendações de correção priorizadas
  • health_check: verifique a conectividade do servidor MCP e da API de backend

Se a API de backend do LinkRescue estiver inacessível, o servidor usa dados simulados realistas para que testes locais e demonstrações continuem funcionando.

Início Rápido

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

Depois, pergunte ao seu agente de IA:

"Verifique example.com para links de afiliados quebrados"

Grátis vs Pro

FerramentaGrátisPro ($19/mês)Agência ($29/mês)
health_checkSimSimSim
check_broken_links (até 50 páginas)SimSimSim
check_broken_links (até 2.000 páginas)-SimSim
check_broken_links (ilimitado + rastreamento de sitemap)--Sim
get_fix_suggestions-SimSim
monitor_links (diário)-SimSim
monitor_links (por hora + webhooks)--Sim
Estimativas de perda de receita-SimSim
Monitoramento multi-site-5 sites25 sites

O plano gratuito oferece verificações de links quebrados em uma única página. O Pro desbloqueia o rastreador completo + sugestões de correção + monitoramento recorrente. O Agência adiciona verificações por hora, webhooks e contagem ilimitada de sites.

Atualize para Pro no MCPize — $19/mês ou $190/ano. Agência $29/mês ou $290/ano.

Instalação

MCPize (Recomendado)

Instalação em um clique com hospedagem gerenciada: Instalar no MCPize

PyPI

pip install linkrescue-mcp
linkrescue-mcp

A partir do código-fonte

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

Configuração

VariávelDescriçãoPadrão
LINKRESCUE_API_BASE_URLURL base para a API do LinkRescuehttp://localhost:3000/api/v1
LINKRESCUE_API_KEYChave de API para requisições autenticadasvazio

Exemplo:

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

Obtenha uma chave de API em linkrescue.io/settings/api (somente nos planos Pro e Agência).

Opções de Execução

Execute pelo ponto de entrada instalado:

linkrescue-mcp

Execute diretamente do código-fonte:

python main.py

Execute via CLI do FastMCP:

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

Conecte um Cliente MCP

Claude Desktop

Adicione isto ao claude_desktop_config.json:

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

Claude Code

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

Experimente

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 e Saídas das Ferramentas

check_broken_links

Entradas:

  • url (obrigatório): URL do site a ser verificado
  • sitemap_url (opcional, plano Agência): rastrear a partir do sitemap
  • max_depth (opcional, padrão 3): profundidade do rastreamento

Retorna metadados da verificação, detalhes dos links quebrados e estatísticas resumidas. Os planos Pro e Agência incluem estimativa de perda mensal de receita para links de afiliados quebrados.

monitor_links

Entradas:

  • url (obrigatório)
  • frequency_hours (opcional, padrão 24; o plano Agência suporta 1)

Retorna ID do monitoramento, detalhes do agendamento e status. O plano gratuito retorna um monitor simulado (sem persistência).

get_fix_suggestions

Entrada:

  • relatório completo de check_broken_links, ou
  • array bruto de broken_links, ou
  • string JSON de qualquer um dos formatos

Retorna ações priorizadas e etapas de correção sugeridas. Somente nos planos Pro e Agência.

health_check

Sem entrada. Retorna o status do servidor e a acessibilidade da API de backend.

Implantação

Smithery

Este repositório inclui smithery.yaml e smithery.json.

  1. Envie o repositório para o GitHub
  2. Crie/adicione o servidor no Smithery
  3. Aponte o Smithery para este repositório

Docker / Plataformas de Hospedagem

Um Dockerfile está incluído para Railway, Fly.io e outros hosts de contêineres.

# Railway
railway up

# Fly.io
fly launch
fly deploy

Defina LINKRESCUE_API_BASE_URL e LINKRESCUE_API_KEY no ambiente do seu host.

Arquitetura

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

Este servidor é uma camada de tradução entre chamadas de ferramentas MCP e operações da API do LinkRescue.

Licença

MIT — Construído por Freedom Engineers

Relacionados

Variantes Adicionais do README

  • Versão focada em desenvolvedores: README.dev.md
  • Versão focada em marketplace: README.marketplace.md