MTG Player Info

A simple NPM module and CLI tool to pull Magic: The Gathering player data from various sources (Unity League, MTG Elo Project, Melee, Topdeck, and Untapped.gg).

Installation

npm i -g mtg-playerinfo

CLI Usage

mtg-playerinfo --unity-id 16215 --mtgelo-id 3irvwtmk --melee-user k0shiii --topdeck-handle k0shiii --untapped-id 7de50700-c3f6-48e4-a38d-2add5b0d9b71/76DCDWCZS5FX5PIEEMUVY6GV74

or without previous installation

npx mtg-playerinfo --unity-id 16215 --mtgelo-id 3irvwtmk --melee-user k0shiii --topdeck-handle k0shiii --untapped-id 7de50700-c3f6-48e4-a38d-2add5b0d9b71/76DCDWCZS5FX5PIEEMUVY6GV74

Output Format

The tool returns a JSON object representing the player and their combined metadata. Redundant information like name, photo, country, age, and hometown is merged into a general section, while source-specific data is kept in the sources section.

General meta-data and merging priority

General meta-data fields like name, photo, age, country, and hometown are extracted from the first source that provides them and placed in the general section. Merging follows a "first-come, first-served" approach based on the order of sources provided in the command line or processed by the manager. In the CLI usage example above, the source priority is Unity League > MTG Elo Project > Melee > Topdeck > Untapped.gg.

If you notice any inconsistencies or unexpected fields values, you can run the tool with the -v or --verbose flag to see the full list of extracted fields and if they were promoted to the general section or deviated from a previous source.

Example output

{
  "general": {
    "name": "Björn Kimminich",
    "photo": "https://unityleague.gg/media/player_profile/1000023225.jpg",
    "age": "45",
    "bio": "Smugly held back on an Untimely Malfunction against a Storm player going off, being totally sure that you can redirect the summed-up damage of their Grapeshots back to their face with its \"Change the target of target spell or ability with a single target\" mode.",
    "team": "Mull to Five",
    "country": "de",
    "hometown": "Hamburg",
    "pronouns": "He/Him",
    "facebook": "bjoern.kimminich",
    "twitch": "koshiii",
    "youtube": "@BjörnKimminich",
    "mtga_rank": {
      "constructed": "Platinum 3",
      "limited": "Bronze 4"
    },
    "win rate": "47.45%"
  },
  "sources": {
    "Unity League": {
      "url": "https://unityleague.gg/player/16215/",
      "data": {
        "name": "Björn Kimminich",
        "photo": "https://unityleague.gg/media/player_profile/1000023225.jpg",
        "country": "de",
        "age": "45",
        "hometown": "Hamburg",
        "local organizer": "Mulligan TCG Shop",
        "team": "Mull to Five",
        "bio": "Smugly held back on an Untimely Malfunction against a Storm player going off, being totally sure that you can redirect the summed-up damage of their Grapeshots back to their face with its \"Change the target of target spell or ability with a single target\" mode.",
        "rank germany": "62",
        "rank europe": "506",
        "rank points": "334",
        "record": "52-47-5",
        "win rate": "51.6%"
      }
    },
    "MTG Elo Project": {
      "url": "https://mtgeloproject.net/profile/3irvwtmk",
      "data": {
        "name": "Bjoern Kimminich",
        "player_id": "3irvwtmk",
        "current_rating": "1466",
        "record": "9-12-1",
        "win rate": "40.91%"
      }
    },
    "Melee": {
      "url": "https://melee.gg/Profile/Index/k0shiii",
      "data": {
        "name": "Björn Kimminich",
        "pronouns": "He/Him",
        "bio": "Smugly held back on an Untimely Malfunction against a Storm player going off, being totally sure that you can redirect the summed-up damage of their Grapeshots back to their face.",
        "facebook": "bjoern.kimminich",
        "twitch": "koshiii",
        "youtube": "@BjörnKimminich"
      }
    },
    "Topdeck": {
      "url": "https://topdeck.gg/profile/@k0shiii",
      "data": {
        "name": "Björn Kimminich",
        "photo": "https://imagedelivery.net/kN_u_RUfFF6xsGMKYWhO1g/2a7b8d12-5924-4a58-5f9c-c0bf55766800/square",
        "pronouns": "He/Him",
        "twitter": "bkimminich",
        "youtube": "@BjörnKimminich",
        "tournaments": "2",
        "record": "4-6-1",
        "win rate": "36.36%",
        "conversion": "0%"
      }
    },
    "Untapped.gg": {
      "url": "https://mtga.untapped.gg/profile/7de50700-c3f6-48e4-a38d-2add5b0d9b71/76DCDWCZS5FX5PIEEMUVY6GV74",
      "data": {
        "mtga_rank": {
          "constructed": "Platinum 3",
          "limited": "Bronze 4"
        }
      }
    }
  }
}

Supported Sources

The following sites are currently supported based on HTML scraping and/or API calls. In general, API calls are preferred over scraping due to their higher reliability and independence from site structure changes.

Site	Method
Unity League	✅Scraping
MTG Elo Project	✅Scraping
Topdeck	✅Scraping / ✅API
Melee	✅Scraping / 🚧API (#1)
Untapped.gg	✅API

Note: Some sites may have anti-bot protections that can lead to "Maximum number of redirects exceeded" or "403 Forbidden" errors depending on the execution environment.

Contribution Guidelines

1. All PRs should have a dedicated scope (e.g. not mixing code refactorings with delivering a new feature) and reasonable size.
2. Noise (e.g. unnecessary comments) generated by AI tools must be removed before opening a PR.
3. All Git commits within a PR must be signed off to indicate the contributor's agreement with the Developer Certificate of Origin.
4. Particularly low-effort contributions (e.g. incomplete typo fixes in a single file, trivial text changes, code formatting) or any forms of potential "contribution farming" must not be submitted as PRs.

Licensing

This program is free software: you can redistribute it and/or modify it under the terms of the MIT license. MTG Player Info and any contributions are Copyright © by Bjoern Kimminich 2026.