はじめに

この記事は、アイカツ！ Advent Calendar 2018の15日目の記事です。内容としては、現在大好評稼働中のアーケードゲーム、データカードダスアイカツフレンズ！のマイページから情報を取得するツールを作成中で、その内容と進捗の紹介になります。

前日の記事はkakakayaによるアイカツ！のマイページから情報を取得するやつを作るその2 - Qiitaでした。

ちなみに、これまでアイカツ！ Advent Calendar 2018では以下のような技術系記事が投稿されています。

aikatsu-dcd-parser

kakakaya/aikatsu-dcd-parser: Fetch and parse Aikatsu! DCD mypage data.
取得及びパースをするライブラリ本体と、それを利用したCLIツールの2つが含まれており、いずれも dcdkatsu という名前でインポートや実行が可能です。詳細はこれまでの記事やREADME、GoDocなどを参照してください。

遊ぶ

ある程度作ったところで誰か別の方が遊んでみる記事を出すかなと期待していたものの出なかったので自分で遊び方のサンプルを作ろうと思いました。

ステップバイステップで解説しているので、とにかく試してみたい！という方は下の方にワンライナーをまとめてあるのでそちらを参照してください。

準備

この記事でやってることを自分で試したい場合、以下のツールを導入しておく必要があります。

各弾の獲得済み・未獲得カード枚数を調べてみる

v0.2.0からデジタルバインダーやカードを取得する機能が追加され、各弾ごとのカード一覧や取得状況、各カードの詳細なデータを調べることが可能になりました。とはいえ、生の出力は以下のような感じなので、機械には読みやすい形式ですが人間の方は見にくいと感じるかもしれません。
（owned:true になっているものが獲得済み、owned:false になっているものが未獲得を表しています。カードの詳細がほとんど空になっているのは、通信回数を最小限にして不要なサーバへの通信を防ぐためで、詳細情報の取得については後半で取り扱います。）

デジタルバインダーの出力例

{
  "series_id": 16,
  "series_name": "フレンズ5弾",
  "cards": [
    {
      "code": "F5-1", "name": "", "rarity": "BFR", "stars": "", "type": "", "category": "", "brand": "", "dress_appeal": "", "appeal_point": 0, "owner_id": "RX...3x", "owned": false, "series_id": 16,
      "url": "http://mypage.aikatsu.com/mypages/detail/NP10_H5_U_PR_Qt_001_T01/_00/16/RX...3x/",
      "image_url": "http://mypage.aikatsu.com/images/cardlist/card/458005/f5-1bfr_00.png"
    },
    {
      "code": "F5-2", "name": "", "rarity": "BFR", "stars": "", "type": "", "category": "", "brand": "", "dress_appeal": "", "appeal_point": 0, "owner_id": "RX...3x", "owned": false, "series_id": 16,
      "url": "http://mypage.aikatsu.com/mypages/detail/NP10_H5_U_PR_Qt_001_B01/_00/16/RX...3x/",
      "image_url": "http://mypage.aikatsu.com/images/cardlist/card/458005/f5-2bfr_00.png"
    },
    ...
  ],
  "owner_id": "RX...3x",
  "url": "http://mypage.aikatsu.com/mypages/digital_binders/RX...3x/16",
  "data_get_date": "2018-12-15T14:09:00+09:00"
}

これを、人間にも読みやすい形式にしてみようと思います。

取得したいユーザーのIDを確認する
- 例えば自分自身のデータを取得したい場合、マイページからログインして、最下部のSNS共有ボタンからURLを得られます。
  - http://mypage.aikatsu.com/mypages/index/RX...3x/ のような形式。
- そのうちのRX...3xの部分をユーザーIDと呼称しています。
  - プライバシー保護の観点から一部を...にしていますが、実際には英数字のみが含まれるようです。
デジタルバインダーのデータを取得し、一旦ファイルに保存する
- dcdkatsu binder "RX...3x" 15 > digital_binder.json
- 15は4弾を表しています。16が5弾、12が1弾に相当しているようです。
カード以外の情報を見てみる
- cat digital_binder.json | jq 'del(.cards)'

{
"series_id": 15,
"series_name": "フレンズ4弾",
"owner_id": "RX...3x",
"url": "http://mypage.aikatsu.com/mypages/digital_binders/RX...3x/15",
"data_get_date": "2018-12-15T13:36:00+09:00"
}
```
- 良さげですね。
4. カードが全部で何枚あるのか見てみる
- cat digital_binder.json | jq '.cards | length'

```json

112
```
5. 取得済みカードが何枚あるのか見てみる
- cat digital_binder.json | jq '.cards | map(select(.owned == true)) | group_by(.) | length'

```json

61
```
5. 未取得カードが何枚あるのか見てみる
- cat digital_binder.json | jq '.cards | map(select(.owned == false)) | group_by(.) | length'

```json

51
```
- ミュージアムをやり忘れてたのが敗因です。
6. BFRの取得率を確認する
- v0.3.0からバインダー内の通し番号（F5-1 みたいなやつ、以下コードと呼称）とレアリティも取得できるようになりました。これを利用して、BFRのカードだけで取得率を確認してみます。
- まずBFRの枚数を確認してみます。
- `cat digital_binder.json | jq '.cards | map(select(.rarity == "BFR")) | length'`
- => `24`
- 所持済みのものに絞って枚数を確認する
- `cat digital_binder.json | jq '.cards | map(select(.rarity == "BFR")) | map(select(.owned == true)) | length'`
- => `16`
- というわけで、2/3を獲得できていたようです。
- （group_byを活用してワンライナーでやろうとしていたものの思いつかず失敗）

カードの詳細を表示してみる

カードについても見ていきましょう。上記バインダー関連のコマンドから得られるURLを指定することで、以下のようなデータが取得されます。

dcdkatsu card http://mypage.aikatsu.com/mypages/detail/NP09_H4_U_R_Co_001_T02/_00/15/RX...3x/

{
  "code": "F4-24",
  "name": "ブリリアントソワレトップス",
  "rarity": "ベストフレンズレア",
  "stars": "★★★",
  "type": "クール",
  "category": "トップス",
  "brand": "ノーブランド",
  "dress_appeal": "ベストフレンズマーチ",
  "appeal_point": 950,
  "owner_id": "RX...3x",
  "owned": false,
  "series_id": 15,
  "url": "http://mypage.aikatsu.com/mypages/detail/NP09_H4_U_R_Co_001_T02/_00/15/RX...3x",
  "image_url": "http://mypage.aikatsu.com/images/cardlist/card/458004/f4-24bfr_00.png"
}

F4-17  http://mypage.aikatsu.com/mypages/detail/NP09_H4_U_PR_Co_002_B01/_00/15/RX...3x/
F4-19  http://mypage.aikatsu.com/mypages/detail/NP09_H4_U_PR_Co_002_A01/_00/15/RX...3x/
F4-20  http://mypage.aikatsu.com/mypages/detail/NP09_H4_U_R_Co_001_T01/_00/15/RX...3x/
F4-22  http://mypage.aikatsu.com/mypages/detail/NP09_H4_U_R_Co_001_S01/_00/15/RX...3x/
F4-24  http://mypage.aikatsu.com/mypages/detail/NP09_H4_U_R_Co_001_T02/_00/15/RX...3x/
F4-44  http://mypage.aikatsu.com/mypages/detail/NP09_H4_U_PR_Se_001_B01/_00/15/RX...3x/
F4-45  http://mypage.aikatsu.com/mypages/detail/NP09_H4_U_PR_Se_001_S01/_00/15/RX...3x/
F4-49  http://mypage.aikatsu.com/mypages/detail/NP09_H4_U_PR_Se_002_S01/_00/15/RX...3x/

曖昧検索のツールであるfzfを利用して上から絞り込んでみます。

これを上記カード取得や画像表示と組み合わせてみましょう。

image="$(cat digital_binder.json | jq -c '.cards | map(select(.rarity == "BFR")) | map(select(.owned == false)) | .[] | "\(.code) \(.url)"' | sed 's/"//g' | fzf | cut -d ' ' -f 3 | xargs -n 1 -I % dcdkatsu card % | jq '.image_url' | sed 's/"//g')"; wget $image && echo $image | awk -F '/' '{print $NF}' | xargs -n 1 -I % catimg %

上記コマンドで画像をダウンロードしてcatimgでターミナルへ出力した例が以下のようになります。

一番下にプロンプトが表示されてるのが確認できるでしょうか。

おわりに

本記事ではいくつかの遊び方を書きました。まとめてみましょう。

4弾の持ってないカードを数える
- dcdkatsu binder "RX...3x" 15 | jq '.cards | map(select(.owned == false)) | group_by(.) | length'
持っていない4弾のBFRカードを選択して画像を取得し、ターミナルに出力する
- image="$(dcdkatsu binder "RX...3x" 15 | jq -c '.cards | map(select(.rarity == "BFR")) | map(select(.owned == false)) | .[] | "\(.code) \(.url)"' | sed 's/"//g' | fzf | cut -d ' ' -f 3 | xargs -n 1 -I % dcdkatsu card % | jq '.image_url' | sed 's/"//g')"; wget $image && echo $image | awk -F '/' '{print $NF}' | xargs -n 1 -I % catimg %
- jqの引数をいじると色々できます。

他にも次のような遊び方ができそうです。

カードの取得日時を自動で記録する
デジタルバインダーをオフライン用に出力する
アピールポイントが高い順・低い順に並び替える
などなど

今後も aikatsu-dcd-parserの機能追加を行っていく予定ですので、それによりより多くの遊び方ができるかもしれません。

なお、今後以下のような機能の実装を考えています。

取得間隔の制限（サーバへの負荷を防ぐため）
取得可能な機能の追加
- ログインが必要な部分の取得
  - フレンズ
  - バッジ
  - ランキング実績
  - 大会実績
  - アーカイブ
    - アイカツスターズ！1弾〜5弾
    - アイカツスターズ！星のツバサ編
    - ↑色々違っていて面倒そうという気分
取得結果の保存、差分表示
テストの作成、CI
- やるだけ
- ランキング周りが面倒そう
- v0.2.0でアホなミスしたので早く入れたい
リリース方法のいい感じ化
- .debを配布したい
- AURに置きたい

他にも欲しい機能やマサカリがあったら、この記事のコメントにお願いします。これは非公式なものであり、データカードダスアイカツフレンズ！公式や、バンダイナムコ、その他権利者の方に問い合わせないようお願いします。また、怒られたらすぐに消します。

明日は未定です。