URL Tracker v0.5.0

URL Tracker es una aplicación web robusta y escalable diseñada para monitorear y rastrear URLs, registrar cambios y proporcionar información detallada sobre el estado y el comportamiento de varios recursos web. Construida sobre Sails.js, esta aplicación es perfecta para rastrear URLs para el tiempo de actividad, cambios de contenido y monitoreo de rendimiento.

Características

• Monitoreo de URLs: Realiza un seguimiento de varias URLs y monitorea su estado a lo largo del tiempo con la capacidad de añadir una o múltiples URLs por envío.
• Detección de cambios: Detecta y registra cambios en el contenido de las URLs rastreadas.
• Solicitudes automáticas: Programa y automatiza solicitudes a las URLs para verificar su estado periódicamente (cada hora, día, semana, mes).
• Registros detallados: Almacena y visualiza registros de cambios de URL y estados de solicitudes.
• Inicio de sesión de usuario: Usa correo electrónico y contraseña para iniciar sesión.
• Notificaciones: Envía notificaciones basadas en eventos específicos como cambios de contenido en un bot de Telegram.

Cómo funciona

URL Tracker funciona enviando solicitudes HTTP a las URLs especificadas en intervalos regulares. Compara el contenido de la respuesta con resultados anteriores y registra cualquier diferencia. La aplicación puede ampliarse con notificaciones personalizadas, procesamiento de datos y más, lo que la hace versátil para diversos casos de uso.

Credenciales por defecto

En la configuración inicial, la aplicación viene con credenciales de administrador por defecto:

• Nombre de usuario: [email protected]
• Contraseña: 9TMhdaUSEzksEXF

IMPORTANTE: Por razones de seguridad, se recomienda encarecidamente que cambie estas credenciales por defecto inmediatamente después de iniciar sesión. Puede hacerlo a través de la interfaz de gestión de usuarios dentro de la aplicación.

Cómo usar

Si desea rastrear cambios en una página web, siga estos pasos (Debe haber iniciado sesión):

1. Agregar nuevo enlace: Haga clic en el botón "Add New Link" en el lado derecho.
2. Rellene la descripción: Introduzca texto en el cuadro de descripción que describa el objetivo, por ejemplo, "Página de inicio de sesión del sistema interno de Uber".
3. Introduzca el enlace objetivo: Escriba el enlace objetivo en el cuadro de texto "Link of page", por ejemplo, http://s3.amazonaws.com/careemcrm/. También puede añadir múltiples enlaces.
4. Especifique palabras clave: Introduzca las palabras clave que se rastrearán en la página en el cuadro de texto "Keywords". Si aparecen estas palabras clave, se le notificará (por ejemplo, "404", "nueva característica", "no encontrado"). Nota: Estas palabras clave NO deben estar presentes en la primera solicitud.
5. Autentíquese si es necesario: Si desea rastrear una página autenticada, añada sus cookies en el cuadro de texto "Cookie".
6. Seleccione el período de verificación: Elija el período en el que desea verificar la página.
7. Establezca la tolerancia: En el cuadro de texto "Tolerance", establezca las diferencias aceptadas entre la obtención anterior y la siguiente por caracteres (por ejemplo, 100). Nota: Si desea ignorar cambios menores como tokens CSRF, tokens de caché o seguimiento de cookies, establezca este parámetro. Si se deja en blanco, el servidor comparará dos solicitudes y almacenará las diferencias en la base de datos como acceptedChange.
8. Agregue el enlace: Haga clic en el botón "Add Link". Debería ver el nuevo objetivo en la lista de URLs.

Configuración del bot de Telegram para notificaciones

Para recibir notificaciones a través de Telegram:

1. Cree un bot de Telegram: Use BotFather para crear un nuevo bot en Telegram.
2. Obtenga el token del bot: Después de crear el bot, recibirá un token de BotFather. Guarde este token.
3. Obtenga su ID de chat: Inicie un chat con su bot y luego use una API como https://api.telegram.org/bot<YourBOTToken>/getUpdates para recuperar su ID de chat.
4. Configure el bot en la aplicación:
   • Vaya a la configuración de su aplicación (http://127.0.0.1:1337/settings) e introduzca el token del bot y el ID de chat.
   • Habilite las notificaciones de Telegram.
5. Reciba notificaciones: Ahora recibirá alertas y notificaciones de URL Tracker a través de Telegram.

Configuración

Prerrequisitos

Antes de comenzar, asegúrese de tener instalado lo siguiente en su máquina local:

• Node.js (versión 16.x o superior)
• MongoDB
• Docker (en caso de usarlo en un contenedor)
• Git

Clonar el repositorio

Comience clonando el repositorio en su máquina local:

git clone https://github.com/ahussam/url-tracker.git
cd url-tracker

Instalar dependencias

Después de clonar el repositorio, instale las dependencias necesarias:

npm install

Ejecutar la aplicación

Puede iniciar la aplicación en modo de desarrollo usando:

sails lift

Esto iniciará el servidor Sails.js en el puerto definido en su archivo .env.

Configuración con Docker

Para un entorno consistente, puede ejecutar el proyecto URL Tracker usando Docker.

Cambiar MONGO_URL en el archivo .env

Cambie MONGO_URL a mongodb://mongodb:27017/url-tracker.

Construir la imagen Docker

Para construir la imagen Docker, ejecute:

docker build -t url-tracker .

Ejecutar el contenedor Docker

Para iniciar la aplicación usando Docker:

docker run -p 1337:1337 url-tracker

O usando docker-compose

docker-compose build 
docker-compose up 

Este comando mapea el puerto 1337 del contenedor al puerto 1337 de su máquina local. Acceda a la aplicación navegando a http://localhost:1337 en su navegador.

Capturas de pantalla

Licencia

The MIT License (MIT)

Copyright (c) 2024 Abdullah Hussam

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Contribuciones

¡Las contribuciones son bienvenidas! No dude en enviar un Pull Request.

Soporte

Para soporte, abra un issue en GitHub.