Skip to content

Commit ed09756

Browse files
GYFX35GYFX35
authored
Merge pull request #29 from GYFX35/rebrand-global-security-platform-15693261204559084291
Update README for Global Security Platform rebranding
2 parents 0413eab + 7b2da8b commit ed09756

1 file changed

Lines changed: 83 additions & 101 deletions

File tree

‎README.md‎

Lines changed: 83 additions & 101 deletions
Original file line numberDiff line numberDiff line change
@@ -1,101 +1,83 @@
1-
# Facebook Security Analyzer CLI
2-
3-
This command-line tool provides utilities to help users analyze Facebook messages for potential phishing attempts and assess Facebook profiles for indicators of fakeness.
4-
5-
## Features
6-
7-
1. **Phishing Message Analysis:**
8-
* Accepts user-provided message text.
9-
* Scans for common phishing keywords (e.g., "verify your account," "urgent security alert").
10-
* Extracts URLs and checks them against patterns of suspicious URLs (e.g., impersonation of legitimate domains, use of URL shorteners, IP address links).
11-
* Provides a "suspicion score" and a summary of findings.
12-
13-
2. **Fake Profile Analysis (Manual Check):**
14-
* Accepts a Facebook profile URL from the user.
15-
* **Important:** This tool *does not* scrape Facebook or automatically access profile data, in compliance with Facebook's policies.
16-
* 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).
17-
* 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.
18-
* Calculates a "suspicion score" based on the user's answers and provides an assessment of how likely the profile is to be fake.
19-
20-
## Prerequisites
21-
22-
* Python 3.x
23-
24-
## Installation & Setup
25-
26-
1. **Clone the repository or download the files.**
27-
If you have the files (`main.py` and the `facebook_analyzer` directory) in a single project folder, no complex installation is typically needed.
28-
29-
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.
30-
31-
## How to Run
32-
33-
1. Open your terminal or command prompt.
34-
2. Navigate to the directory where you saved the `main.py` file and the `facebook_analyzer` folder.
35-
3. Run the application using the Python interpreter:
36-
```bash
37-
python main.py
38-
```
39-
40-
4. The tool will display a menu:
41-
42-
```
43-
--- Facebook Security Analyzer ---
44-
Choose an option:
45-
1. Analyze a message for phishing
46-
2. Analyze a Facebook profile for fakeness (manual check)
47-
3. Exit
48-
------------------------------------
49-
Enter your choice (1-3):
50-
```
51-
52-
## Usage
53-
54-
### 1. Analyze a message for phishing
55-
56-
* Select option `1`.
57-
* When prompted, paste the full text of the suspicious message and press Enter.
58-
* The tool will output:
59-
* A phishing likelihood score (higher is more suspicious).
60-
* Any suspicious keywords found.
61-
* Any suspicious URLs found, along with the reason they were flagged.
62-
* An overall summary.
63-
64-
### 2. Analyze a Facebook profile for fakeness (manual check)
65-
66-
* Select option `2`.
67-
* When prompted, enter the full Facebook profile URL (e.g., `https://www.facebook.com/some.profile`).
68-
* The tool will open the profile URL in your default web browser for your manual inspection.
69-
* You will then be guided through a series of yes/no questions based on your observations of the profile.
70-
* This includes an optional guided step to perform a reverse image search on the profile's picture.
71-
* After you answer all questions, the tool will provide:
72-
* A list of fake profile indicators you noted.
73-
* An overall "suspicion score."
74-
* An assessment category (e.g., Low, Medium, High likelihood of being fake).
75-
76-
## Disclaimer
77-
78-
* 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.
79-
* **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.
80-
* **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.
81-
* **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.
82-
* **Reporting:** If you encounter a phishing attempt or a malicious fake profile, report it directly to Facebook through their official reporting channels.
83-
84-
## File Structure
85-
```
86-
.
87-
├── main.py # Main CLI application script
88-
├── facebook_analyzer/
89-
│ ├── __init__.py # Makes facebook_analyzer a Python package
90-
│ ├── phishing_detector.py # Logic for phishing message analysis
91-
│ └── fake_profile_detector.py # Logic for fake profile interactive checklist
92-
└── README.md # This documentation file
93-
```
94-
95-
## Future Enhancements (Potential)
96-
97-
* Integration with external URL checking services/APIs (e.g., Google Safe Browsing) for more robust phishing detection.
98-
* More sophisticated text analysis for phishing detection (e.g., NLP techniques).
99-
* Allowing users to customize keyword lists.
100-
* A graphical user interface (GUI) instead of a CLI.
101-
```
1+
# Global Security Platform
2+
3+
Welcome to the **Global Security Platform**, a centralized hub for digital protection, media verification, and advanced logistics management.
4+
5+
**Official Domain:** [global-security-platform.com](https://global-security-platform.com)
6+
7+
## Overview
8+
9+
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.
10+
11+
## Key Features
12+
13+
### 🛡️ Scam Analyzer
14+
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.
15+
16+
### 📰 Fake News Detector
17+
Analyzes news articles and social media posts for sensationalism, misinformation patterns, and clickbait, helping users navigate the digital information landscape.
18+
19+
### 🤖 AI Content Detector
20+
Identifies text generated by large language models (LLMs) using linguistic patterns and robotic structure heuristics.
21+
22+
### 🔍 Fake Content Verifier
23+
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.
24+
25+
### 🕶️ FBI AR Game
26+
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.
27+
28+
### 📦 Logistics Digital Twin
29+
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.
30+
31+
## Tech Stack
32+
33+
### Frontend
34+
- **React 18**: Component-based UI architecture.
35+
- **Vite**: Ultra-fast build tool and development server.
36+
- **Three.js & @react-three/fiber**: 3D rendering and simulation.
37+
- **@react-three/xr**: VR/AR capabilities.
38+
- **Ethers.js**: Integration for secure evidence logging and logistics tracking.
39+
40+
### Backend
41+
- **Flask (Python)**: Light-weight API backend for text analysis.
42+
- **NLTK**: Natural Language Toolkit for advanced processing.
43+
- **Heuristics Engine**: Centralized logic for scam, fake news, and AI detection.
44+
45+
## Getting Started
46+
47+
### Prerequisites
48+
- Node.js (v16+)
49+
- Python 3.x
50+
51+
### Frontend Setup
52+
1. Install dependencies:
53+
```bash
54+
npm install --legacy-peer-deps
55+
```
56+
2. Start the development server:
57+
```bash
58+
npm start
59+
```
60+
The application will be available at the address provided in your terminal (typically `http://localhost:3000`).
61+
62+
### Backend Setup
63+
1. Install Python dependencies:
64+
```bash
65+
pip install -r requirements.txt
66+
```
67+
2. Set up the Python environment:
68+
```bash
69+
export PYTHONPATH=$PYTHONPATH:.
70+
```
71+
3. Run the Flask application (for example, in `text_message_analyzer`):
72+
```bash
73+
python app.py
74+
```
75+
76+
## Contributing
77+
We welcome contributions to enhance the security and capabilities of the platform. Please refer to `SECURITY.md` for reporting vulnerabilities.
78+
79+
## License
80+
This project is licensed under the MIT License - see the `LICENSE` file for details.
81+
82+
---
83+
© 2024 Global Security Platform | [global-security-platform.com](https://global-security-platform.com)

0 commit comments

Comments
 (0)