Kicktipp Webhook Integration

This project implements a Kicktipp API that fetches leaderboard data and sends updates to a discord webhook. It is designed to periodically refresh subscriptions and notify users about game predictions as soon as the game starts.

Table of Contents

• Kicktipp Webhook Integration
  • Table of Contents
  • ⚠️ Important Notice
  • Installation
  • Configuration
  • Usage
    • What does the application do
  • Missing features:
  • Project Structure
  • Contributing
  • Testing
  • License

⚠️ Important Notice

This project was specifically developed for the UEFA Euro 2024. Future updates are not planned.

Update 2026: The project has been updated to work for the UEFA World Cup 2026 and some improvements and changes have been made.

Webhook Message Example

Installation

1. Clone the repository:

git clone https://github.com/MrAlexand0r/kicktipp.com_discord_webhook

2. Install dependencies:

npm install

Alternatively use nixpacks.

Configuration

Create a .env file in the root directory and add the following environment variables:

KICKTIPP_BASEURL=https://www.kicktipp.com/your-game
KICKTIPP_USERNAME=your_username 
KICKTIPP_PASSWORD=your_password 
WEBHOOK_URL=your_discord_webhook_url
USER_ID_MAP={"user": "discord_id"} # Maps kicktipp user to Discord ID (or use this structure for flexible mapping)

Usage

Start the application:

npm start

What does the application do

• Initialize the Kicktipp API with your credentials.
• Set up jobs that subscribe to the leaderboard and listen for game updates.
• Send discord webhook messages with game predictions.

Missing features:

• Webhook message when game is over with results
• Webhook message when game is over with leaderboard standings

Project Structure

• index.ts: Main entry point of the application. Initializes the Kicktipp API and sets up daily refreshes.
• src/webhook.ts: Contains the Webhook class responsible for subscribing to the leaderboard, generating webhook messages, and sending them.
• api/kicktipp.ts: Contains the Kicktipp class responsible for scraping and parsing kicktipp.com, currently implemented and working are login and fetching leaderboard data.
• src/userIdMap.json: Maps user IDs to Discord IDs for personalized messages.

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

Testing

For testing if the Configuration was successful, you can start the application with npm run test -- <index>, index being which game of the current leaderboard to select. It will start the application normally, but will also immediately try to send a webhook to discord with the selected game info.

License

This project is licensed under the GPL License.