URL de Wayback MCP
Waybackurls MCP es un puente que conecta Waybackurls, una herramienta para recuperar URL históricas de Wayback Machine, con el ecosistema del Protocolo de Contexto de Modelo (MCP).
Descripción general
Waybackurls MCP permite una integración fluida de la capacidad de Waybackurls para descubrir endpoints históricos en aplicaciones compatibles con MCP y sistemas de flujo de trabajo basados en IA. Este puente permite aprovechar Wayback Machine de Internet Archive para encontrar rutas de API olvidadas, endpoints antiguos y URL potencialmente vulnerables mediante un protocolo estandarizado, lo que facilita su incorporación en procesos de pruebas de seguridad automatizadas o funciones de asistentes de IA.
Características
- Integración con Waybackurls para obtener URL históricas de Wayback Machine
- Opción para incluir o excluir subdominios en la búsqueda
- Configuración y puesta en marcha sencillas
- Fácil integración con otras herramientas y sistemas compatibles con MCP
- Manejo estandarizado de entrada/salida
Instalación
Prerrequisitos
- Node.js (v16 o superior)
- Waybackurls instalado en su sistema
Instalación
# Install globally
npm install -g gc-waybackurls-mcp
# Or run directly without installing
npx gc-waybackurls-mcp
Configuración
Este servidor requiere que la ruta al ejecutable Waybackurls se configure a través de la variable de entorno WAYBACKURLS_PATH .
Ejemplo:
# Linux/macOS
export WAYBACKURLS_PATH=/usr/local/bin/waybackurls
# Windows
set WAYBACKURLS_PATH=C:\path\to\waybackurls\waybackurls.exe
Uso
Línea de comandos
# With WAYBACKURLS_PATH environment variable set
npx gc-waybackurls-mcp
Con Claude Desktop
Añade a tu claude_desktop_config.json :
{
"mcpServers": {
"waybackurls": {
"command": "npx",
"args": ["-y", "gc-waybackurls-mcp"],
"env": {
"WAYBACKURLS_PATH": "C:\\path\\to\\waybackurls\\waybackurls.exe"
}
}
}
}
Con otros clientes de MCP
Para otros clientes MCP, puede configurarlos para utilizar este servidor con:
WAYBACKURLS_PATH=/path/to/waybackurls npx gc-waybackurls-mcp
Ejecución de Waybackurls
Una vez configurado, puedes ejecutar Waybackurls a través de la interfaz MCP usando la herramienta do-waybackurls :
// Example of calling Waybackurls through MCP for a domain including subdomains
const result = await mcp.tools.invoke("do-waybackurls", {
target: "example.com",
noSub: false
});
// Example of calling Waybackurls through MCP for a domain excluding subdomains
const resultNoSubs = await mcp.tools.invoke("do-waybackurls", {
target: "example.com",
noSub: true
});
Parámetros
Waybackurls MCP admite los siguientes parámetros:
target : el dominio para el que se recuperarán las URL históricas (obligatorio)noSub : indicador booleano para controlar si se deben incluir los subdominios (predeterminado: falso)
Ejemplos
Recopilar todas las URL históricas
const result = await mcp.tools.invoke("do-waybackurls", {
target: "example.com",
noSub: false
});
Recopilar URL históricas solo para el dominio principal
const result = await mcp.tools.invoke("do-waybackurls", {
target: "example.com",
noSub: true
});
Resultados del proceso para un análisis posterior
const result = await mcp.tools.invoke("do-waybackurls", {
target: "example.com"
});
// Split the results into individual URLs
const urls = result.content[0].text.trim().split('\n');
// Filter for specific file types or patterns
const jsFiles = urls.filter(url => url.endsWith('.js'));
const apiEndpoints = urls.filter(url => url.includes('/api/'));
Integración con asistentes de IA
Waybackurls MCP está diseñado para funcionar sin problemas con asistentes de IA que admiten el Protocolo de contexto de modelo, lo que permite interacciones en lenguaje natural para tareas de reconocimiento y pruebas de seguridad.
Ejemplo de conversación con un asistente de IA:
User: Find historical URLs for example.com
AI: I'll retrieve historical URLs for example.com using the Wayback Machine.
[AI uses Waybackurls MCP to fetch the URLs and returns the results]
I found the following interesting historical endpoints for example.com:
- Several old API endpoints: /api/v1/users, /api/v2/products
- Previously accessible admin pages: /admin/dashboard, /admin/users
- Backup files: /backup/db.sql, /backup/config.old
...
Consideraciones de seguridad
- Esta herramienta está diseñada para investigaciones y pruebas de seguridad legítimas.
- Obtenga siempre la autorización adecuada antes de escanear sitios web
- Úselo de manera responsable y ética
- La herramienta sólo recupera información ya archivada públicamente por Internet Archive
Solución de problemas
Si encuentra problemas:
- Verifique que Waybackurls esté correctamente instalado y accesible
- Verifique la ruta al ejecutable Waybackurls en su configuración
- Asegúrese de que se establezcan los permisos adecuados para la ejecución
- Revise los registros del servidor para ver mensajes de error detallados
- Algunos dominios pueden tener un historial limitado o nulo en Wayback Machine
Consejos de uso
- Combine los resultados de Waybackurls con otras herramientas de reconocimiento para obtener información más completa sobre los objetivos.
- Filtrar los resultados para centrarse en tipos de archivos o directorios específicos de interés
- Busque patrones en URL históricas que puedan indicar funciones abandonadas o puntos finales de prueba
- Utilice los resultados para fundamentar sus pruebas de seguridad o la búsqueda de recompensas por errores.
Licencia
Apache-2.0
Expresiones de gratitud