https://github.com/zis3c/google-form-spammer
A high-performance, asynchronous Google Forms spammer CLI. Features intelligent 429 status code rate limit handling, user-agent rotation, and massive concurrency. 🚀
https://github.com/zis3c/google-form-spammer
aiohttp asyncio automation cli educational google-forms python spammer stress-testing
Last synced: 5 months ago
JSON representation
A high-performance, asynchronous Google Forms spammer CLI. Features intelligent 429 status code rate limit handling, user-agent rotation, and massive concurrency. 🚀
- Host: GitHub
- URL: https://github.com/zis3c/google-form-spammer
- Owner: zis3c
- License: mit
- Created: 2025-12-31T16:38:15.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-01-02T01:22:49.000Z (5 months ago)
- Last Synced: 2026-01-05T01:34:42.834Z (5 months ago)
- Topics: aiohttp, asyncio, automation, cli, educational, google-forms, python, spammer, stress-testing
- Language: Python
- Homepage:
- Size: 26.4 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Google Forms Spammer
A high-performance, asynchronous Google Forms spammer built with Python and `aiohttp`. Capable of sending thousands of requests concurrently with intelligent 429 (Rate Limit) handling and user-agent rotation.
> [!WARNING]
> **Educational Purposes Only**: This tool is designed for educational purposes and stress testing systems you own. The authors are not responsible for any misuse.
## Features
- 🚀 **High Performance**: Asynchronous architecture allowing massive concurrency.
- 🎨 **Modern UI**: Beautiful, color-coded CLI interface with `rich` tables and panels.
- 🖥️ **Web Configurator**: Built-in web server to visually configure answers for complex forms.
- 🔄 **Smart Handling**: Automatically handles 429 Rate Limits and server errors.
- 🛡️ **Stealth**: Rotates User-Agents to mimic legitimate traffic.
- 🤖 **Auto-Discovery**: Automatically parses form questions (Text, MCQ, Checkboxes, Date, Time).
- 📝 **Validation**: Smart URL validation and retry loops for seamless user experience.
- 💻 **CLI & Interactive**: Run it fully automated via arguments or interactively.
## Installation
1. **Clone the repository**
```bash
git clone https://github.com/zis3c/google-form-spammer
cd google-form-spammer
```
2. **Install dependencies**
```bash
pip install -r requirements.txt
```
## Usage
### Interactive Mode
Simply run the script without arguments:
```bash
python main.py
```
Follow the prompts to enter the Form URL. You can choose between:
1. **Random Generation**: Automatically fills fields with plausible data.
2. **Custom Config**: Launches a local Web UI to visually configure specific answers for every question.
### Command Line Interface
To see all available options with descriptions:
```bash
python main.py --help
```
**Example Attack:**
```bash
python main.py --url "https://docs.google.com/forms/d/e/..." --count 1000 --workers 100
```
| Argument | Description | Default |
|----------|-------------|---------|
| `--url` | The full URL of the Google Form | - |
| `--count` | Number of requests to send | 100 |
| `--workers` | Number of concurrent async workers | 50 |
| `--custom-answer` | Custom text for open-ended questions | Random |
| `--help` | Show the help message and exit | - |
## How It Works
1. **Parsing**: The tool fetches the form HTML and uses regex to extract the `FB_PUBLIC_LOAD_DATA_` JSON blob, identifying all questions and input fields.
2. **Generation**: Random answers are generated based on question types (MCQ, Checkbox, Text).
3. **Async Attack**: A pool of async workers sends POST requests to the `formResponse` endpoint.
4. **Monitoring**: Real-time progress bar and stats (Success/Fail/Retries) are displayed using `rich`.
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.