{"id":25811467,"url":"https://github.com/techatlasdev/securityspy","last_synced_at":"2025-02-28T00:52:43.830Z","repository":{"id":222398536,"uuid":"745665816","full_name":"TechAtlasDev/SecuritySpy","owner":"TechAtlasDev","description":"Un scraper diseñado para obtener datos de Shodan que la API ofrece, lo que permite obtener múltiples datos de manera gratuita.","archived":false,"fork":false,"pushed_at":"2025-01-04T23:07:08.000Z","size":4959,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-05T00:17:57.105Z","etag":null,"topics":["analytics","bs4","bs4-shodan","cybersecurity","education","facets","hacking","pentesting","python","scraper","shodan","shodan-api","shodan-bypass","shodan-cli","shodan-client","shodan-python","shodan-scripts","shodan-tool"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TechAtlasDev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2024-01-19T20:37:04.000Z","updated_at":"2025-01-04T23:07:11.000Z","dependencies_parsed_at":"2024-02-14T01:25:39.718Z","dependency_job_id":"4ca8f3dd-f7bb-47c4-abb0-1112bafbcc54","html_url":"https://github.com/TechAtlasDev/SecuritySpy","commit_stats":null,"previous_names":["techatlasdev/prl412","techatlasdev/securityspy"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TechAtlasDev%2FSecuritySpy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TechAtlasDev%2FSecuritySpy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TechAtlasDev%2FSecuritySpy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TechAtlasDev%2FSecuritySpy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TechAtlasDev","download_url":"https://codeload.github.com/TechAtlasDev/SecuritySpy/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241081198,"owners_count":19906462,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["analytics","bs4","bs4-shodan","cybersecurity","education","facets","hacking","pentesting","python","scraper","shodan","shodan-api","shodan-bypass","shodan-cli","shodan-client","shodan-python","shodan-scripts","shodan-tool"],"created_at":"2025-02-28T00:52:43.207Z","updated_at":"2025-02-28T00:52:43.795Z","avatar_url":"https://github.com/TechAtlasDev.png","language":"Python","readme":"![Image](securityspy.png)\n---\n\n\u003ccenter\u003e\u003ch1\u003eSecurity Spy 💣\u003c/h1\u003e\u003c/center\u003e\n\n⚠️ Este sistema fué desarrollado \u003cb\u003eúnicamente por fines educativos\u003c/b\u003e, no me hago responsable por el el uso inadecuado y poco ético de quien lo use. \n\n## Descripción 📝\n\nSecurity Spy es un proyecto que se encarga de realizar \u003cb\u003econsultas a la página web oficial de Shodan\u003c/b\u003e por medio del método GET a las facetas, con el objetivo de obtener hasta 1000 datos por cada consulta que se haga, lo que resulta ser una \u003ci\u003ealternativa a la API\u003c/i\u003e de consultas de Shodan, facilitando la obtención de datos que en un momento, solo se podían obtener usando una API KEY.\n\n\u003cpre\u003e\u003ccode\u003e\nusage: Security Spy [-h] [--query QUERY] [--limit LIMIT] [--facet FACET]\n              [--template TEMPLATE] [-ip IP] [--output OUTPUT] [--api_key API_KEY]\n\nSecurity Spy es un script diseñado para realizar consultas al sistema de Shodan a través\nde un Bypass que scrapea el apartado de las facetas, lo cual obtiene los mismos\ndatos que en la API oficial.\n\noptions:\n  -h, --help            show this help message and exit\n  --query QUERY, -q QUERY\n                        Realizar una consulta a través del Bypass.\n  --limit LIMIT, -l LIMIT\n                        Indica un límite de datos que se procesarán por consulta.\n                        (max: 1000) (default: 30)\n  --facet FACET, -f FACET\n                        Los datos que va a buscar. (default: ip)\n  --template TEMPLATE, -T TEMPLATE\n                        Indica una plantilla para mostrar los resultados.\n  -ip IP                Realizar una consulta de la dirección IP usando la API\n                        oficial.\n  --output OUTPUT, -o OUTPUT\n                        Indica el formato en el que se va a mostrar el contenido.\n  --api_key API_KEY     Clave de API para realizar consultas.\n\u003c/code\u003e\u003c/pre\u003e\n\n## Objetivos 🎯\n\nCrear una alternativa gratuita a la \u003cb\u003eAPI de Shodan\u003c/b\u003e, por medio de un scraper que recolecta información a través de las facetas que éste ofrece a través de su \u003ca href=\"https://www.shodan.io/search/facet\"\u003epágina web de facetas\u003c/a\u003e, lo que permite obtener exactamente los mismos datos que se obtiene al realizar una \u003cb\u003econsulta a la API de Shodan\u003c/b\u003e, buscando fomentar el análisis en la seguridad informática, teniendo la capacidad de realizar consultas ilimitadas obteniendo hasta 1000 datos por consulta.\n\n## Funcionalidades 💡\n\nEl sistema Security Spy cuenta con dos funcionalidades principales que buscan un enfoque gratuito y de calidad:\n- \u003cb\u003eIPQuery:\u003c/b\u003e Un sistema que se encarga de realizar consultas a la API de shodan (Es gratuito) con la API KEY del usuario.\n- \u003cb\u003eSearch:\u003c/b\u003e Un scraper que realiza la consulta automáticamente a la página de las facetas de shodan.\n\n## Requisitos 🛠️\n\n- \u003ccode\u003eshodan\u003c/code\u003e Librería para la interacción con la API de Shodan.\n- \u003ccode\u003erich\u003c/code\u003e Librería para enviar mensajes con una estéticos.\n- \u003ccode\u003ebs4\u003c/code\u003e Librería para el procesamiento de código HTML.\n\n## Instalación 💻\n\nPara instalar correctamente el script, sigue los siguientes pasos:\n\n1) Clonar este repositorio:\n    - \u003ccode\u003egit clone https://github.com/TechAtlasDev/SecuritySpy\u003c/code\u003e\n\n\u003cbr\u003e\n\n2) Entrar al directorio:\n    - \u003ccode\u003ecd Security Spy\u003c/code\u003e\n\n\u003cbr\u003e\n\n3) Instalar python si no lo tienes instalado:\n    - Para Ubuntu: \u003ccode\u003esudo apt install python3 -y\u003c/code\u003e\n    - Para Termux: \u003ccode\u003eapt install python3 -y\u003c/code\u003e\n\n\u003cbr\u003e\n\n4) Instalar las dependencias y configurar el sistema Security Spy:\n    - El setup es tan simple como poner el siguiente comando: \u003ccode\u003ebash setup.sh\u003c/code\u003e\n\n\u003cbr\u003e\n\n5) Brindarle permisos de ejecución al sistema:\n    - \u003ccode\u003echmod +x src/Security Spy\u003c/code\u003e\n\n## Compatibilidad 🔨\n\n|   Entorno   | Es compatible | Probado en |\n|:------------:|:------------:|:------------:|\n|   Windows   |   ❌   |   ❌   |\n|   Linux     |   ✅   |   ✅   |\n|   Termux    |   ✅   |   ✅   |\n\n## Idiomas 🗣️\n\n|   Idioma   | Disponibilidad |\n|:------------:|:------------:|\n|   Español   |   ✅   |\n|   Ingles     |   ❌   |\n\n## Screenshot 📸\n![Image](screenshot_sample.png)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechatlasdev%2Fsecurityspy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftechatlasdev%2Fsecurityspy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftechatlasdev%2Fsecurityspy/lists"}