Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

socioscan

Socioscan is a powerful social media intelligence tool designed to cut through the clutter and reveal the hidden stories shaping online conversations.

The idea

Analytical tool to extract insights (shown on a simple dashboard) from social media posts about narratives, sentiments, initiators, influencers and clusters of accounts. It should be applicable for studying disinformation campaigns, analysing public opinion, and assessing risks related to some topics.

It's a project created by team Watch Cats during participation in Bellingcat's First In-person Hackathon.

Inspired by 4CAT and twitter explorer. The development process is documented in this Google document.

Datasets

Twitter posts on various topics (1-20K), including datasets enriched with topics and sentiments.

Instructions:

How can I get topics and sentiments for my dataset? Cause it’s a resource- and time-consuming operation, we implemented it in the Jupyter Notebook script available on our GitHub. For tweets vectorization we are using hkunlp/instructor-large model, for clusterization – MiniBatchKMeans, for the detection of topics – GPT-4-Turbo API, for the sentiment analysis of tweets – cardiffnlp/twitter-roberta-base-sentiment-latest mode. All steps are reproducible.

Installation

For local installation you need Python and pip installed.

pip install -r requirements.txt
streamlit run dashboard.py

Utils

utils folder contains:

  • CSV tweet datasets formatter (to Twitwi)
  • cluster_n_sentiments.ipynb: ML stuff (enrichment of datasets with sentiments and topics)

SOWEL classification

This tool uses the following OSINT techniques:

Some other results

An example of a hashtag network built with Twitter Explorer using one of the datasets

HashtagNetwork

About

Socioscan is a powerful social media intelligence tool designed to cut through the clutter and reveal the hidden stories shaping online conversations.

Resources

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages