User Guide

This section explains the various ways to use the program and how to call it with different parameters.

The program can be run in cli or interface mode. Both of them offers the same capabilities and parameters.

User Interface

Main Window

The main window is a form divided in two parts :

• Search Form (basic arguments)

• Advanced Settings

Main Window of Skirnir

Search Form

When a circle is red, it means that the option is selected

• Firstname : Specifies the first name.

• Lastname : Specifies the last name.

• Birthday : Specifies the birthday, in order to use it you need to click on the "Toggle birthday" button

• Search only the alias : Make a crawl only for alias.

• Alias : Specifies the alias.

• Keyword : Adds a keyword or a query to a crawl.

  -> For example : "F" AND Society

If the requested first/last name is in a non-Latin alphabet, it is necessary to search by alias only

Advanced Settings

• Deep Crawl: Enable deep crawl.

• Limit the size of generated nicknames : Specifies both maximum and minimum limits of size for generating possible pseudonyms.

• Export generated nicknames in CSV : Export the generated nicknames in CSV.

• Import your custom private/public proxy list : Drop a file for custom public/private proxy list import.

Please find below an example of the intended proxy file (in csv format )

Public Proxy

IP Address	Port
51.83.193.208	80
192.168.1.190	9096
103.33.55.78	500

Private Proxy

IP Address	Port	Username	Password
203.243.63.16	80	myuser1	password
192.168.1.10	8080	myuser2	password2
104.22.75.12	3128	myuser3	password3

Result Window

There are two possible windows depending on the options you choose before :

• Surface Crawl Result Window (by default)

• Deep Crawl Result Window (will be display if deep crawl is enabled)

Surface Crawl Result Window

This is the default results' window. It will display the results from a surface crawl. You can filter the results by social network.

You can filter specific strings from the URLs displayed using the search bar.

You can select one or more URLs in the results section. An increment shows the number of URLs that can be opened simultaneously in the default web browser by clicking on it.

The results are filtered on Instagram, Facebook, Twitter and LinkedIn

Deep Crawl Window

This window is displayed when Deep Crawl is enabled in the main window prior to a crawl. The results are filtered by social network in a specific tab. As before, you can search for a specific string in the search bar or open URLs into a web browser.

In this window, no URLs are selected in the Instagram section

Some URLs are highlighted in red. They refer to social network accounts that may not exist. They are deduced from the Instagram Deep Crawl results.

These seven red-highlighted links may refer to non-existent accounts.

Command Lines Interface

Arguments

Introduction

This section lists the various arguments that can be used with the program along with their descriptions and usage.

Basic Arguments

• --firstname, -f: Specifies the first name.

• --lastname, -l: Specifies the last name.

• --birthday, -b: Specifies the birthday in the format DD-MM-YYYY.

• --alias_only, -no: Make a crawl only for alias.

• --alias, -al: Specifies the alias.

• --keyword, -k: Adds a keyword or a query to a crawl.

Social Networks

• --instagram, -ig: Enable crawl on Instagram.

• --facebook, -fb: Enable crawl on Facebook.

• --x, -x: Enable crawl on X (Twitter).

• --linkedin, -lin: Enable crawl on LinkedIn.

• --tiktok, -t: Enable crawl on TikTok.

• --all, -a: Enable crawl on all social networks (enabled by default).

Advanced Options

• --deepcrawl, -: Enable deep crawl.

• --pseudo_size, -ps: Specifies the limit of size for generating possible pseudonyms (deep crawl).

• --export_nickname, -csv: Export the generated nicknames in CSV. (Only works if deepcrawl enabled)

• --proxyfile: Specifies the filepath for custom public/private proxy list import.

Log Level

• --log: Set the log level with the given choices. Available choices: DEBUG, INFO, WARNING, ERROR, CRITICAL (default: CRITICAL).

User Interface (UI)

• --ui: Launches the UI mode

Examples

Example 1: Specifying only First Name and Last Name

python main.py --firstname John --lastname Doe

Example 2 : Specifying all basics arguments

python main.py --firstname John --lastname Doe --birthday 01-01-1990 --nickname joker

Example 3 : Specifying some basics arguments and enable research only on facebook

python main.py --firstname John --lastname Doe --facebook

Example 4 : Specifying some basics arguments and enable deepcrawl

python main.py --firstname John --lastname Doe --deepcrawl

Example 5 : Specifying some basics arguments and export the generated nicknames in csv

python main.py --firstname John --lastname Doe --deepcrawl --export_nickname