Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lalaio1/wp-checker
Advanced WordPress Credential Checker: A tool for efficiently validating WordPress credentials and generating detailed reports.
https://github.com/lalaio1/wp-checker
api checker wordpress wordpress-hacking wp-checker
Last synced: about 1 month ago
JSON representation
Advanced WordPress Credential Checker: A tool for efficiently validating WordPress credentials and generating detailed reports.
- Host: GitHub
- URL: https://github.com/lalaio1/wp-checker
- Owner: lalaio1
- License: apache-2.0
- Created: 2024-09-16T16:06:54.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-10-27T02:02:37.000Z (3 months ago)
- Last Synced: 2024-10-28T03:47:07.614Z (3 months ago)
- Topics: api, checker, wordpress, wordpress-hacking, wp-checker
- Language: Python
- Homepage:
- Size: 854 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🛠️ wp-checker
Welcome to the wp-checker! This tool is designed to efficiently verify WordPress credentials and provide detailed reports.
---
## 🌟 Features
- ✅ Validates WordPress credentials
- ❌ Identifies invalid credentials
- 🌐 Detects offline sites
- 📊 Generates comprehensive reports in various formats (CSV, JSON, XML, YAML, SQL, Parquet)
- 🛠️ Multi-threaded processing for faster performance
- ⏱️ Configurable delay between requests
## 📸 Screenshots
---
---
---
## 📚 Installation
### Windows
1. **Install Python**: Download and install the latest version of Python from [python.org](https://www.python.org/downloads/).
2. **Clone the repository**:
```bash
git clone https://github.com/lalaio1/wp-checker
cd wp-checker
```
3. **Install dependencies**:
```bash
pip install -r requirements.txt
```
4. **Run**:
```bash
python wp-checker.py -h
```
### Linux
1. **Install Python**: Use your package manager to install Python, e.g.,
```bash
sudo apt update
sudo apt install python3 python3-pip
```
2. **Clone the repository**:
```bash
git clone https://github.com/lalaio1/wp-checker
cd wp-checker
```
3. **Install dependencies**:
```bash
pip3 install -r requirements.txt
```
4. **Run**:
```bash
python3 wp-checker.py -h
```
### Mac
1. **Install Python**: Use Homebrew to install Python,
```bash
brew install python
```
2. **Clone the repository**:
```bash
git clone https://github.com/lalaio1/wp-checker
cd wp-checker
```
3. **Install dependencies**:
```bash
pip3 install -r requirements.txt
```
4. **Run**:
```bash
python3 wp-checker.py -h
```
### Termux
1. **Install Python**:
```bash
pkg install python3
pkg install git
```
2. **Clone the repository**:
```bash
git clone https://github.com/lalaio1/wp-checker
cd wp-checker
```
3. **Install dependencies**:
```bash
pip install -r requirements.txt
```
4. **Run**:
```bash
python3 wp-checker.py -h
```
## 🎨 Usage (exemple):
Run the script with the following command:
```bash
python wp-checker.py path/to/your/file -v valid_file -i invalid_file -off offline_file -s -t 10 -o report -f csv -d 0.5
```
### Arguments:
| Argument | Description | Default |
|-------------------|----------------------------------------------|-------------|
| `file` | Path to the file with URLs and credentials | Required |
| `-v`, `--valid` | File to save valid credentials | None |
| `-i`, `--invalid` | File to save invalid credentials | None |
| `-off`, `--offline` | File to save offline sites | None |
| `-s`, `--skip-ping` | Skip ping check | False |
| `-cwv`, `--check-wp-version` | Check the WordPress version for each site | False |
| `-t`, `--threads` | Number of threads to use | 10 |
| `-o`, `--output` | Output file for the full report | report |
| `-f`, `--format` | Output format for the report | csv |
| `-d`, `--delay` | Delay between requests in seconds | 0 |
---
## 📋 File Format
For **wp-checker** to function correctly, the provided `.txt` file must follow the format below:
```
(url):(user):(password)
```
### Example Format:
```
http://example.com/wp-login.php:admin:password123
https://anotherexample.com/wp-login.php:user:mysecurepassword
```
### Format Details:
- **URL**: The WordPress site address you want to check, ending with `wp-login.php`.
- **User**: The username for authentication on the WordPress site.
- **Password**: The password associated with the username.
Each line of the file should contain a set of credentials in the specified format, separated by colons (`:`). Ensure there are no extra spaces around the colons.
---
## 📡 API Integration
The **wp-checker** now includes a powerful API that allows for seamless integration and automated checking of WordPress credentials. This API enhances the functionality of the main tool by enabling developers to incorporate credential verification into their applications.
### 🚀 Features of the API
- **Health Check**: Check the status of the API.
- **Credential Verification**: POST requests to verify WordPress credentials.
- **Rate Limiting**: Protects the API from excessive requests.
- **Customizable Parameters**: Specify options such as output format and threading directly in your requests.
### 🌐 API Documentation
For detailed API usage and examples, please visit the API documentation:
[API Documentation](https://github.com/lalaio1/wp-checker/tree/main/api)
### 💡 Quick Start
To run the API server, follow these steps:
1. Navigate to the `api` directory:
```bash
cd wp-checker/api
```
2. Start the API server:
```bash
python api.py
```
You can then send requests to the API at `http://localhost:5000/check` (or the configured port).