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

GitHub

Documentação

Servidor MCP LinkRescue

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

Uma chamada. Mais de 38 redes de afiliados verificadas. Falhas silenciosas de rastreamento detectadas.

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

O LinkRescue MCP expõe fluxos de trabalho de varredura, 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: escaneie 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 priorizadas de correção
health_check: verifique a conectividade do servidor MCP e da API de backend

Se a API de backend do LinkRescue estiver inacessível, as ferramentas geram um erro nomeando o endpoint que não conseguiram alcançar. Elas nunca retornam resultados inventados. Para testes locais, defina LINKRESCUE_DEMO_MODE=1 para obter dados de exemplo — cada payload simulado carrega "simulated": true e um aviso explícito.

Endpoint hospedado (sem instalação)

O LinkRescue executa um servidor MCP remoto em https://www.linkrescue.io/api/mcp (HTTP streamable). Obtenha uma chave de API gratuita em linkrescue.io/signup e aponte qualquer cliente MCP com suporte remoto para ele:

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

O servidor hospedado expõe check_links, start_site_scan, get_scan e get_fix_suggestions. Ele nunca retorna dados simulados. O pacote stdio abaixo é para uso local e offline.

Início Rápido

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

Depois pergunte ao seu agente de IA:

"Escaneie example.com em busca de links de afiliados quebrados"

Grátis vs Pro

Ferramenta	Grátis	Pro	Agência
`health_check`	Sim	Sim	Sim
`check_broken_links` (até 50 páginas)	Sim	Sim	Sim
`check_broken_links` (até 2.000 páginas)	-	Sim	Sim
`check_broken_links` (ilimitado + rastreamento de sitemap)	-	-	Sim
`get_fix_suggestions`	-	Sim	Sim
`monitor_links` (diário)	-	Sim	Sim
`monitor_links` (por hora + webhooks)	-	-	Sim
Monitoramento multi-site	-	5 sites	25 sites

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

Os preços atuais estão em linkrescue.io/pricing — essa página é a fonte única da verdade. Instalar no MCPize.

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ável	Descrição	Padrão
`LINKRESCUE_API_BASE_URL`	URL base para a API do LinkRescue	`https://www.linkrescue.io/api/v1`
`LINKRESCUE_API_KEY`	Chave de API para requisições autenticadas	vazio
`LINKRESCUE_DEMO_MODE`	Retorna dados de exemplo rotulados em vez de erro quando a API está inacessível. Desativado por padrão — nunca ative contra um site real.	vazio (desativado)

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

Conectar um Cliente MCP

Claude Desktop

Adicione isto a 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 escaneado
sitemap_url (opcional, plano Agência): rastrear a partir do sitemap
max_depth (opcional, padrão 3): profundidade do rastreamento

Retorna metadados da varredura, detalhes de links quebrados e estatísticas resumidas. Links de afiliados que resolvem mas perderam seus parâmetros de rastreamento são relatados como exposição — uma contagem de links que não geram receita quando clicados. O LinkRescue não estima receita perdida; multiplique pelo seu próprio RPM.

`monitor_links`

Entradas:

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

Retorna ID de 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 sugeridas de correção. Somente planos Pro e Agência.

`health_check`

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

Implantação

Smithery

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

Envie o repositório para o GitHub
Crie/adicione o servidor no Smithery
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 — Criado por Freedom Engineers

Relacionados

SelfHeal MCP — Proxy de autocorreção para servidores MCP
SiteHealth MCP — Auditoria completa de saúde de sites
LeadEnrich MCP — Enriquecimento de leads em cascata

Variantes Adicionais do README

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