{"_id":"rav-xss","_rev":"63-5e9273c7d18f5605aba62a0941db2cba","name":"rav-xss","dist-tags":{"latest":"1.0.34"},"versions":{"1.0.28":{"name":"rav-xss","version":"1.0.28","keywords":["xss","security","bug-bounty","scanner","reflected-xss","rav-xss","ravenastar"],"author":{"name":"RavenaStar"},"license":"MIT","_id":"rav-xss@1.0.28","maintainers":[{"name":"ravenastar","email":"ravenastar.js@gmail.com"}],"bin":{"rav-xss":"src/index.js"},"dist":{"shasum":"e6b6cda1647a6fed5185da436af0e1e379c2c6bc","tarball":"https://registry.npmjs.org/rav-xss/-/rav-xss-1.0.28.tgz","fileCount":22,"integrity":"sha512-dRPsNtZ1w3pZRLnfWa45vCi6zLObLXGouA1tqaXpt0qzm+Ky94+Rv3A6QYEoSGyXUp9dNPGz4pbNTaqGNDyyMQ==","signatures":[{"sig":"MEUCIE95ffs10bYdNgSJhRfJL+q7+juU1JilMpvKE/NBRlxSAiEAsbe6lDQu6Rtr3ajBA0QYmZqRoz2+JUsC8vIhZcPi4l8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1433488},"main":"src/index.js","gitHead":"7fbb74f63d8e0ed94af3f99247a4aaf3ae2471df","scripts":{"dev":"node src/index.js --verbose","scan":"node src/index.js","configure":"node src/index.js --configure"},"_npmUser":{"name":"ravenastar","email":"ravenastar.js@gmail.com"},"_npmVersion":"10.8.2","description":"⚙️ CLI/NPM | RAV XSS | 🎯 Basic Reflected XSS scanner for bug bounty programs.","directories":{},"_nodeVersion":"18.20.8","dependencies":{"ora":"^5.4.1","open":"^8.4.2","axios":"^1.6.2","boxen":"^5.1.2","chalk":"^4.1.2","figlet":"^1.7.0","inquirer":"^8.2.6"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/rav-xss_1.0.28_1778178162665_0.2913025632956807","host":"s3://npm-registry-packages-npm-production"}},"1.0.29":{"name":"rav-xss","version":"1.0.29","keywords":["xss","security","bug-bounty","scanner","reflected-xss","rav-xss","ravenastar"],"author":{"name":"RavenaStar"},"license":"MIT","_id":"rav-xss@1.0.29","maintainers":[{"name":"ravenastar","email":"ravenastar.js@gmail.com"}],"bin":{"rav-xss":"src/index.js"},"dist":{"shasum":"69031c6b6176bd6f38814e3e112b935b7d4d30dc","tarball":"https://registry.npmjs.org/rav-xss/-/rav-xss-1.0.29.tgz","fileCount":23,"integrity":"sha512-aoM5OSgmRFViVcPlYMJASX+vGflhC9m74Sy89Grs5UtbnNHTY+8zxnmciXHbBMb2gOGAXpyesKT2GUWWYKxJcA==","signatures":[{"sig":"MEQCID3ih64QddwsFfzy1pvNk245tcc6zH4M42dh8GhQEaRHAiBHiHCSYBh0Tbs73cCqOzHBm29LQMv78gVwMyR3BKEnxw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2332570},"main":"src/index.js","gitHead":"84305391ffb7a19f02216412a61a1ec3dea6b16b","scripts":{"dev":"node src/index.js --verbose","scan":"node src/index.js","configure":"node src/index.js --configure"},"_npmUser":{"name":"ravenastar","email":"ravenastar.js@gmail.com"},"_npmVersion":"10.8.2","description":"⚙️ CLI/NPM | RAV XSS | 🎯 Basic Reflected XSS scanner for bug bounty programs.","directories":{},"_nodeVersion":"18.20.8","dependencies":{"ora":"^5.4.1","open":"^8.4.2","axios":"^1.6.2","boxen":"^5.1.2","chalk":"^4.1.2","figlet":"^1.7.0","inquirer":"^8.2.6"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/rav-xss_1.0.29_1778179551418_0.026668383819339336","host":"s3://npm-registry-packages-npm-production"}},"1.0.30":{"name":"rav-xss","version":"1.0.30","keywords":["xss","security","bug-bounty","scanner","reflected-xss","rav-xss","ravenastar"],"author":{"name":"RavenaStar"},"license":"MIT","_id":"rav-xss@1.0.30","maintainers":[{"name":"ravenastar","email":"ravenastar.js@gmail.com"}],"bin":{"rav-xss":"src/index.js"},"dist":{"shasum":"3ce9104fbb7ac81596fde56fa4122ae2d9421cec","tarball":"https://registry.npmjs.org/rav-xss/-/rav-xss-1.0.30.tgz","fileCount":23,"integrity":"sha512-U37bqhQl1a5yNr5fXD7LMcPbVkflzjyJZNnbYbXWILzt1CgstNQyeulBkpYcn+WzSabgFjYggKlzmn8iJ47ReA==","signatures":[{"sig":"MEUCIFHAvsbTqnmor/4FLYufQAfAocZzMXbS0T/Vcup4CVC3AiEAuaUK60yS9HSEYchfdGjMQ0Z8YQ3xTOr4p1NPLsQt1cE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2334831},"main":"src/index.js","gitHead":"331581995619302bc4aa80deeb193a667d3133a4","scripts":{"dev":"node src/index.js --verbose","scan":"node src/index.js","configure":"node src/index.js --configure"},"_npmUser":{"name":"ravenastar","email":"ravenastar.js@gmail.com"},"_npmVersion":"10.8.2","description":"⚙️ CLI/NPM | RAV XSS | 🎯 Basic Reflected XSS scanner for bug bounty programs.","directories":{},"_nodeVersion":"18.20.8","dependencies":{"ora":"^5.4.1","open":"^8.4.2","axios":"^1.6.2","boxen":"^5.1.2","chalk":"^4.1.2","figlet":"^1.7.0","inquirer":"^8.2.6"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/rav-xss_1.0.30_1778180821925_0.415648018605715","host":"s3://npm-registry-packages-npm-production"}},"1.0.31":{"name":"rav-xss","version":"1.0.31","keywords":["xss","security","bug-bounty","scanner","reflected-xss","rav-xss","ravenastar"],"author":{"name":"RavenaStar"},"license":"MIT","_id":"rav-xss@1.0.31","maintainers":[{"name":"ravenastar","email":"ravenastar.js@gmail.com"}],"homepage":"https://github.com/ravenastar-js/rav-xss#readme","bugs":{"url":"https://github.com/ravenastar-js/rav-xss/issues"},"bin":{"rav-xss":"src/index.js"},"dist":{"shasum":"832c838f33c40e22df5d193b4b5222d2c57b9acb","tarball":"https://registry.npmjs.org/rav-xss/-/rav-xss-1.0.31.tgz","fileCount":23,"integrity":"sha512-ouxMM+nYsmCEwpQo2fJlnd0o+sXuyiejFC+FakSk+ObhJlXegH5P2z3V1r6mJhLXKuyPQPDmdWPD3xngx8t+Gg==","signatures":[{"sig":"MEUCIFYbkm/FxDQDcznOOCNH9vHJNmKGShYtUnNNwkXR5xDAAiEAjyB4TwwjbTZu2A7eGTqcVHkb2B3ZREbiB3u9nuau7vg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2335000},"main":"src/index.js","gitHead":"9ed5c79308d7cb35d7662e9a2699ad29c7e3f961","scripts":{"dev":"node src/index.js --verbose","scan":"node src/index.js","configure":"node src/index.js --configure"},"_npmUser":{"name":"ravenastar","email":"ravenastar.js@gmail.com"},"repository":{"url":"git+https://github.com/ravenastar-js/rav-xss.git","type":"git"},"_npmVersion":"10.8.2","description":"⚙️ CLI/NPM | RAV XSS | 🎯 Basic Reflected XSS scanner for bug bounty programs.","directories":{},"_nodeVersion":"18.20.8","dependencies":{"ora":"^5.4.1","open":"^8.4.2","axios":"^1.6.2","boxen":"^5.1.2","chalk":"^4.1.2","figlet":"^1.7.0","inquirer":"^8.2.6"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/rav-xss_1.0.31_1778181093107_0.9240527176024875","host":"s3://npm-registry-packages-npm-production"}},"1.0.32":{"name":"rav-xss","version":"1.0.32","keywords":["xss","security","bug-bounty","scanner","reflected-xss","rav-xss","ravenastar"],"author":{"name":"RavenaStar"},"license":"MIT","_id":"rav-xss@1.0.32","maintainers":[{"name":"ravenastar","email":"ravenastar.js@gmail.com"}],"homepage":"https://github.com/ravenastar-js/rav-xss#readme","bugs":{"url":"https://github.com/ravenastar-js/rav-xss/issues"},"bin":{"rav-xss":"src/index.js"},"dist":{"shasum":"5a341c66827dc5f9e8a9bf1cd0ea3179d8c3256e","tarball":"https://registry.npmjs.org/rav-xss/-/rav-xss-1.0.32.tgz","fileCount":23,"integrity":"sha512-Khpobt6RycCOJmjItdCouCIX5mO6gidap6JMoNyH+njH0KzuahlQNwwkXeYDNW3dFohnPvorI321GqyjOy/28Q==","signatures":[{"sig":"MEYCIQCZ7iX3xaTmpTNG/gAZK8exEEUxo4fUjBWKo3dJBI8ECQIhAMR+/jEE2h9pRkJCesev8ejbtkl7tUzAlokzVUoIK9Er","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2335485},"main":"src/index.js","gitHead":"87a6583377f5a420533c5e79c4ba14426a86ba10","scripts":{"dev":"node src/index.js --verbose","scan":"node src/index.js","configure":"node src/index.js --configure"},"_npmUser":{"name":"ravenastar","email":"ravenastar.js@gmail.com"},"repository":{"url":"git+https://github.com/ravenastar-js/rav-xss.git","type":"git"},"_npmVersion":"11.16.0","description":"⚙️ CLI/NPM | RAV XSS | 🎯 Basic Reflected XSS scanner for bug bounty programs.","directories":{},"_nodeVersion":"24.18.0","dependencies":{"ora":"^5.4.1","open":"^8.4.2","axios":"^1.6.2","boxen":"^5.1.2","chalk":"^4.1.2","figlet":"^1.7.0","inquirer":"^8.2.6"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/rav-xss_1.0.32_1784645825758_0.9902943679562968","host":"s3://npm-registry-packages-npm-production"}},"1.0.33":{"name":"rav-xss","version":"1.0.33","keywords":["xss","security","bug-bounty","scanner","reflected-xss","rav-xss","ravenastar"],"author":{"name":"RavenaStar"},"license":"MIT","_id":"rav-xss@1.0.33","maintainers":[{"name":"ravenastar","email":"ravenastar.js@gmail.com"}],"homepage":"https://github.com/ravenastar-js/rav-xss#readme","bugs":{"url":"https://github.com/ravenastar-js/rav-xss/issues"},"bin":{"rav-xss":"src/index.js"},"dist":{"shasum":"21ea6729c9e8283179565d196ca4dfc562046607","tarball":"https://registry.npmjs.org/rav-xss/-/rav-xss-1.0.33.tgz","fileCount":23,"integrity":"sha512-6aglJnPve152EiawH9lmz/jv6WJ960Svav07LV2EU+TZTWJvy8H4jBZBg3X8zc0x6VElyVHK/9pdGYcaCqSVVQ==","signatures":[{"sig":"MEUCID4wgOLXn+rx5AZ5H92GIL8PpsqTYGZ5YQTPHr1y0mXSAiEA30iH0JLX0sM3s4Ls9P8OPBohAsvhnGk3ABpcJKBuYLw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":2335485},"main":"src/index.js","gitHead":"f2534a55580e808edde1d01701afa2c93b9fe483","scripts":{"dev":"node src/index.js --verbose","scan":"node src/index.js","configure":"node src/index.js --configure"},"_npmUser":{"name":"ravenastar","email":"ravenastar.js@gmail.com"},"repository":{"url":"git+https://github.com/ravenastar-js/rav-xss.git","type":"git"},"_npmVersion":"11.16.0","description":"⚙️ CLI/NPM | RAV XSS | 🎯 Basic Reflected XSS scanner for bug bounty programs.","directories":{},"_nodeVersion":"24.18.0","dependencies":{"ora":"^5.4.1","open":"^8.4.2","axios":"^1.6.2","boxen":"^5.1.2","chalk":"^4.1.2","figlet":"^1.7.0","inquirer":"^8.2.6"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/rav-xss_1.0.33_1784646299351_0.9950614478230899","host":"s3://npm-registry-packages-npm-production"}},"1.0.34":{"name":"rav-xss","version":"1.0.34","description":"⚙️ CLI/NPM | RAV XSS | 🎯 Basic Reflected XSS scanner for bug bounty programs.","main":"src/index.js","bin":{"rav-xss":"src/index.js"},"scripts":{"scan":"node src/index.js","configure":"node src/index.js --configure","dev":"node src/index.js --verbose"},"keywords":["xss","security","bug-bounty","scanner","reflected-xss","rav-xss","ravenastar"],"author":{"name":"RavenaStar"},"license":"MIT","homepage":"https://github.com/ravenastar-js/rav-xss#readme","repository":{"type":"git","url":"git+https://github.com/ravenastar-js/rav-xss.git"},"dependencies":{"axios":"^1.6.2","boxen":"^5.1.2","chalk":"^4.1.2","figlet":"^1.7.0","inquirer":"^8.2.6","open":"^8.4.2","ora":"^5.4.1"},"gitHead":"942dcab22b484c5e0736cdb92be3dd737903ccd7","_id":"rav-xss@1.0.34","bugs":{"url":"https://github.com/ravenastar-js/rav-xss/issues"},"_nodeVersion":"24.18.0","_npmVersion":"11.16.0","dist":{"integrity":"sha512-242ckZDcNfT0pATWB3WeFFPTHtpehRipCKOgcJeVh4ci5sKXkEt4eiCImU8wR1tp0OFYpDYpak7n4K0GuMtnDw==","shasum":"eb419ea25b526f67be02c649c409c30b0b138583","tarball":"https://registry.npmjs.org/rav-xss/-/rav-xss-1.0.34.tgz","fileCount":23,"unpackedSize":2335485,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGcQKWLIUG32lk/P8PyLG5cYLFvblJDvknlD3S+JKf3kAiEArP+R1bEjqHve/WrjrwvudfVaFUN4ylnr1J0vBonxUdI="}]},"_npmUser":{"name":"ravenastar","email":"ravenastar.js@gmail.com"},"directories":{},"maintainers":[{"name":"ravenastar","email":"ravenastar.js@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/rav-xss_1.0.34_1784816479525_0.1649376892785448"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-06T16:07:22.879Z","modified":"2026-07-23T14:21:19.875Z","1.0.0":"2026-05-06T16:07:23.140Z","1.0.1":"2026-05-06T16:18:46.455Z","1.0.2":"2026-05-06T16:28:47.648Z","1.0.3":"2026-05-06T16:58:56.761Z","1.0.4":"2026-05-06T17:04:49.151Z","1.0.5":"2026-05-06T17:13:23.881Z","1.0.6":"2026-05-06T17:18:48.201Z","1.0.7":"2026-05-06T17:26:43.907Z","1.0.8":"2026-05-06T17:37:30.919Z","1.0.9":"2026-05-06T17:48:14.366Z","1.0.10":"2026-05-06T17:56:39.650Z","1.0.11":"2026-05-06T18:01:51.008Z","1.0.12":"2026-05-06T18:09:00.176Z","1.0.13":"2026-05-06T18:31:06.663Z","1.0.14":"2026-05-06T18:36:13.809Z","1.0.15":"2026-05-06T18:45:46.443Z","1.0.16":"2026-05-06T19:03:10.939Z","1.0.17":"2026-05-06T19:16:16.670Z","1.0.18":"2026-05-07T02:59:31.123Z","1.0.19":"2026-05-07T03:23:59.800Z","1.0.20":"2026-05-07T03:47:21.618Z","1.0.21":"2026-05-07T03:52:52.695Z","1.0.22":"2026-05-07T04:06:24.247Z","1.0.23":"2026-05-07T12:40:17.330Z","1.0.24":"2026-05-07T12:59:00.557Z","1.0.25":"2026-05-07T13:16:41.624Z","1.0.26":"2026-05-07T13:26:58.925Z","1.0.27":"2026-05-07T13:45:10.228Z","1.0.28":"2026-05-07T18:22:42.881Z","1.0.29":"2026-05-07T18:45:51.661Z","1.0.30":"2026-05-07T19:07:02.164Z","1.0.31":"2026-05-07T19:11:33.401Z","1.0.32":"2026-07-21T14:57:05.950Z","1.0.33":"2026-07-21T15:04:59.544Z","1.0.34":"2026-07-23T14:21:19.727Z"},"bugs":{"url":"https://github.com/ravenastar-js/rav-xss/issues"},"author":{"name":"RavenaStar"},"license":"MIT","homepage":"https://github.com/ravenastar-js/rav-xss#readme","keywords":["xss","security","bug-bounty","scanner","reflected-xss","rav-xss","ravenastar"],"repository":{"type":"git","url":"git+https://github.com/ravenastar-js/rav-xss.git"},"description":"⚙️ CLI/NPM | RAV XSS | 🎯 Basic Reflected XSS scanner for bug bounty programs.","maintainers":[{"name":"ravenastar","email":"ravenastar.js@gmail.com"}],"readme":"
\n\n \n\"NPM\n\n---\n\n# 🛡️ RAV XSS\n### 🎯 Basic Reflected XSS scanner for bug bounty programs.\n\n[![⭐ Stars](https://img.shields.io/github/stars/ravenastar-js/rav-xss?style=for-the-badge&label=%E2%AD%90%20Stars&color=2d7445&logo=star&logoColor=white&labelColor=444&radius=10)](https://github.com/ravenastar-js/rav-xss/stargazers)\n[![🔱 Forks](https://img.shields.io/github/forks/ravenastar-js/rav-xss?style=for-the-badge&label=%F0%9F%94%B1%20Forks&color=2d7445&logo=git&logoColor=white&labelColor=444&radius=10)](https://github.com/ravenastar-js/rav-xss/network/members)\n[![👁️ Watchers](https://img.shields.io/github/watchers/ravenastar-js/rav-xss?style=for-the-badge&label=%F0%9F%91%81%EF%B8%8F%20Watchers&color=2d7445&logo=eye&logoColor=white&labelColor=444&radius=10)](https://github.com/ravenastar-js/rav-xss/watchers)\n[![📄 License](https://img.shields.io/github/license/ravenastar-js/rav-xss?style=for-the-badge&label=%F0%9F%93%84%20License&color=2d7445&logo=book&logoColor=white&labelColor=444&radius=10)](https://github.com/ravenastar-js/rav-xss/blob/main/LICENSE)\n[![🕒 Last Commit](https://img.shields.io/github/last-commit/ravenastar-js/rav-xss?style=for-the-badge&label=%F0%9F%95%92%20Last%20Commit&color=2d7445&logo=clock&logoColor=white&labelColor=444&radius=10)](https://github.com/ravenastar-js/rav-xss/commits/main)\n[![📦 Repo Size](https://img.shields.io/github/repo-size/ravenastar-js/rav-xss?style=for-the-badge&label=%F0%9F%93%A6%20Repo%20Size&color=2d7445&logo=database&logoColor=white&labelColor=444&radius=10)](https://github.com/ravenastar-js/rav-xss)\n[![⚙️ Node.js](https://img.shields.io/badge/%E2%9A%99%EF%B8%8F%20Node.js-14.0%2B-green?style=for-the-badge&logo=nodedotjs&color=2d7445&logoColor=white&labelColor=444&radius=10)](https://nodejs.org/pt/download)\n\n![ravxss](src/media/ravxss.png)\n\n![ravxss](src/media/ravxss-demo.png)\n---\n\n
\n\n## 📞 Suporte\n\nSe precisar de ajuda ou quiser falar com a equipe, entre no nosso servidor de suporte:\n\n[![Servidor de Suporte](https://img.shields.io/badge/Servidor%20de%20Suporte-Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/FncVNprdgP)\n\n---\n\n## 📋 Índice\n- [🛡️ RAV XSS](#️-rav-xss)\n - [🎯 Basic Reflected XSS scanner for bug bounty programs.](#-basic-reflected-xss-scanner-for-bug-bounty-programs)\n - [](#)\n - [📞 Suporte](#-suporte)\n - [📋 Índice](#-índice)\n - [🎯 Visão Geral](#-visão-geral)\n - [✨ Características Principais](#-características-principais)\n - [📦 Instalação Rápida](#-instalação-rápida)\n - [🗑️ Desinstalar](#️-desinstalar)\n - [🛠️ Como Usar](#️-como-usar)\n - [Uso Básico](#uso-básico)\n - [Menu Interativo](#menu-interativo)\n - [Modos de Execução](#modos-de-execução)\n - [🎛️ Opções da CLI](#️-opções-da-cli)\n - [📂 Categorias de Payloads](#-categorias-de-payloads)\n - [📁 Abrir Pasta de Relatórios](#-abrir-pasta-de-relatórios)\n - [🧹 Limpar e Sair](#-limpar-e-sair)\n - [🚀 Exemplos Práticos](#-exemplos-práticos)\n - [1. Reconhecimento Básico](#1-reconhecimento-básico)\n - [2. Teste com WAF Bypass](#2-teste-com-waf-bypass)\n - [3. Delay Personalizado](#3-delay-personalizado)\n - [4. Scan com Modo Específico](#4-scan-com-modo-específico)\n - [5. Modo Interativo Completo](#5-modo-interativo-completo)\n - [6. Abrir Relatórios](#6-abrir-relatórios)\n - [📊 Relatórios](#-relatórios)\n - [⚙️ Configuração](#️-configuração)\n - [Wizard Interativo](#wizard-interativo)\n - [Arquivo config.txt](#arquivo-configtxt)\n - [Configuração Padrão (Demo)](#configuração-padrão-demo)\n - [📱 Compatibilidade Termux](#-compatibilidade-termux)\n - [⚠️ Aviso Legal](#️-aviso-legal)\n - [Star History](#star-history)\n - [Feito com 💚 por RavenaStar](#feito-com--por-ravenastar)\n\n---\n\n## 🎯 Visão Geral\n\nO **RAV XSS** é uma ferramenta básica para detecção de Reflected XSS, projetada para programas de Bug Bounty.\n\n### ✨ Características Principais\n- 🎯 **Categorias organizadas** — Payloads separados por tipo de ataque\n- 🖥️ **Menu interativo** — Seleção de categorias e modos com setas do teclado\n- 🔄 **Modos de execução** — Axios (rápido) ou Playwright (navegador real)\n- 📱 **Compatível com Termux** — Detecta e adapta automaticamente para Android\n- 🌐 **Detecção por reflexão** — Identifica payloads refletidos na resposta HTTP\n- 📊 **Relatórios detalhados** — Geração automática de reports\n- 📁 **Abrir relatórios** — Comando rápido para abrir a pasta de reports\n- 🧹 **Limpeza segura** — Opção de limpar configs e reports com confirmação\n- ⚡ **Requisições concorrentes** — Scanning rápido e configurável\n- 🎨 **Interface colorida** — Banner ASCII art e boxes estilizados\n- 📄 **Suporte a config.txt** — Configuração via arquivo externo\n\n---\n\n## 📦 Instalação Rápida\n\n
\n📥 Como instalar o NodeJS?\n\n- [COMO INSTALAR NODE JS NO WINDOWS?](https://youtu.be/-jft_9PlffQ)\n
\n\n```\n# Instalar globalmente\nnpm i -g rav-xss # ✅ Recomendado\nnpm install -g rav-xss # ✅ Completo\n\n# Ou usar diretamente com npx\nnpx rav-xss --url \"https://example.com/page?q=[XSS]\"\n\n# Clonar e instalar localmente\ngit clone https://github.com/ravenastar-js/rav-xss.git\ncd rav-xss\nnpm install\n```\n\n---\n\n## 🗑️ Desinstalar\n\n```\nnpm un -g rav-xss # ✅ Recomendado\nnpm uninstall -g rav-xss # ✅ Completo\nnpm remove -g rav-xss # ✅ Alternativo\n```\n\n---\n\n## 🛠️ Como Usar\n\n### Uso Básico\n\n```\n# Modo interativo (recomendado)\nrav-xss\n\n# Com argumentos CLI\nrav-xss --url \"https://example.com/page?q=[XSS]\" --category Basic\n\n# Com verbose para debug\nrav-xss --url \"https://example.com/page?q=[XSS]\" --category Basic --verbose\n\n# Abrir pasta de relatórios\nrav-xss --open-reports\nrav-xss -r\n\n# Limpar configurações (via menu interativo)\nrav-xss\n# Selecionar \"🧹 Clean and Exit\" no menu\n```\n\n### Menu Interativo\n\nAo executar sem argumentos, o fluxo interativo é:\n\n**Passo 1 — Selecionar Categoria:**\n```\n 🎯 SELECT PAYLOAD CATEGORY\n\n ───────────────────────────────────────────────────────\n 🔰 Basic Payloads — Standard HTML tags & events\n 🛡️ Filter Evasion — Encoding, null bytes, obfuscation\n 🎭 Polyglots — Multi-context payloads\n 🔥 WAF Bypass — Cloudflare, ModSecurity evasion\n 💎 Pure Reflex — Reflected-only payloads\n ───────────────────────────────────────────────────────\n 🎯 Configure Target URL\n 🧹 Clean and Exit\n ❌ Exit\n```\n\n**Passo 2 — Selecionar Modo de Execução:**\n```\n 🔄 SELECT EXECUTION MODE\n\n ───────────────────────────────────────────────────────\n ⚡ Axios Mode — Fast HTTP requests (recommended)\n 🌐 Playwright Mode — Real browser automation (slower)\n ───────────────────────────────────────────────────────\n ⮘ Back to Categories\n```\n\n**Passo 3 — Configurar URL (se necessário):**\n```\n 🌐 CONFIGURE TARGET URL\n 💡 Demo target: http://www.sudo.co.il/xss/level0.php?email=[XSS]\n 🔄 Mode: ⚡ Axios\n```\n\n### Modos de Execução\n\n| Modo | Ícone | Descrição | Velocidade | Dependências |\n|------|-------|-----------|------------|--------------|\n| **Axios** | ⚡ | Requisições HTTP diretas | ⚡ Rápido | Nenhuma extra |\n| **Playwright** | 🌐 | Automação de navegador real | 🐢 Lento | `npx playwright install` |\n\n> 📱 **Termux/Android:** O modo Playwright é desativado automaticamente. Apenas Axios fica disponível.\n\n---\n\n## 🎛️ Opções da CLI\n\n| Opção | Atalho | Descrição | Padrão |\n|-------|--------|-----------|--------|\n| `--url` | - | 🌐 URL alvo com placeholder `[XSS]` | Demo URL |\n| `--category` | - | 📂 Categoria de payloads | Menu interativo |\n| `--mode` | - | 🔄 Modo de execução (`axios` ou `playwright`) | Menu interativo |\n| `--delay` | - | ⏱️ Delay entre requisições (ms) | `500` |\n| `--verbose` | `-v` | 📢 Log detalhado | `false` |\n| `--help` | `-h` | ❓ Mostrar ajuda | - |\n| `--configure` | - | ⚙️ Wizard de configuração | - |\n| `--open-reports` | `-r` | 📁 Abrir pasta de relatórios | - |\n| `--headed` | - | 🖥️ Abrir navegador visível (modo Playwright) | `false` |\n\n---\n\n## 📂 Categorias de Payloads\n\n| Categoria | Ícone | Descrição |\n|-----------|-------|-----------|\n| **Basic Payloads** | 🔰 | Standard HTML tags & events |\n| **Filter Evasion** | 🛡️ | Encoding, null bytes, obfuscation |\n| **Polyglots** | 🎭 | Multi-context payloads |\n| **WAF Bypass** | 🔥 | Cloudflare, ModSecurity evasion |\n| **Pure Reflex** | 💎 | Reflected-only, no template injection |\n\n---\n\n## 📁 Abrir Pasta de Relatórios\n\nApós executar os scans, você pode abrir rapidamente a pasta de relatórios:\n\n```\n# Abre a pasta reports no explorador de arquivos\nrav-xss --open-reports\n\n# Atalho\nrav-xss -r\n```\n\n**Comportamento por sistema:**\n| Sistema | Ação |\n|---------|------|\n| 🪟 Windows | Abre o Explorer na pasta `reports/` |\n| 🍎 macOS | Abre o Finder na pasta `reports/` |\n| 🐧 Linux | Abre o gerenciador de arquivos padrão |\n\n> 💡 Se a pasta `reports/` ainda não existir, ela será criada automaticamente.\n\n---\n\n## 🧹 Limpar e Sair\n\nOpção disponível no menu interativo principal que permite limpar todos os arquivos de configuração e relatórios:\n\n```\n 🧹 Clean and Exit\n```\n\n**Comportamento:**\n1. Exibe mensagem de confirmação: `⚠️ This will DELETE all config files and reports. Continue? (y/N)`\n2. Se confirmado, remove:\n - `config.json` (raiz do projeto e diretório atual)\n - `config.txt` (raiz do projeto e diretório atual)\n - Pasta `reports/` com todo seu conteúdo\n3. Exibe resumo do que foi removido\n4. Exibe tela de despedida e encerra\n\n> 🛡️ **Segurança:** Requer confirmação explícita para evitar exclusão acidental.\n\n---\n\n## 🚀 Exemplos Práticos\n\n### 1. Reconhecimento Básico\n\n```\nrav-xss --url \"https://example.com/search?q=[XSS]\" --category Basic\n```\n\n### 2. Teste com WAF Bypass\n\n```\nrav-xss --url \"https://example.com/search?q=[XSS]\" --category WAFBypass --verbose\n```\n\n### 3. Delay Personalizado\n\n```\nrav-xss --url \"https://example.com/search?q=[XSS]\" --category FilterEvasion --delay 1000\n```\n\n### 4. Scan com Modo Específico\n\n```\n# Usando Axios (rápido)\nrav-xss --url \"https://example.com/page?q=[XSS]\" --category Basic --mode axios\n\n# Usando Playwright (navegador real)\nrav-xss --url \"https://example.com/page?q=[XSS]\" --category Basic --mode playwright\n```\n\n### 5. Modo Interativo Completo\n\n```\nrav-xss\n# 1. Selecionar categoria com setas → Enter\n# 2. Selecionar modo (Axios ou Playwright) → Enter\n# 3. Digitar URL (ou usar demo) → Enter\n# 4. Scan executa automaticamente\n```\n\n### 6. Abrir Relatórios\n\n```\nrav-xss -r\n# Abre a pasta com todos os reports gerados\n```\n\n---\n\n## 📊 Relatórios\n\nApós o scan, um relatório é gerado na pasta `reports/`:\n\n```\nreports/\n└── xss_report_2026-05-06T12-00-00-000Z.txt\n```\n\n**Conteúdo do relatório:**\n- 📅 Data e hora do scan\n- 🌐 URL alvo testada\n- ⏱️ Duração total\n- 📊 Total de testes realizados\n- ⚠️ Vulnerabilidades encontradas\n- 📝 Lista detalhada de cada finding com URL completa\n\n---\n\n## ⚙️ Configuração\n\n### Wizard Interativo\n\n```\nrav-xss --configure\nnpm run configure\n```\n\nO wizard guia você através de:\n1. 📋 Nome do target\n2. 🌐 URL alvo (com placeholder `[XSS]`)\n3. ⏱️ Timeout das requisições\n4. ⏳ Delay entre requisições\n5. 🔄 Modo de execução (Axios/Playwright)\n6. 👁️ Mostrar resultados não-vulneráveis\n\n### Arquivo config.txt\n\nVocê pode criar um arquivo `config.txt` na raiz do projeto com:\n\n```\n# RAV XSS Configuration\ntarget=http://www.sudo.co.il/xss/level0.php?email=[XSS]\ndelay=500\nmode=axios\ntimeout=8000\n```\n\n**Parâmetros suportados:**\n| Parâmetro | Descrição | Exemplo |\n|-----------|-----------|---------|\n| `target` | 🌐 URL alvo com `[XSS]` | `target=https://example.com/?q=[XSS]` |\n| `delay` | ⏳ Delay em ms | `delay=1000` |\n| `mode` | 🔄 Modo (`axios`/`playwright`) | `mode=axios` |\n| `timeout` | ⏱️ Timeout em ms | `timeout=8000` |\n| `verbose` | 📢 Modo verbose | `verbose=true` |\n| `user_agent` | 🕵️ User-Agent customizado | `user_agent=Mozilla/5.0...` |\n\n> 💡 O arquivo `config.txt` tem prioridade sobre `config.json` quando ambos existem.\n\n### Configuração Padrão (Demo)\n\nSe nenhuma configuração for fornecida, o scanner usa este alvo demo para testes:\n\n```\n🌐 Demo Target:\n http://www.sudo.co.il/xss/level0.php?email=[XSS]\n \n📝 Descrição: Página pública de teste XSS\n🔄 Modo padrão: Axios\n⏳ Delay padrão: 500ms\n```\n\n---\n\n## 📱 Compatibilidade Termux\n\nO **RAV XSS** detecta automaticamente quando está rodando no Termux (Android) e se adapta:\n\n| Recurso | Desktop | Termux |\n|---------|---------|--------|\n| 🔰 Modo Axios | ✅ Disponível | ✅ Disponível |\n| 🌐 Modo Playwright | ✅ Disponível | ❌ Desativado |\n| 🧙‍♂️ Wizard | ✅ Completo | ✅ Adaptado |\n| 📁 Relatórios | ✅ Normal | ✅ Normal |\n\n**Detecção automática:**\n- Verifica variável `TERMUX_VERSION`\n- Verifica prefixo `com.termux`\n- Verifica hostname (`termux`/`android`)\n- Verifica existência de `/data/data/com.termux`\n\n> 📱 No Termux, o menu de modo é pulado e Axios é selecionado automaticamente.\n\n---\n\n## ⚠️ Aviso Legal\n\nEsta ferramenta é destinada para:\n\n- ✅ **Testes de segurança autorizados** — Apenas teste sistemas que você possui ou tem permissão explícita para testar\n- ✅ **Programas de Bug Bounty** — Use apenas dentro do escopo definido pelo programa\n- ✅ **Fins educacionais** — Aprendizado sobre vulnerabilidades XSS em ambientes controlados\n\n**Você é responsável por:**\n\n- 🚫 **Testes não autorizados são ilegais** — Não escaneie sites sem permissão\n- 🚫 **Siga a divulgação responsável** — Reporte vulnerabilidades pelos canais apropriados\n- 🚫 **Cumpra as leis** — Certifique-se de que seu uso está em conformidade com as leis locais e internacionais\n\n> This tool is provided for educational and authorized security testing purposes only. Users are solely responsible for complying with all applicable laws and regulations. The authors assume no liability for misuse or damage caused by this tool.\n\n**Ao usar esta ferramenta, você concorda em usá-la apenas em sistemas que está autorizado a testar.**\n\n---\n\n## 🌟 Star History\n\n\n \n \n \n \"Star\n \n\n\n---\n\n
\n\n## Feito com 💚 por [RavenaStar](https://linktr.ee/ravenastar)\n\n[⬆ Voltar ao topo](#-rav-xss)\n\n
\n","readmeFilename":"README.md"}