Corrected copyright file
[packages/parsero.git] / README.md
1 Here, you can get all the info about Parsero updated:
2
3 http://www.behindthefirewalls.com/search/?q=parsero
4 What's Parsero?
5 ===============
6 Parsero is a free script written in Python which reads the Robots.txt file of a web server and looks at the Disallow entries. The Disallow entries tell the search engines what directories or files hosted on a web server mustn't be indexed. For example, "Disallow: /portal/login" means that the content on www.example.com/portal/login it's not allowed to be indexed by crawlers like Google, Bing, Yahoo... This is the way the administrator have to not share sensitive or private information with the search engines.
7
8 But sometimes these paths typed in the Disallows entries are directly accessible by the users without using a search engine, just visiting the URL and the Path, and sometimes they are not available to be visited by anybody... Because it is really common that the administrators write a lot of Disallows and some of them are available and some of them are not, you can use Parsero in order to check the HTTP status code of each Disallow entry in order to check automatically if these directories are available or not.
9
10 Also, the fact the administrator write a robots.txt, it doesn't mean that the files or directories typed in the Dissallow entries will not be indexed by Bing, Google, Yahoo... For this reason, Parsero is capable of searching in Bing to locate content indexed without the web administrator authorization. Parsero will check the HTTP status code in the same way for each Bing result.
11
12
13 When you execute Parsero, you can see the HTTP status codes. For example, the codes bellow:
14
15
16     200 OK          The request has succeeded.
17     403 Forbidden   The server understood the request, but is refusing to fulfill it.
18     404 Not Found   The server hasn't found anything matching the Request-URI.
19     302 Found       The requested resource resides temporarily under a different URI.
20     ...
21
22
23 Installing:
24 ==========
25 This tool needs at least Python3 and urllib3.
26        
27     sudo apt-get install python3
28     sudo apt-get install python3-pip
29     sudo pip-3.3 install urllib3
30     sudo pip-3.2 install beautifulsoup4
31         
32 Make sure that your default version of Python is 3 or later. If you don't want to change your default version, you can execute typing
33 $ python3 parsero (if this version has been installed) instead of $ python parsero.
34
35 Usage:
36 ======
37     $ python3 parsero.py -h
38         
39     usage: parsero.py [-h] [-u URL] [-o] [-sb]
40         
41     optional arguments:
42     -h, --help  show this help message and exit
43     -u URL      Type the URL which will be analyzed
44     -o          Show only the "HTTP 200" status code
45     -sb         Search in Bing indexed Disallows
46
47
48 Example:
49 =======
50          
51     root@kali:~/my-tools/Parsero# python3 parsero.py -u www.example.com -sb
52
53          ____                               
54         |  _ \ __ _ _ __ ___  ___ _ __ ___  
55         | |_) / _` | '__/ __|/ _ \ '__/ _ \ 
56         |  __/ (_| | |  \__ \  __/ | | (_) |
57         |_|   \__,_|_|  |___/\___|_|  \___/ 
58
59         Starting Parsero v0.75 (https://github.com/behindthefirewalls/Parsero) at 05/22/14 11:12:55
60         Parsero scan report for example.com                                             
61         http://example.com/download.php 302 Moved Temporarily                                             
62         http://example.com/raw.php 302 Moved Temporarily                                             
63         http://example.com/embed_js.php 200 OK                                             
64         http://example.com/embed.php 200 OK                                             
65         http://example.com/print.php 302 Moved Temporarily                                             
66         http://example.com/diff.php 302 Moved Temporarily                                             
67         http://example.com/share.php 404 Not Found                                             
68         http://example.com/report.php 302 Moved Temporarily                                             
69         http://example.com/embed_iframe.php 200 OK                                             
70                                              
71         [+] 9 links have been analyzed and 3 of them are available!!!                                             
72                                              
73         Searching the Disallows entries in Bing...                                             
74                                              
75         http://www.bing.com/search?q=site:http://example.com/download.php                                             
76         http://www.bing.com/search?q=site:http://example.com/raw.php                                             
77         - example.com/raw.php/contact?i=KR9c2erd 200 OK                                             
78         - example.com/raw.php/legal.aspx 302 Moved Temporarily                                             
79         - example.com/raw.php/points?i=KR9c2erd 200 OK                                             
80         - example.com/raw.php/image/sqrn11sp3C/zayn-tshirt-one-direction?i=... 302 Moved Temporarily
81         http://www.bing.com/search?q=site:http://example.com/embed_js.php
82         http://www.bing.com/search?q=site:http://example.com/embed.php                                             
83         http://www.bing.com/search?q=site:http://example.com/print.php                                             
84         http://www.bing.com/search?q=site:http://example.com/diff.php                                             
85         http://www.bing.com/search?q=site:http://example.com/share.php                                             
86         http://www.bing.com/search?q=site:http://example.com/report.php                                             
87         http://www.bing.com/search?q=site:http://example.com/embed_iframe.php                                             
88                                              
89         Finished in 7.290362596511841 seconds 
90
91 Disclaimer
92 ==========
93 The use of this tool is your responsability. Use parsero to audit your own servers or servers you are allowed to scan. I hereby disclaim any responsibility for actions taken with this tool.
94
95
96 Author:
97 =======
98
99   Javier Nieto
100   
101   eMail: javier.nieto<@>behindthefirewalls.com
102   
103   Twitter: @behindfirewalls
104   
105   Web: http://www.behindthefirewalls.com
106   
107