Unicode Domain-Squat Finder
Project description
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.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for xn_twist-1.4.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 08939da26217db80fc0af5edd9c56d2fb986ca7df07b2bbd647f724b7cbfa7c0 |
|
MD5 | aa92f8481c0856e4cbebef27805591e5 |
|
BLAKE2b-256 | b937e66c6c611893b9f261a6f7debccfdd5ef58aa0a3e024b8cacb2fb9cfe050 |