You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Raphaël Vinot 3d2ae503ec
Merge pull request #15 from CIRCL/dependabot/pip/urllib3-1.26.5
2 years ago
bin new: Add permalink to lookyloo 4 years ago
cache new: Major refactoring to use more recent techniques. Python3.6+ 5 years ago
client new: Add test case 4 years ago
doc/logo add: [doc] URL Abuse logo added 5 years ago
urlabuse fix: Do not send more than one email/day/hostname to the ticketing system. 4 years ago
website fix: The confirm message about the mail sent wasn't displayed in prod 4 years ago
.gitignore chg: Move installation process to pipenv 4 years ago
.gitmodules new: Major refactoring to use more recent techniques. Python3.6+ 5 years ago
.travis.yml new: Add test case 4 years ago
LICENSE Initial commit 8 years ago
Pipfile fix: Force version of werkzeug 4 years ago
Pipfile.lock build(deps): bump urllib3 from 1.26.4 to 1.26.5 2 years ago fix: Rewrite travis file 4 years ago
requirements.txt chg: Bump requirements.txt 4 years ago chg: Move installation process to pipenv 4 years ago

Build Status

URL Abuse

URL Abuse logo

URL Abuse is a versatile free software for URL review, analysis and black-list reporting. URL Abuse is composed of a web interface where requests are submitted asynchronously and a back-end system to process the URLs into features modules.


Please note that some of the API services will require an API key. The API keys should be located in the root of the URL Abuse directory.

Online version

If you don't want to use the online version or run your own version of URL Abuse, you can follow the install process below.


IMPORTANT: Use pipenv

NOTE: Yes, it requires python3.6+. No, it will never support anything older.

Install redis

git clone
cd redis
git checkout 5.0
make test
cd ..

Install Faup

git clone git://
cd faup
mkdir build
cd build
cmake .. && make
sudo make install

Install & run URL Abuse

git clone
cd url-abuse
pipenv install
echo URLABUSE_HOME="'`pwd`'" > .env
pipenv shell
# Copy and review the configuration:
cp website/config/config.ini.sample website/config/config.ini
# Starts all the backend
# Start the web interface


We welcome pull requests for new extensions, bug fixes.

Add a new module

Look at the existings functions/modules. The changes will have to be made in the following files:

  • Add the function you want to execure in
  • Add a route in web/ This route will do an async call to the function defined in The parameter of the function is sent in an POST object
  • Add a statement in web/templates/url-report.html. The data option is the parameter to pass to the javascript directive
  • Add a directive in web/static/main.js, it will take care of passing the parameter to the backend and regularly pull for the response of the async call

Partner and Funding

URL Abuse was being developed as part of the “European Union anti-Phishing Initiative” (EU PI) project. This project was coordinated by Cert-Lexsi and co-funded by the Prevention of and Fight against Crime programme of the European Union.

URL Abuse is currently supported and funded by CIRCL ( Computer Incident Response Center Luxembourg).