Skip to content

Latest commit

 

History

History
242 lines (237 loc) · 11.2 KB

WIKI.md

File metadata and controls

242 lines (237 loc) · 11.2 KB

Sterra WIKI (v2.1)

🔭 A SOCMINT tool to get infos from an Instagram acc via its Followers / Following

🗒 Summary

❓ What is sterra ?

It is a new way to make SOCMINT on instagram accounts:

  • It allows you to determine someone's account close circle via data analysis module based on informations extracted of the instagram followers / following of your target.
  • It also allows you to export these lists to excel, csv and json, while containing basic informations on each accounts of these lists, such as follower and following count, posts counts, name, id, biography ... It is perfect to manually analyse followers and following lists on excel.
  • It also allows you to compare two lists you previously exported to sport differences and coincidences bewteen these; typically the common username between two lists.

👉 Examples of usage

Example on a big account (Mark Zuckerberg aka @zuck on instagram):

At first, let's scrape he's following list:

1 - The submodule i am choosing (here export, to export his list of following),
2 - The username of my target (here zuck),
3 - The list i want to scrape (here following),
4 - My instagram SessionID.

If the following error message happens, do the following:

Type 2, to export as a part the data that have already been extracted. You should get the following message:

Copy the path, and re-enter the command from before, but add the argument --part "PATH GIVEN" as following:

If the errror happens again, just retype the exact same command as before, the data exported this time will be appened to the json part file.

At the end you should get:

Copy the path given to you (in my case: /usr/local/lib/python3.9/site-packages/sterra/export/zuck_following.Dec-02-2021;19-48-09.xlsx).

We're going to use it to determine the potential close social circle of Mark Zuckerberg.

1 - The path,
2 - To print url instead of usernames,
3 - To get the list from the less to the much probable to be in personnal circle.

Here are the 3 highest probabilities accounts:

lilyisaboss jaiona jolivan

They all seems very personnal.

On little accounts:

  • Analyzing the mutuals list will be more efficient,
  • You can also check in the followers / following list "college", "city", "university", basic terms like this that can give an idea of the location of your target.

🕹 Usage

If you don't see a case looking like (default -> ....), it means the argument is required.

Sterra is divided by submodules:

  • Export, to extract and export followers / following / mutuals (account followed by and following back your target).
  • Compare, with two lists, compare them to check their differences or common points.
  • Analyse, to analyse lists previously exported, to determine who is more susceptible to be in your target's close circle.
  • History, manage your export history.
  • Convert, to convert a list already exported to another format than its actual one. To select your submodule, simply type its name just right after invoking sterra, e.g.:
# selecting analyse submodule;
sterra analyse #arguments ...

Important note on the way the program works:

The submodules others than export works with the path export submodules gives you. Here is an example of path: When the path is asked in the arguments, it is this one, or the other last one the program gave you. To avoid errors, i advise you to write it between commas, like this : "/Users/.../.../someones_things.excel".

Export

Default informations exported:

ID Username FullName Page Link Biography IsPrivate Followers Count
Following Count Posts Count External Link IsBusiness IsProfessional IsVerified

Required Arguments (required)

target account: Your target must be an instagram username or an instagram ID;

-u or --username TARGETUSERNAME
#or
-id TARGETID

target list: The list you want to export;

-t or --target following or followers or both or mutuals
'''
- following will be the list of accounts your target follows,
- followers will be the list of account following your target,
- both will be these two both lists,
- mutuals will be the accounts present in both list (following your target, and followed by your target).
'''

Login Arguments (required)

You will have a choice to make between login via SessionID or Credentials.

-ssid or --login-credentials SESSIONID
#or
-lcrd or --login-session-id "USERNAME" "PASSWORD"

Export (required)

format: The format in wich export the file (default -> "excel");

-f or --format excel or csv or json

all infos: Export all infos (see the following table) (default -> False);

Default informations Business Adress Business Category Business Contact Method Business Email Business Phone Number Connected Facebook Page
Mutual Followed By Count Has Effects Has Channel Has Clips Has Guide Hide Like and View Count Has joined Recently
--all-infos

path: Path to export the file (default -> module/export directory), or

-p or --path "YOUR_DESTINATION_PATH"

Speed (optional)

speed: The speed of the extraction of the infos on each accounts in the lists (default -> express = False, -d = 0);

#fast:
-e or --express
#or safe:
-d or --delay INT

Optional Arguments (optional)

help:

-h or --help

part: If you have been blocked during the follow(ers|ing) information extraction by instagram before, and selected "2 - Export what have been exported as a part", copy the path it gave you (it should look like -> followers#289309762.json), and use it as following (default -> None); (If your first export command target was both or mutuals, use the target of the list it was extracting when it got blocked.)
(The is an example of its usage here

--part "PATH_GIVEN"

no limit have been removed because the program has now a system of export from parts if instagram blocks the scraping.

Compare

files path: Paths to the files to analyse;

-f1 or --file1 "PATH_TO_FILE_1"
-f2 or --file2 "PATH_TO_FILE_2"

no print: Doesn't print the results (default -> False);

-n or --no-print

url: Instead of printing usernames, printing url to the profile (default -> False);

-u or --url

Compare type (at least one required to run the program)

common usernames: Will return the common usernames between the two lists (default > False);

--common-usernames

not common usernames: Will return the usernames in f1 but not in f2 (default > False);

--not-common-usernames

Export (not required)

export: Will export the list returned (default -> False);

-e or --export

format: Format of the export (default -> "excel"):

-f or --format excel or csv or json

path: Location path to export the file (default -> module/export directory):

-p or --path "YOUR_DESTINATION_PATH"

Analyse

For analysis, the best lists to analyse is following or mutuals; they represent the interests and the mutual relation of your target. The results will be way more interesting than analysing the followers list.

path: Path to the exported file to analyse (can be excel, csv or json);

-p or --path "FILE_PATH"

analyse type: Type of analyse to perform on the list (default -> "personnal", the only one available for now);

-a or --analyse-type personnal

descending: Will print the list from 0 to 100 instead of 100 to 0 (default -> False);

-d or --descending

export: Export the returned datas (the export path will be the same as the filled file) (default -> False);

-e or --export

format: The format in wich export the file (if you filled the --export argument) (default -> "excel");

-f or --format excel or csv or json

ignore over: The number of followers over wich the statistics will consider 0% chances of being a personnal account (for the followers coefficient; it will impact the final result (coefficient 5), but will not define alone the final result) (default -> 10000);

-i or --ignore-over INT

no print: Will not print the result (be sure you checked --export arg if you od this, otherwise it will analyse but do nothing with it) (default -> False);

-n or --no-print

percentage: Integer representating the percentage under wich we won't print results (between 0 and 98) (default -> 0);

--pctg INT

size: Size of the probability list (default -> size of the list);

-s or --size INT

url: Instead of printing the username of the accounts, printing the url of the accounts (if --export, will not export as url) (default -> False);

--url

History

To run it, you'll have to choose one of the following args:

all: Print all the path written in the export history (default -> False);

-a or --all

match: Print the path matching with a string (default -> None);

-m or --match STR

clear: Clear the history (default -> False);

-c or --clear

Convert

The file will be exported to a new file under another format at the same path as the entry file.

path: Path of the file to convert;

-p or --path "PATH_OF_THE_FILE_TO_CONVERT"

format: Format of the conversion file;

-f or --format excel or csv or json

➕Additional notes

  • In lists, id is more important than it seems: it allows you to locate an account if it has changed of username.
  • In CSV exports, \n is replaced by <breakline>, and , by <comma>.