過去に聞いた曲のランキングを毎週ツイートするbotを作った(Last.fm)

**完成物のランキング画像↓**
![EnzkcTDWEAAs4fc.jpeg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/489646/dfe7e67f-1c33-85a8-9d6f-77591cc49f70.jpeg)



**完成物のツイート↓**
https://twitter.com/sorarakara/status/1332190766471507970?s=20
![Screen Shot 2020-11-27 at 14.54.09.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/489646/57e295f5-6f2f-c83b-a4e7-24da1df6dc0d.png)

#どんなBot？
毎週、毎月、毎年、スマホやPCで聞いた楽曲の再生回数ランキングをツイートします。
### ツイート内容
- 順位（10位まで）
- タイトル
- アーティスト
- 再生回数


# ソースコード
https://github.com/Sorara33/last-fm-twitter

#対象者
プログラミング超初心者以外を想定しました。
もしもPythonとHerokuを使用した経験があれば、Last.fmの登録をして、ソースコードのリポジトリをクローンすれば多分すぐにできます。

#前提
[Last.fm](https://www.last.fm/ja/)というサービスに登録しておいて、何曲か音楽をScrobble（再生した楽曲をリアルタイム記録）しておいてください。もちろん無料。
PCでもスマホでも、対応するアプリを入れれば自動で記録してくれます。２つ以上のscrobbleソフトを使うと記録が重複してしまうので注意。
Androidスマホだと、おすすめは[このアプリ](https://play.google.com/store/apps/details?id=com.peterjosling.scroball&hl=ja)。
通信データ量はほぼなし。
詳しくはググってください。

##環境
- プログラミング言語：Python 3.7.3
- 使用API：Last.fm API
- 使用SDK：Tweepy, line-bot-sdk(LINE Bot)
- デプロイ先：Heroku
- ローカルPC：Mac OS
- 開発環境（IDE）：Pycharm CE

#手順
##環境を構築
PythonやPyCharmなどをローカルにインストールします。


##API関連の登録
###1. Twitter 
[Twitter Developerのページ](https://developer.twitter.com/)で登録またはログインして、今回作るBot用のAppを作成します。
そして、作成したAppの
CONSUMER_KEY
CONSUMER_SECRET
ACCESS_TOKEN
ACCESS_TOKEN_SECRET
の４つをメモしましょう。

詳しくは、ググってください。


###2. Last.fm
とりあえずAPI公式ページは[こちら](https://www.last.fm/api/)。
あまり複雑な構成ではないドキュメントだと思います（英語ですが）。

####APIアカウントを作成する
もしもLast.fmのアカウントを作っていない場合は、APIアカウントを作る前に登録しておきましょう。
普通のアカウントがあれば、[アカウント登録ページ](https://www.last.fm/api/account/create)でAPIアカウントの登録をします。
Callback URLは、今回は入力不要です。
Application homepageも、空欄でいいみたいです。

登録完了ページで出てくるアカウント情報は必ずメモしておきましょう。
API KEYは絶対に使います。
まあ、何かで失敗したら何度でも作り直せます。

####ドキュメントを読む
と言っても今回使うのは[user.getTopTracks](https://www.last.fm/api/show/user.getTopTracks)というメソッドのみ。
読まなくていいです。後述のコードをコピペしてください。
HTTP GETで、指定した直近の期間で聞いた曲が、再生回数の多い順に取得できます。
データはXML形式とJSON形式を選んで取得できますが、今回はJSONを選んでいます。

##コードを書く
**冒頭のimport直後の環境変数への代入は、各自の情報をHerokuの環境変数に登録して使ってください。**
また、デプロイ前にローカル環境でデバックを行い、実際に正しくツイートされることを確認してください。

```python:main.py
import os

import tweepy
import urllib.request
import json
import unicodedata
import datetime
from PIL import Image, ImageFont, ImageDraw
import random
import dropbox
import sys


from linebot import (
    LineBotApi, WebhookHandler
)
from linebot.exceptions import (
    InvalidSignatureError
)
from linebot.models import (
    MessageEvent, TextMessage, TextSendMessage, ImageSendMessage
)

YOUR_CHANNEL_ACCESS_TOKEN = os.environ['LineMessageAPIChannelAccessToken']
YOUR_CHANNEL_SECRET = os.environ['LineMessageAPIChannelSecret']
line_bot_api = LineBotApi(YOUR_CHANNEL_ACCESS_TOKEN)
handler = WebhookHandler(YOUR_CHANNEL_SECRET)

TWITTER_CONSUMER_KEY = os.environ['TWITTER_CONSUMER_KEY']
TWITTER_CONSUMER_SECRET = os.environ['TWITTER_CONSUMER_SECRET']
TWITTER_ACCESS_TOKEN = os.environ['TWITTER_ACCESS_TOKEN']
TWITTER_ACCESS_TOKEN_SECRET = os.environ['TWITTER_ACCESS_TOKEN_SECRET']

DROPBOX_TOKEN = os.environ['DROPBOX_TOKEN']

LASTFM_API_KEY = os.environ['LASTFM_API_KEY']

LINE_USER_ID = os.environ['LINE_USER_ID']

global period
global theme_color


class Period:
    SEVEN_DAYS = '7day'
    ONE_MONTH = '1month'
    TWELVE_MONTH = '12month'


FONT1 = 'fonts/azuki.ttf'             # http://azukifont.com/font/azuki.html
FONT2 = 'fonts/Ronde-B_square.otf'    # https://moji-waku.com/ronde/
FONT3 = 'fonts/851letrogo_007.ttf'    # http://pm85122.onamae.jp/851letrogopage.html
FONT4 = 'fonts/logotypejp_mp_b_1.1.ttf'   # https://logotype.jp/corporate-logo-font-dl.html#i-11
FONT5 = 'fonts/logotypejp_mp_m_1.1.ttf'   # https://logotype.jp/corporate-logo-font-dl.html#i-11


def main():
    data = get_last_fm_tracks()
    # ツイートする文字列
    tweet_str = initial_tweet_str()
    draw_ranking_img(data)

    twitter_api = initialize_twitter_api()
    twitter_api.update_with_media(filename='ranking.jpg', status=tweet_str)
    img_url1, img_url2 = upload_img_to_dropbox()
    line_send_message(tweet_str, img_url1, img_url2)


def initialize_twitter_api():
    auth = tweepy.OAuthHandler(TWITTER_CONSUMER_KEY, TWITTER_CONSUMER_SECRET)
    auth.set_access_token(TWITTER_ACCESS_TOKEN, TWITTER_ACCESS_TOKEN_SECRET)
    return tweepy.API(auth)


def get_last_fm_tracks():
    global period
    url = 'http://ws.audioscrobbler.com/2.0/'
    params = {
        'format': 'json',
        'api_key': LASTFM_API_KEY,
        'method': 'user.getTopTracks',
        'user': 'SoraraP',
        'period': period,
    }
    req = urllib.request.Request('{}?{}'.format(url, urllib.parse.urlencode(params)))
    with urllib.request.urlopen(req) as res:
        body = res.read()
        body = json.loads(body)
        return body


def initial_tweet_str():
    tweet = 'そららPが'
    if period == Period.SEVEN_DAYS:
        tweet += '今週'
    elif period == Period.ONE_MONTH:
        tweet += '先月'
    elif period == Period.TWELVE_MONTH:
        tweet += '今年'
    tweet += '聞いた曲ランキング\n'
    return tweet[:-1]


def draw_ranking_img(data):
    global period
    global theme_color
    theme_color = (random.randint(0, 255), random.randint(0, 255), random.randint(0, 255))
    img_size = (1080, 2160)
    img = Image.new('RGB', img_size, color=theme_color)
    draw = ImageDraw.Draw(img)
    
    # 画像見出し
    font_size = 70
    font = ImageFont.truetype(font=FONT4, size=font_size)
    position = (int(img_size[0] / 2 - draw.textsize(initial_tweet_str(), font)[0] / 2), 10)
    draw.text(xy=position, text=initial_tweet_str(), fill='white', font=font)
    
    draw_table(draw, img_size, data)
    
    # 日付
    font_size = 40
    font = ImageFont.truetype(font=FONT4, size=font_size)
    position = (img_size[0] - draw.textsize(str(today), font)[0] - 10, img_size[1] - draw.textsize(str(today), font)[1] -10)
    draw.text(xy=position, text=str(today), fill='white', font=font)
    
    img.save('ranking.jpg')
    img2 = img.resize((120, 240))
    img2.save('ranking_preview.jpg')


def draw_table(draw, size, data):
    global theme_color
    width, height = size
    num_songs = 10

    margin_top = 100
    margin_bottom = 50
    side_margin = 20
    
    left_top = (side_margin, margin_top)
    right_top = (width - side_margin, margin_top)
    left_bottom = (side_margin, height - margin_bottom)
    right_bottom = (width - side_margin, height - margin_bottom)
    
    # 四角
    draw.rectangle((left_top, right_bottom), fill='white', width=0)
    draw.line((left_top, left_bottom), fill=theme_color, width=5)
    draw.line((right_top, right_bottom), fill=theme_color, width=5)
    draw.line((left_top, right_top), fill=theme_color, width=5)
    draw.line((left_bottom, right_bottom), fill=theme_color, width=5)
    
    table_height = height - margin_top - margin_bottom
    
    # 横線
    xy = (left_top, right_top)
    for n in range(num_songs):
        xy = [list(xy[0]), list(xy[1])]
        xy[0][1] = xy[0][1] + int(table_height/11)
        xy[1][1] = xy[0][1]
        xy = (tuple(xy[0]), tuple(xy[1]))
        draw.line(xy, fill=theme_color, width=5)
    
    # 縦線
    rank_width = 100
    xy = (left_top[0] + rank_width, left_top[1], left_bottom[0] + rank_width, left_bottom[1])
    draw.line(xy, fill=theme_color, width=5)
    
    titles, artists, playcount = ['タイトル'], ['アーティスト'], ['再生回数']
    track_num = 0
    for track in data['toptracks']['track']:
        if track_num < num_songs:
            if int(track['playcount']) >= 1:
                titles.append(track['name'])
                artists.append(track['artist']['name'])
                playcount.append(track['playcount'])
                track_num += 1
    if track_num != num_songs:
        print('再生履歴が少なすぎます')
        sys.exit()
                
    # 順位
    rank_size = 80
    rank_xy = (left_top[0] + 10, left_top[1] + 10)
    for n in range(num_songs + 1):
        if n == 0:
            font = ImageFont.truetype(font=FONT1, size=rank_size)
            text = '順\n位'
            draw.text(xy=rank_xy, text=text, fill=0, font=font)
        else:
            text = str(n)
            if n < 10:
                rank_size = 100
                rank_xy = (left_top[0] + 25, left_top[1] + 10 + n*int(table_height/(num_songs+1)))
            else:
                rank_size = 85
                rank_xy = (left_top[0] + 5, left_top[1] + 10 + n*int(table_height/(num_songs+1)))
            font = ImageFont.truetype(font=FONT3, size=rank_size)
            draw.text(xy=rank_xy, text=text, fill='purple', font=font)

    # タイトル
    title_size = 75
    font = ImageFont.truetype(font=FONT4, size=title_size)
    title_xy = (left_top[0] + rank_width + 20, left_top[1] + 10)
    for n in range(num_songs + 1):
        draw.text(xy=title_xy, text=titles[n], fill=(255, 130, 39), font=font)
        title_xy = list(title_xy)
        title_xy[1] = title_xy[1] + int(table_height/(num_songs+1))
        title_xy = tuple(title_xy)
    
    # 再生回数
    playcount_xy = (left_top[0] + rank_width + 20, left_top[1] + 110)
    playcount_size = 60
    font = ImageFont.truetype(font=FONT5, size=playcount_size)
    for n in range(num_songs + 1):
        text = playcount[n]
        if n != 0:  # 凡例には「回」を付けない
            text += '回'
        draw.text(xy=playcount_xy, text=text, fill=0, font=font)
        playcount_xy = list(playcount_xy)
        playcount_xy[1] = playcount_xy[1] + int(table_height/(num_songs+1))
        playcount_xy = tuple(playcount_xy)
    
    # アーティスト
    for n in range(num_songs + 1):
        artist = '' + artists[n]
        artist_xy = (width - side_margin - draw.textsize(artist, font)[0] - 20,
                     left_top[1] + 110 + n * int(table_height/(num_songs+1)))
        artist_size = 65
        font = ImageFont.truetype(font=FONT5, size=artist_size)
        while draw.textsize(artist, font)[0] > width - 2*side_margin - rank_width - 200:
            artist = artist[:-2] + '…'
            artist_xy = (width - side_margin - draw.textsize(artist, font)[0] - 20,
                         left_top[1] + 110 + n * int(table_height / (num_songs + 1)))
        font = ImageFont.truetype(font=FONT5, size=artist_size)
        draw.text(xy=artist_xy, text=artist, fill='black', font=font)
        artist_xy = list(artist_xy)
        artist_xy[1] = artist_xy[1] + int(table_height/(num_songs+1))
        artist_xy = tuple(artist_xy)
    

def len_tweet(text):
    count = 0
    for c in text:
        if unicodedata.east_asian_width(c) in 'Na':
            count += 1
        else:
            count += 2
    return count


def upload_img_to_dropbox():
    dbx = dropbox.Dropbox(DROPBOX_TOKEN)
    # dbx.users_get_current_account()
    with open('ranking.jpg', "rb") as f:
        dbx.files_upload(f.read(), '/ranking.jpg', mode=dropbox.files.WriteMode.overwrite)
    with open('ranking_preview.jpg', "rb") as f:
        dbx.files_upload(f.read(), '/ranking_preview.jpg', mode=dropbox.files.WriteMode.overwrite)
    
    # ファイルのリンクを取得
    # setting = dropbox.sharing.SharedLinkSettings(requested_visibility=dropbox.sharing.RequestedVisibility.public)
    # link = dbx.sharing_create_shared_link_with_settings(path='/ranking.jpg', settings=setting)
    # links = dbx.sharing_list_shared_links(path='/ranking.jpg', direct_only=True).links
    # if links is not None:
    #     for link in links:
    #         img_url = link.url
    #         img_url = img_url.replace('www.dropbox', 'dl.dropboxusercontent').replace('?dl=0', '')
    #         print(img_url)
    #         return img_url

    # 上の方法だとlink取得時にshared_link_already_existsエラーが出る
    # ただしurlは毎回以下のようになる。
    return 'https://dl.dropboxusercontent.com/s/thcrs9h1x1031ti/ranking.jpg', \
           'https://dl.dropboxusercontent.com/s/thcrs9h1x1031ti/ranking_preview.jpg'


def line_send_message(text, img_url1, img_url2):
    user_id = LINE_USER_ID
    messages = [
        ImageSendMessage(
            original_content_url=img_url1,
            preview_image_url=img_url2
        ),
        TextSendMessage(text=text)
    ]
    line_bot_api.push_message(user_id, messages=messages)


if __name__ == "__main__":
    global period
    today = datetime.date.today()
    weekday = today.weekday()
    day = today.day
    month = today.month

    if weekday == 6:  # Sunday
        period = Period.SEVEN_DAYS
        main()
    if day == 1:
        period = Period.ONE_MONTH
        main()
    if month == 12 and day == 30:
        period = Period.TWELVE_MONTH
        main()
    print(today)
    print('process end.')
```
period変数は最初は引数で渡していこうとしましたが、なぜかif文の比較がうまくできなかったので、グローバル変数にしました。
改良案があれば、コメントもらえると嬉しいです。


##Herokuの前準備
###Herokuに登録
Herokuに登録します。
詳しくはググってください。
###Heroku CLIのインストール
こういうところがちょっと面倒と感じました。
[こちらの記事](https://qiita.com/seigo-pon/items/ca9951dac0b7fa29cce0#herokucli%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB)を参照してください。

##Herokuにデプロイ
[こちらの記事](https://qiita.com/1-row/items/80f89c8ada2e61f04446)を見ながら行いました。

```
# 関連モジュールの一覧を作成
pip freeze > requirements.txt
# ローカルにインストールしたモジュールがすべてが出力されてしまうので、不要なものは削除すること
```
ここ↑ですが、私の場合はrequirements.txtは下記↓の感じでOKでした。

```
jsonschema
tweepy
unicodecsv
urllib3
requests
requests-oauthlib
click
line-bot-sdk
pillow
dropbox
chardet
```

##Herokuでプログラムの定期実行を設定する
これも[こちらの記事](https://qiita.com/seigo-pon/items/ca9951dac0b7fa29cce0#%E5%AE%9A%E6%9C%9F%E5%AE%9F%E8%A1%8C%E8%A8%AD%E5%AE%9A)を参考にしました。Heroku Schedulerというアドオンを使うといいらしいです。
設定は、私の場合は全てブラウザ上でできました。
フィーリングでもいけると思いますが、適宜ググってください。

ちなみに、Heroku Schedulerでは「毎週」という項目がなかったため、「毎日」で設定します。（上のコードもそれが前提です）
また、時間設定は世界協定時刻のみ対応しているらしく、設定したい日本時間から９時間引いた値にします。
毎日午後９時にプログラムを実行したい場合には、下の画像のように設定しました。
<img width="1217" alt="Screen Shot 2019-10-12 at 3.26.24.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/489646/cb0d73dc-6177-5a51-ca43-122db848cde3.png">


##音楽を聞きまくる
たくさん音楽を聞いて、Last.fmでscrobbleしましょう。


##最後に
この記事の編集途中にページ遷移してしまって、戻ると内容がすごく遡った状態になってて青ざめたけど、下書き保存したらちゃんと回復してた。