Skip to content

Update README for Global Security Platform rebranding #29

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
GYFX35 merged 1 commit into from
Mar 17, 2026
Merged

Update README for Global Security Platform rebranding #29

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
184 changes: 83 additions & 101 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,101 +1,83 @@
# Facebook Security Analyzer CLI

This command-line tool provides utilities to help users analyze Facebook messages for potential phishing attempts and assess Facebook profiles for indicators of fakeness.

## Features

1. **Phishing Message Analysis:**
* Accepts user-provided message text.
* Scans for common phishing keywords (e.g., "verify your account," "urgent security alert").
* Extracts URLs and checks them against patterns of suspicious URLs (e.g., impersonation of legitimate domains, use of URL shorteners, IP address links).
* Provides a "suspicion score" and a summary of findings.

2. **Fake Profile Analysis (Manual Check):**
* Accepts a Facebook profile URL from the user.
* **Important:** This tool *does not* scrape Facebook or automatically access profile data, in compliance with Facebook's policies.
* It guides the user through a manual checklist of common fake profile indicators (e.g., generic profile picture, recent account age, low activity, poor grammar, suspicious requests).
* Includes an interactive helper to guide the user in performing a reverse image search on the profile picture using external services like Google Images or TinEye.
* Calculates a "suspicion score" based on the user's answers and provides an assessment of how likely the profile is to be fake.

## Prerequisites

* Python 3.x

## Installation & Setup

1. **Clone the repository or download the files.**
If you have the files (`main.py` and the `facebook_analyzer` directory) in a single project folder, no complex installation is typically needed.

2. **No external Python libraries are required** for the core functionality as it currently stands (uses only standard libraries like `re` and `webbrowser`). If future enhancements (like direct API calls for URL checking) are added, this section will need updates.

## How to Run

1. Open your terminal or command prompt.
2. Navigate to the directory where you saved the `main.py` file and the `facebook_analyzer` folder.
3. Run the application using the Python interpreter:
```bash
python main.py
```

4. The tool will display a menu:

```
--- Facebook Security Analyzer ---
Choose an option:
1. Analyze a message for phishing
2. Analyze a Facebook profile for fakeness (manual check)
3. Exit
------------------------------------
Enter your choice (1-3):
```

## Usage

### 1. Analyze a message for phishing

* Select option `1`.
* When prompted, paste the full text of the suspicious message and press Enter.
* The tool will output:
* A phishing likelihood score (higher is more suspicious).
* Any suspicious keywords found.
* Any suspicious URLs found, along with the reason they were flagged.
* An overall summary.

### 2. Analyze a Facebook profile for fakeness (manual check)

* Select option `2`.
* When prompted, enter the full Facebook profile URL (e.g., `https://www.facebook.com/some.profile`).
* The tool will open the profile URL in your default web browser for your manual inspection.
* You will then be guided through a series of yes/no questions based on your observations of the profile.
* This includes an optional guided step to perform a reverse image search on the profile's picture.
* After you answer all questions, the tool will provide:
* A list of fake profile indicators you noted.
* An overall "suspicion score."
* An assessment category (e.g., Low, Medium, High likelihood of being fake).

## Disclaimer

* This tool provides heuristic-based analysis and guidance. It is **not foolproof** and should not be considered a definitive judgment on whether a message is phishing or a profile is fake.
* **Phishing Detection:** The tool uses a predefined list of keywords and URL patterns. Sophisticated phishing attempts may evade these checks. Always exercise extreme caution with suspicious messages, especially those asking for login credentials or personal information. Do not rely solely on this tool.
* **Fake Profile Detection:** The analysis is based *entirely* on your manual observations and answers. False positives and negatives are possible. Always use your best judgment when interacting with profiles online.
* **Facebook's Terms of Service:** This tool is designed to operate without violating Facebook's Terms of Service by not scraping or automatically collecting data from its platform. The fake profile analysis relies on user-driven manual checks.
* **Reporting:** If you encounter a phishing attempt or a malicious fake profile, report it directly to Facebook through their official reporting channels.

## File Structure
```
.
├── main.py # Main CLI application script
├── facebook_analyzer/
│ ├── __init__.py # Makes facebook_analyzer a Python package
│ ├── phishing_detector.py # Logic for phishing message analysis
│ └── fake_profile_detector.py # Logic for fake profile interactive checklist
└── README.md # This documentation file
```

## Future Enhancements (Potential)

* Integration with external URL checking services/APIs (e.g., Google Safe Browsing) for more robust phishing detection.
* More sophisticated text analysis for phishing detection (e.g., NLP techniques).
* Allowing users to customize keyword lists.
* A graphical user interface (GUI) instead of a CLI.
```
# Global Security Platform

Welcome to the **Global Security Platform**, a centralized hub for digital protection, media verification, and advanced logistics management.

**Official Domain:** [global-security-platform.com](https://global-security-platform.com)

## Overview

The Global Security Platform provides a powerful suite of AI-driven tools designed to safeguard your digital life and optimize industrial operations. From detecting sophisticated phishing attempts to simulating 3D logistics environments, our platform integrates cutting-edge technology into a unified, accessible interface.

## Key Features

### 🛡️ Scam Analyzer
Heuristic-based detection system for phishing, fraudulent messages, and social engineering attempts. It leverages a centralized heuristics engine to identify urgency, sensitive info requests, and suspicious URL patterns.

### 📰 Fake News Detector
Analyzes news articles and social media posts for sensationalism, misinformation patterns, and clickbait, helping users navigate the digital information landscape.

### 🤖 AI Content Detector
Identifies text generated by large language models (LLMs) using linguistic patterns and robotic structure heuristics.

### 🔍 Fake Content Verifier
Tools to verify the authenticity of digital media and online profiles, including manual checklists and reverse image search guidance for identifying fake social media accounts.

### 🕶️ FBI AR Game
An immersive Augmented Reality (AR) training simulation built with Three.js and `@react-three/xr`. It teaches users how to identify security threats and manage evidence, which is then securely logged using blockchain-simulated technology.

### 📦 Logistics Digital Twin
A 3D warehouse simulation featuring blockchain-backed logistics tracking and IoT-driven anomaly detection. It includes an Incoterms 2020 navigator and AI route optimization tools.

## Tech Stack

### Frontend
- **React 18**: Component-based UI architecture.
- **Vite**: Ultra-fast build tool and development server.
- **Three.js & @react-three/fiber**: 3D rendering and simulation.
- **@react-three/xr**: VR/AR capabilities.
- **Ethers.js**: Integration for secure evidence logging and logistics tracking.

### Backend
- **Flask (Python)**: Light-weight API backend for text analysis.
- **NLTK**: Natural Language Toolkit for advanced processing.
- **Heuristics Engine**: Centralized logic for scam, fake news, and AI detection.

## Getting Started

### Prerequisites
- Node.js (v16+)
- Python 3.x

### Frontend Setup
1. Install dependencies:
```bash
npm install --legacy-peer-deps
```
2. Start the development server:
```bash
npm start
```
The application will be available at the address provided in your terminal (typically `http://localhost:3000`).

### Backend Setup
1. Install Python dependencies:
```bash
pip install -r requirements.txt
```
2. Set up the Python environment:
```bash
export PYTHONPATH=$PYTHONPATH:.
```
3. Run the Flask application (for example, in `text_message_analyzer`):
```bash
python app.py
```

## Contributing
We welcome contributions to enhance the security and capabilities of the platform. Please refer to `SECURITY.md` for reporting vulnerabilities.

## License
This project is licensed under the MIT License - see the `LICENSE` file for details.

---
© 2024 Global Security Platform | [global-security-platform.com](https://global-security-platform.com)
Loading