# lorrie-12/social-media-comments-reviews-analyzer architecture

> Architecture diagram of the GitHub repository lorrie-12/social-media-comments-reviews-analyzer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lorrie-12/social-media-comments-reviews-analyzer
- Repository: https://github.com/lorrie-12/social-media-comments-reviews-analyzer

## Overview

This repository is documented as a multi-platform comments and reviews scraper that extracts feedback, analyzes sentiment and emotional tone, clusters themes, and exports results. The README lists the runtime modules and describes the product workflow, but no source excerpts are available to verify exact call ownership or data formats; edges therefore reflect only the documented workflow and capabilities.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Collection Workflow"]
  node_runner["Scraper Runner"]
  node_facebook["Facebook Extractor"]
  node_instagram["Instagram Extractor"]
  node_twitter["Twitter/X Extractor"]
  node_tiktok["TikTok Extractor"]
  node_youtube["YouTube Extractor"]
  node_reviews["Review Extractor"]
  node_settings["Scraper Settings"]
end

subgraph group_analysis["Feedback Analysis"]
  node_sentiment["Sentiment Analysis"]
  node_emotion["Emotional Tone"]
  node_clustering["Theme Clustering"]
end

subgraph group_output["Results"]
  node_exporter["Result Exporter"]
  node_results["Analysis Results"]
end

node_analyst(("Analyst"))
node_platforms["Social Platforms"]
node_review_sites["Review Sites"]
node_cookies["Session Cookies"]
node_groq{{"Groq LLM"}}

node_analyst -->|"starts run"| node_runner
node_analyst -->|"configures run"| node_runner
node_runner -->|"reads settings"| node_settings
node_runner -->|"extracts comments"| node_facebook
node_runner -->|"extracts comments"| node_instagram
node_runner -->|"extracts comments"| node_twitter
node_runner -->|"extracts comments"| node_tiktok
node_runner -->|"extracts comments"| node_youtube
node_runner -->|"extracts reviews"| node_reviews
node_platforms -->|"provides comments"| node_facebook
node_platforms -->|"provides comments"| node_instagram
node_platforms -->|"provides comments"| node_twitter
node_platforms -->|"provides comments"| node_tiktok
node_platforms -->|"provides comments"| node_youtube
node_review_sites -->|"provides reviews"| node_reviews
node_cookies -.->|"authenticates"| node_facebook
node_cookies -.->|"authenticates"| node_twitter
node_runner -->|"analyzes feedback"| node_sentiment
node_runner -->|"analyzes tone"| node_emotion
node_emotion -->|"requests analysis"| node_groq
node_runner -->|"clusters themes"| node_clustering
node_runner -->|"exports findings"| node_exporter
node_exporter -->|"writes results"| node_results

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_runner,node_facebook,node_instagram,node_twitter,node_tiktok,node_youtube,node_reviews,node_settings,node_review_sites toneBlue
class node_sentiment,node_emotion,node_clustering toneAmber
class node_exporter,node_results toneMint
class node_analyst,node_platforms,node_cookies,node_groq toneIndigo
```

## Components

### Collection Workflow

- **Scraper Runner**
- **Facebook Extractor**
- **Instagram Extractor**
- **Twitter/X Extractor**
- **TikTok Extractor**
- **YouTube Extractor**
- **Review Extractor**
- **Scraper Settings**

### Feedback Analysis

- **Sentiment Analysis**
- **Emotional Tone**
- **Theme Clustering**

### Results

- **Result Exporter**
- **Analysis Results**

### Other components

- **Analyst**
- **Social Platforms**
- **Review Sites**
- **Session Cookies**
- **Groq LLM**

## Connections

- Analyst → Scraper Runner: starts run
- Analyst → Scraper Runner: configures run
- Scraper Runner → Scraper Settings: reads settings
- Scraper Runner → Facebook Extractor: extracts comments
- Scraper Runner → Instagram Extractor: extracts comments
- Scraper Runner → Twitter/X Extractor: extracts comments
- Scraper Runner → TikTok Extractor: extracts comments
- Scraper Runner → YouTube Extractor: extracts comments
- Scraper Runner → Review Extractor: extracts reviews
- Social Platforms → Facebook Extractor: provides comments
- Social Platforms → Instagram Extractor: provides comments
- Social Platforms → Twitter/X Extractor: provides comments
- Social Platforms → TikTok Extractor: provides comments
- Social Platforms → YouTube Extractor: provides comments
- Review Sites → Review Extractor: provides reviews
- Session Cookies → Facebook Extractor: authenticates
- Session Cookies → Twitter/X Extractor: authenticates
- Scraper Runner → Sentiment Analysis: analyzes feedback
- Scraper Runner → Emotional Tone: analyzes tone
- Emotional Tone → Groq LLM: requests analysis
- Scraper Runner → Theme Clustering: clusters themes
- Scraper Runner → Result Exporter: exports findings
- Result Exporter → Analysis Results: writes results