Find Unicode domain squats
**NOTE: ** This project will be deprecated in early 2021. The functionality will still exist in another project (yet to be released).
To install XN Twist, run this command in your terminal:
pip install xn-twist
This is the preferred method to install XN Twist, as it will always install the most recent stable release.
If you don't have pip installed, this Python installation guide can guide you through the process.
The sources for XN Twist can be downloaded from the Github repo.
You can either clone the public repository:
$ git clone git://github.com/xn-twist/xn-twist
Or download the tarball:
$ curl -OL https://github.com/xn-twist/xn-twist/tarball/master
Once you have a copy of the source, you can install it with:
$ python setup.py install
You can use XN-Twist in a script as follows:
from xn_twist import XNTwist
xn = XNTwist()
twist_results = xn.twist('example.com')
The following parameters can be passed into the initialization of the XNTwist
object:
query_dns
: Specify whether or not you would like to query dns values for the domains. Defaults toFalse
. Be aware that setting this value to ``True`` will slow the twisting process down significantly.output
: Specify an output file to which the json output of the algorithm will be written.
When calling the twist()
function, there is an optional limit
value which limits the number of characters used as a spoofs. This cuts down on the processing load and makes the results manageable. An example usage is shown below.
from xn_twist import XNTwist
xn = XNTwist()
twist_results = xn.twist('example.com', limit=2)
When calling the twist()
function, there is an optional simple
value which only returns possible domain squats with one character changed rather than all of the possible permutations (the default is FALSE
). This cuts down on the processing load and makes the results manageable. An example usage is shown below.
from xn_twist import XNTwist
xn = XNTwist()
twist_results = xn.twist('example.com', simple=True)
The response will be json that looks something like:
{
"datetime": "2018-04-06 05:33:45.889048",
"possible_squats": [
{
"displayed": "\u0430.com",
"punycode": "xn--80a.com"
},
{
"displayed": "\u0105.com",
"punycode": "xn--2da.com"
},
{
"displayed": "\u03ac.com",
"punycode": "xn--hxa.com"
},
{
"displayed": "\u00e1.com",
"punycode": "xn--1ca.com"
},
{
"displayed": "\u01ce.com",
"punycode": "xn--tja.com"
},
{
"displayed": "\u1f05.com",
"punycode": "xn--ing.com"
},
{
"displayed": "\u01df.com",
"punycode": "xn--bka.com"
},
{
"displayed": "\u1f00.com",
"punycode": "xn--dng.com"
},
{
"displayed": "\u1f01.com",
"punycode": "xn--eng.com"
},
{
"displayed": "\u00e4.com",
"punycode": "xn--4ca.com"
}
],
"count": 10,
"xn_twist_version": "1.2.0"
}
You can use XN-Twist from the command line as follows:
xntwist example.com
The usage for the command line form of XN-Twist is as follows:
XN Twist. Usage: xntwist <domain> [--limit=LIMIT] [--dns] [--output=OUTPUT] xntwist (-h | --help) xntwist --version Options: -h --help Show this screen. --version Show version. -l=LIMIT --limit=LIMIT Limit the number of characters used as spoofs [default: 5]. -d --dns Query DNS for each domain. -o=OUTPUT --output=OUTPUT Specify an output file.
After cloning the repo, you can test it using the following commands from the base directory of this repository:
make test
This project relies on a dataset. More details on how to access the dataset and even how to help us build it coming soon!
This package was created with Cookiecutter and the fhightower/python-project-template project template.