xn-twist 1.4.0

Unicode Domain-Squat Finder

Find Unicode domain squats

Installation

Stable release

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.

From sources

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

Usage

Via Python

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 to False. 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"
}

Via Command Line

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.

Run Tests

After cloning the repo, you can test it using the following commands from the base directory of this repository:

make test

Data, Data, Everywhere…

This project relies on a dataset. More details on how to access the dataset and even how to help us build it coming soon!

Credits

This package was created with Cookiecutter and the fhightower/python-project-template project template.