Musixmatch

1 post with the tag “Musixmatch”

Musixmatchの署名

2025/01/09

Musixmatch で歌詞を取得する際に、以下のようなパラメータが確認できます。

• app_id: mxm-com-v1.0
• usertoken: ${USER_TOKEN}
• track_spotify_id: XXXXXXXXXXXXXXXXXXX
• part: track_lyrics_translation_status,lyrics_crowd,user,subtitle_translated,lyrics_translated,attribution,itunes_commontrack_ids,lyrics_verified_by,labels,track_structure,artist,artist_list,file_upladed_list,uploaded_file_list,artist_image_tagged,artist_image
• signature: ${signature}
• signature_protocol: sha256

この${signature}を求めることができれば好きに API を叩けそうです。（流石に制限はありそうですが）

signature を求めるコード

import hmac
import hashlib
import base64
from urllib.parse import urlparse, urlunparse, parse_qsl, urlencode
from datetime import datetime, timezone


def reverse_and_decode_base64(encoded_str: str) -> bytes:
    reversed_str = encoded_str[::-1]
    try:
        decoded_bytes = base64.b64decode(reversed_str)
        return decoded_bytes
    except Exception as e:
        raise


def generate_signature(
    url: str,
    default_client_key_reversed_base64: str = "=UjMilTNwczNwEDO4UjZ5QjYjZjMlBDNmZjZ4QjM1cjN",
) -> str:
    client_key = reverse_and_decode_base64(
        default_client_key_reversed_base64
    )  # -> b'675248f6f40e26cb49f5881077059b25'

    parsed_url = urlparse(url)
    query_list = parse_qsl(parsed_url.query, keep_blank_values=True)

    clean_query_list = [
        (k, v) for k, v in query_list if k not in ("signature", "signature_protocol")
    ]

    clean_query = urlencode(clean_query_list, doseq=True)

    clean_url = urlunparse(
        (
            parsed_url.scheme,
            parsed_url.netloc,
            parsed_url.path,
            parsed_url.params,
            clean_query,
            parsed_url.fragment,
        )
    )

    now = datetime.now(timezone.utc)
    year = now.strftime("%Y")
    month = now.strftime("%m")
    day = now.strftime("%d")

    message = f"{clean_url}{year}{month}{day}"

    hmac_message = message.encode("utf-8")
    signature = hmac.new(client_key, hmac_message, hashlib.sha256).digest()

    signature_b64 = base64.b64encode(signature).decode("utf-8")

    signed_query_list = clean_query_list + [
        ("signature", signature_b64),
        ("signature_protocol", "sha256"),
    ]

    signed_query = urlencode(signed_query_list, doseq=True)

    signed_url = urlunparse(
        (
            parsed_url.scheme,
            parsed_url.netloc,
            parsed_url.path,
            parsed_url.params,
            signed_query,
            parsed_url.fragment,
        )
    )

    return signed_url

どうでもいい話

何かしらの曲を再生した際にhttps://www.musixmatch.com/ws/1.1/track.get?app_id=...へのリクエストがあるはずです。

ブラウザ > DevTools > ネットワーク > track.get?app_id=... > イニシエータ > 一番上の js ファイル

に以下のような記述があります。

u = i.from("=UjMilTNwczNwEDO4UjZ5QjYjZjMlBDNmZjZ4QjM1cjN".split("").reverse().join(""), "base64").toString()
CLIENT_KEY: u,

        var tQ = (et = (0,
        tA.Z)(tj().mark(function e(t) {
            return tj().wrap(function(e) {
                for (; ; )
                    switch (e.prev = e.next) {
                    case 0:
                        if (!tR.Nq) {
                            e.next = 4;
                            break
                        }
                        return e.abrupt("return", crypto.subtle.importKey("raw", new TextEncoder().encode(t), {
                            hash: {
                                name: "SHA-256"
                            },
                            name: "HMAC"
                        }, !1, ["sign"]));
                    case 4:
                    case "end":
                        return e.stop()
                    }
            }, e)
        })),
        function(e) {
            return et.apply(this, arguments)
        }
        )
          , tJ = (en = (0,
        tA.Z)(tj().mark(function e(t, n) {
            var r;
            return tj().wrap(function(e) {
                for (; ; )
                    switch (e.prev = e.next) {
                    case 0:
                        if (!tR.Nq) {
                            e.next = 7;
                            break
                        }
                        return e.next = 3,
                        crypto.subtle.sign("HMAC", t, new TextEncoder().encode(n));
                    case 3:
                        return r = e.sent,
                        e.abrupt("return", btoa(String.fromCharCode.apply(null, new Uint8Array(r))));
                    case 7:
                        return e.abrupt("return", "");
                    case 8:
                    case "end":
                        return e.stop()
                    }
            }, e)
        })),
        function(e, t) {
            return en.apply(this, arguments)
        }
        )
          , t0 = void 0
          , t1 = (er = (0,
        tA.Z)(tj().mark(function e(t, n) {
            var r, i, o, a, s, u;
            return tj().wrap(function(e) {
                for (; ; )
                    switch (e.prev = e.next) {
                    case 0:
                        if (r = new URL(t),
                        t0) {
                            e.next = 5;
                            break
                        }
                        return e.next = 4,
                        tQ(n);
                    case 4:
                        t0 = e.sent;
                    case 5:
                        return o = (i = new Date).getUTCFullYear().toString(),
                        a = tX(i.getUTCMonth() + 1),
                        s = tX(i.getUTCDate()),
                        r.searchParams.delete("signature"),
                        r.searchParams.delete("signature_protocol"),
                        e.next = 13,
                        tJ(t0, r.toString() + o + a + s);
                    case 13:
                        return u = e.sent,
                        r.searchParams.set("signature", u),
                        r.searchParams.set("signature_protocol", "sha256"),
                        e.abrupt("return", r.toString());
                    case 17:
                    case "end":
                        return e.stop()
                    }
            }, e)
        })),

そのため

• client_key: "=UjMilTNwczNwEDO4UjZ5QjYjZjMlBDNmZjZ4QjM1cjN"を逆順に並び替え、Base64 デコードしたもの
• clean_url: リクエスト URL からクエリパラメータsignatureとsignature_protocolを削除したもの
• hmac_message: 現在の UTC 日付を取得し、次のように各要素を連結"{clean_url}{year}{month}{day}"
• signature: client_keyにてhmac_messageを HMAC-SHA256 署名し、Base64 エンコード

という手順で signature を形成していると考えられます。（後出しジャンケン）

Tags:

• Musixmatch