{"id":26246708,"url":"https://github.com/pericena/portscanner","last_synced_at":"2026-04-06T06:02:45.281Z","repository":{"id":270872676,"uuid":"909858165","full_name":"Pericena/PortScanner","owner":"Pericena","description":"Herramienta PortScanner - Análisis de Vulnerabilidades con Inteligencia Artificial","archived":false,"fork":false,"pushed_at":"2025-04-28T00:51:45.000Z","size":1107,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-15T18:41:12.064Z","etag":null,"topics":["nmap-scan","nmap-scan-script","openia","termux","termux-hacking"],"latest_commit_sha":null,"homepage":"https://lpericena.blogspot.com/","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Pericena.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["Pericena"],"paypal":"https://www.paypal.com/paypalme/lpericena","binance":198690745,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"custom":["https://lpericena.blogspot.com/","https://github.com/sponsors/Pericena"]}},"created_at":"2024-12-29T23:28:14.000Z","updated_at":"2025-04-28T00:51:51.000Z","dependencies_parsed_at":null,"dependency_job_id":"317d5518-33f2-40ef-ac66-1e4938a3dbb8","html_url":"https://github.com/Pericena/PortScanner","commit_stats":null,"previous_names":["pericena/portscanner"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Pericena/PortScanner","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pericena%2FPortScanner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pericena%2FPortScanner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pericena%2FPortScanner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pericena%2FPortScanner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Pericena","download_url":"https://codeload.github.com/Pericena/PortScanner/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pericena%2FPortScanner/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31461534,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T21:22:52.476Z","status":"online","status_checked_at":"2026-04-06T02:00:07.287Z","response_time":112,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["nmap-scan","nmap-scan-script","openia","termux","termux-hacking"],"created_at":"2025-03-13T13:19:55.110Z","updated_at":"2026-04-06T06:02:45.265Z","avatar_url":"https://github.com/Pericena.png","language":"HTML","funding_links":["https://github.com/sponsors/Pericena","https://www.paypal.com/paypalme/lpericena",198690745,"https://lpericena.blogspot.com/"],"categories":[],"sub_categories":[],"readme":"# PortScanner - Análisis de Vulnerabilidades con Inteligencia Artificial\n\nBienvenido a **PortScanner**, una herramienta de análisis de vulnerabilidades de puertos desarrollada en Python con Flask, integrada con tecnologías avanzadas como OpenAI y Nmap. Este sistema web está diseñado para realizar escaneos profundos de puertos, identificar posibles vulnerabilidades, y generar reportes detallados. Funciona en Windows, Linux y Termux.\n\n## Características Principales\n\n- **Inteligencia Artificial**: Uso de OpenAI para analizar y clasificar las vulnerabilidades detectadas.\n- **Integración con Nmap**: Escaneos potentes y fiables.\n- **Compatibilidad Multiplataforma**: Funciona en Windows, Linux y Termux.\n- **Sistema Web Interactivo**: Interfaz amigable y fácil de usar.\n- **Reportes Detallados**: Generación de reportes en tiempo real con gráficos y análisis.\n- **Código Abierto**: Totalmente gratuito y accesible.\n\n---\n\n## Capturas de Pantalla\n\n### Panel Principal\n![Captura de la Interfaz Principal](https://raw.githubusercontent.com/Pericena/PortScanner/refs/heads/main/screencapture/screencapture-127-0-0-1-5200-2024-12-29-19_29_35.png)\n\n### Reporte de Vulnerabilidades\n![Reporte de Vulnerabilidades](https://raw.githubusercontent.com/Pericena/PortScanner/refs/heads/main/screencapture/screencapture-127-0-0-1-5200-scan-2024-12-29-19_33_20.png)\n\n---\n\n## Instalación\n\n### Requisitos Previos\n1. Python 3.8 o superior\n2. Flask\n3. Nmap instalado en el sistema\n4. Acceso a internet para utilizar OpenAI\n\n### Instalación\n\n1. Clona el repositorio:\n   ```bash\n   git clone https://github.com/Pericena/PortScanner.git\n   cd PortScanner\n   ```\n\n2. Instala las dependencias:\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n   Asegúrate de que `requirements.txt` incluye lo siguiente:\n   ```text\n   Flask\n   nmap\n   openai\n   pyyaml\n   ```\n\n3. Configura las credenciales de OpenAI:\n   - Crea un archivo `.env` en el directorio raíz.\n   - Añade tu clave de API de OpenAI:\n   - https://cookbook.openai.com/\n   - https://platform.openai.com/settings/organization/general\n   - https://platform.openai.com/settings/organization/general\n     ```\n     OPENAI_API_KEY=tu_clave_api\n     ```\n\n4. Inicia el servidor:\n   ```bash\n   python app.py\n   ```\n\n5. Accede a la aplicación desde tu navegador en [http://localhost:5000](http://localhost:5000).\n\n---\n\n# Instrucciones para levantar el Docker\n\n## Prerrequisitos\n\nAsegúrate de que tienes Docker y Docker Compose instalados en tu máquina:\n\n- [Docker](https://www.docker.com/)\n- [Docker Compose](https://docs.docker.com/compose/)\n\n---\n\n## Pasos rápidos para levantar el proyecto\n\n### 1. **Construir y correr el contenedor**\n\nDesde la raíz del proyecto (donde están el `Dockerfile` y `docker-compose.yml`), ejecuta este comando:\n\n```bash\ndocker-compose up -d\n```\n\nEste comando:\n- Construirá la imagen Docker automáticamente.\n- Levantará el contenedor y lo ejecutará en segundo plano.\n\n---\n\n### 2. **Acceder a la aplicación**\n\n- Una vez levantado el contenedor, abre tu navegador y ve a:  \n  **[http://localhost](http://localhost)**\n\n---\n\n### 3. **Detener el contenedor**\n\nPara detener el contenedor, utiliza este comando:\n\n```bash\ndocker-compose down\n```\n\n---\n\n### 4. **Reiniciar el contenedor con cambios**\n\nSi realizas modificaciones al código, reconstruye y reinicia el contenedor con:\n\n```bash\ndocker-compose up -d --build\n```\n\n---\n\n## Uso\n\n1. Selecciona el rango de IP o dominio a analizar.\n2. Configura las opciones de escaneo (puertos específicos, velocidad, etc.).\n3. Ejecuta el escaneo y revisa los resultados.\n4. Genera reportes detallados con un clic.\n\n---\n\n\n## Redes Sociales\n\n- **Blog**: [lpericena.blogspot.com](https://lpericena.blogspot.com)\n- **GitHub**: [Pericena](https://github.com/Pericena)\n- **Twitter**: [@LuishinioP](https://twitter.com/LuishinioP)\n\n---\n\n## Licencia\n\nEste proyecto está licenciado bajo la Licencia MIT. Consulta el archivo `LICENSE` para más detalles.\n\n---\n\n## Apoya el Proyecto\n\n- Dale una ⭐ al repositorio para apoyar este proyecto.\n- ¡Comparte con otros interesados en ciberseguridad y análisis de vulnerabilidades!\n\n---\n\n## Video de Demostración\n\n[![Video de Demostración](https://www.facebook.com/reel/1695566091061439)](https://www.facebook.com/reel/1695566091061439)\n\n---\n\n## Agradecimientos\n\nAgradecemos a la comunidad de ciberseguridad y desarrolladores por el soporte continuo en herramientas de código abierto.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpericena%2Fportscanner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpericena%2Fportscanner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpericena%2Fportscanner/lists"}