bellingcat/sugartrail
1
0
Fork 0
mirror of https://github.com/bellingcat/sugartrail.git synced 2026-06-08 03:28:31 +03:00
Code Issues Packages Projects Releases Wiki Activity
Files
1a608923b4ac5b92d6c486b81030c1b9b5c7c493
sugartrail/README.md
Sean Greaves 1a608923b4 Update README.md
2022-09-04 15:03:30 +01:00

1.4 KiB
Raw Blame History

Sugartrail

Tool Description

Sugartrail is a work-in-progress network analysis tool and workflow that helps researchers to use a suspicious officer to discover other suspicious officers, companies and locations through Companies House.

The workflow is based on the following observations:

  • suspicious directors often have many active companies registered to multiple historic addresses
  • addresses with many registered companies can contain multiple scam companies

Requirements

You will require an API key from Companies House to authenticate with the API. First you will need to create a live application to get an API key which you can do by following the Companies House guide. You will then need to manually hard-code the API key inside the sugartrail.py script as the value for access_token.

Installation

  1. Make sure you have Conda installed

  2. Download the tool's repository using the command:

git clone https://github.com/ribenamaplesyrup/sugartrail.git
  1. Navigate to the main directory and run:
conda env create -f environment.yml
conda activate candystore
jupyter notebook
  1. Open Tutorial 1 - Exit Through the Candy Shop

Usage

  • A walkthrough of how to use the tool is included in the linked Jupyter notebook showing how we can get from suspicious Candy Stores of Oxford Street to several prolific scammers.