Skip to content

Commit f364e83

Browse files
Create README.md
1 parent 2be3acb commit f364e83

File tree

1 file changed

+67
-0
lines changed

1 file changed

+67
-0
lines changed

README.md

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
# website-status-code
2+
# scscanner_py
3+
scscanner_py is tool to read website status code response from the lists. This tool is reworked from bash version of [scscanner](https://github.com/yuyudhn/scscanner).
4+
5+
## Requirements
6+
- requests
7+
- urllib3
8+
- datetime
9+
- argparse
10+
11+
Tested on **Debian** with **Python 3.10.8**
12+
13+
## Features
14+
- Multi-threading for fast scanning.
15+
- Filter status code from target list.
16+
- Save to file option.
17+
18+
## How to use
19+
Help menu.
20+
```
21+
┌──(shubham㉿Rooter)-[~/dmarcscan]
22+
└─$ python3 scscanner.py --help
23+
nino@nakano:~$ python3 scscanner.py --help
24+
25+
░██████╗██╗░░██╗██╗░░░██╗██████╗░██╗░░██╗░█████╗░███╗░░░███╗  ██████╗░░█████╗░░█████╗░████████╗███████╗██████╗░
26+
██╔════╝██║░░██║██║░░░██║██╔══██╗██║░░██║██╔══██╗████╗░████║  ██╔══██╗██╔══██╗██╔══██╗╚══██╔══╝██╔════╝██╔══██╗
27+
╚█████╗░███████║██║░░░██║██████╦╝███████║███████║██╔████╔██║  ██████╔╝██║░░██║██║░░██║░░░██║░░░█████╗░░██████╔╝
28+
░╚═══██╗██╔══██║██║░░░██║██╔══██╗██╔══██║██╔══██║██║╚██╔╝██║  ██╔══██╗██║░░██║██║░░██║░░░██║░░░██╔══╝░░██╔══██╗
29+
██████╔╝██║░░██║╚██████╔╝██████╦╝██║░░██║██║░░██║██║░╚═╝░██║  ██║░░██║╚█████╔╝╚█████╔╝░░░██║░░░███████╗██║░░██║
30+
╚═════╝░╚═╝░░╚═╝░╚═════╝░╚═════╝░╚═╝░░╚═╝╚═╝░░╚═╝╚═╝░░░░░╚═╝  ╚═╝░░╚═╝░╚════╝░░╚════╝░░░░╚═╝░░░╚══════╝╚═╝░░╚═╝
31+
scscanner - Massive HTTP Status Code Scanner
32+
33+
usage: scscanner.py [-h] [-T list.txt] [-w [15]] [-t google.com] [-f 200] [-s] [-o result.txt]
34+
35+
options:
36+
-h, --help show this help message and exit
37+
-T list.txt File contain lists of domain
38+
-w [15], --workers [15]
39+
Thread value. Default value is 4
40+
-t google.com, --target google.com
41+
Single domain check
42+
-f 200, --filter 200 Status code filter
43+
-s, --silent Silent mode option. Don't print status code output
44+
-o result.txt, --output result.txt
45+
Save the results to file
46+
```
47+
Scan domain lists.
48+
```
49+
python3 scscanner.py -T lists.txt --workers 20
50+
```
51+
Scan single domain.
52+
```
53+
python3 scscanner.py -t https://blog.linuxsec.org
54+
```
55+
Scan domain list with status code filtering.
56+
**Example**: filter only '200' response.
57+
```
58+
python3 scscanner.py -T lists.txt -w 20 -f 200
59+
```
60+
Silent option, just print url with match status code filter.
61+
```
62+
python3 scscanner.py -T lists.txt -s --filter 200 --workers 20
63+
```
64+
With save to file options.
65+
```
66+
python3 scscanner.py -T list.txt --workers 20 --output asuka.txt
67+
```

0 commit comments

Comments
 (0)