https://github.com/patbaumgartner/swiss-coupon-booster
A Spring Boot application that helps you automatically activate all available digital coupons from Switzerland's leading retailers, Migros (Cumulus) and Coop (SuperCard).
https://github.com/patbaumgartner/swiss-coupon-booster
coupons spring-boot
Last synced: about 1 month ago
JSON representation
A Spring Boot application that helps you automatically activate all available digital coupons from Switzerland's leading retailers, Migros (Cumulus) and Coop (SuperCard).
- Host: GitHub
- URL: https://github.com/patbaumgartner/swiss-coupon-booster
- Owner: patbaumgartner
- License: apache-2.0
- Created: 2025-08-18T09:37:59.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2026-04-13T11:16:25.000Z (about 2 months ago)
- Last Synced: 2026-04-13T13:20:13.128Z (about 2 months ago)
- Topics: coupons, spring-boot
- Language: Java
- Homepage:
- Size: 461 KB
- Stars: 1
- Watchers: 0
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# Swiss Coupon Booster
[](https://github.com/patbaumgartner/swiss-coupon-booster/actions/workflows/ci.yml)
[](https://sonarcloud.io/summary/new_code?id=patbaumgartner_swiss-coupon-booster)
[](https://sonarcloud.io/summary/new_code?id=patbaumgartner_swiss-coupon-booster)
[](https://sonarcloud.io/summary/new_code?id=patbaumgartner_swiss-coupon-booster)
[](https://sonarcloud.io/summary/new_code?id=patbaumgartner_swiss-coupon-booster)
A Spring Boot application that helps you automatically activate all available digital coupons from Switzerland's leading retailers, Migros (Cumulus) and Coop (SuperCard).
## About The Project
This project leverages web automation technology (Microsoft Playwright) to log into your Migros and Coop accounts, discover all available digital coupons, and activate them on your behalf. It saves you the time and hassle of manually checking for and activating each coupon, ensuring you never miss out on potential savings.
The application is built with a strong focus on code quality and security, incorporating a comprehensive suite of tools for static analysis, vulnerability scanning, and testing.
### Key Features
- 🎫 Automated coupon discovery and activation for Migros and Coop.
- 🤖 Browser automation powered by Microsoft Playwright for robust interaction with modern web applications.
- 📊 Detailed reporting on activated coupons.
- 🔒 Integrated security vulnerability scanning with OWASP Dependency-Check.
- 📈 High code coverage and mutation testing (PIT) to ensure reliability.
- 🎯 Static code analysis with SpotBugs for identifying potential bugs early.
## Getting Started
Follow these steps to get a local copy up and running.
### Prerequisites
- **Java 25** or higher
- **Maven 3.6+**
### Installation & Running
1. **Clone the repository:**
```sh
git clone https://github.com/patbaumgartner/swiss-coupon-booster.git
cd swiss-coupon-booster
```
2. **Configure your credentials:**
Open the `src/main/resources/application.yml` file and provide your account credentials for Migros and Coop. See the [Configuration](#configuration) section for more details.
3. **Build and run the application:**
You can run the application directly using the Spring Boot Maven plugin:
```sh
mvn spring-boot:run
```
Alternatively, you can build the project and run the JAR file:
```sh
mvn clean install
java -jar target/swiss-coupon-booster-*.jar
```
## Configuration
The application requires your personal account credentials to be configured in `src/main/resources/application.yml`.
```yaml
migros:
user:
email: "${MIGROS_USER_EMAIL}"
password: "${MIGROS_USER_PASSWORD}"
coop:
user:
email: "${COOP_USER_EMAIL}"
password: "${COOP_USER_PASSWORD}"
playwright:
cookiesFilePath: "${COOP_COOKIES_FILE_PATH}"
```
**Important:** The application uses regular environment variables (or a `.env` file) for configuration.
### Cookie Configuration for Coop
For the initial authentication, you can optionally provide cookies in Netscape format (the same format used by curl).
**How to provide cookies:**
1. Export cookies from your browser using an extension like:
- "Get cookies.txt LOCALLY" for Chrome/Edge
- "cookies.txt" for Firefox
2. Set the path to the file in your `.env`:
```bash
COOP_COOKIES_FILE_PATH=/path/to/your/cookies.txt
```
See [cookies.txt.example](cookies.txt.example) for the format specification.
**Note:** Providing cookies is **optional**. The application is designed to handle bot detection automatically using stealth measures. However, if you experience login issues or captchas, providing cookies can help bypass these checks. On the first successful run, the browser profile is cached locally, reducing the need for cookies in subsequent runs.
## Usage
Once the application is running, the coupon activation process is triggered automatically on startup. The application will log its progress to the console, detailing the coupons it finds and activates. After the process is complete, the application will exit.
## Contributing
Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
## License
Distributed under the MIT License. See `LICENSE` for more information.