3
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Playwrightでtime.sleepを使ったら、ログインの完了に気づけなかった話(Hevyの記録を自動で取り込む)

3
Posted at

この記事でわかること

  • Playwright の launch_persistent_context で、パスワードを保存せずに、2回目から自動でログインした状態にする方法
  • 同期版の Playwright で time.sleep() を使うと page.url が古いままになる落とし穴と、wait_for_url() での直し方
  • 筋トレアプリ Hevy の記録を、自作の PC アプリを開くだけで取り込めるようにした流れ

「ログインしたのに、page.url がログイン画面のまま変わらない」という症状で困っている人に、特に読んでほしいです。

はじめに

筋トレの記録は、スマホアプリの Hevy(無料版)でつけています。
体重や成長のグラフは、自分で作った PC アプリ(Python + PySide6 + SQLite)で見ています。

困っていたのは、この2つをつなぐ作業です。

  1. スマホの Hevy で CSV をエクスポートする
  2. PC に送る
  3. PC でダウンロードする
  4. 自作アプリを開いて、CSV をインポートする

毎回これが面倒でした。

そこで、自作アプリを開くだけで、Hevy の Web 版から CSV を自動でダウンロードして取り込むようにしました。

Hevy には、有料版(Hevy Pro)向けの公式 API があります。Pro を使っているなら、画面を自動で操作するより API を使うのが正攻法です。
自分は無料版なので、Web 版にある「エクスポート」ボタンを自動で押す方法にしました。

作り方の分担

コードは Claude Code(AI のコーディングツール)に書いてもらいました。自分はコードの中身がまだよく分からないので、こんな進め方でした。

  • 決めたこと:Web サイトにパスワードでログインしようとしたら、自分はパスワードで登録しておらず、Google アカウントでログインしていたことが分かりました。そこで、初回だけ自分で Google ログインをする方式にしました。自動のアクセスは1日1回までにしました。
  • 動かして確かめたこと:「ログインしたのに保存できていない」状態になりました。保存先のフォルダを自分で見に行って、CSV が無いことを確かめました。
  • 原因:そのときは、コードの中身が読めなかったので、なぜ保存できないのか分かりませんでした。AI に調べてもらって time.sleep が原因だと分かり、あとから AI にクイズを出してもらって、理解を確かめました(この記事の「ハマったところ」の部分です)。

動作環境

もの バージョン
OS Windows 11
Python 3.11
Playwright(Python 版・同期 API) 1.60.0
PySide6 6.9.2
ブラウザ Google Chrome(channel="chrome" で使用)

作ったもの

アプリ起動
  └─ 3秒後: 今日まだ同期が成功していなければ(画面が固まらないよう、別スレッド=QThread で動かす)
       ├─ ① 画面を出さずに Hevy を開く(ログイン済みならそのままダウンロード)
       └─ ② ログインしていなければ、画面を出して自分でログインする(初回だけ)
            └─ CSV をダウンロード → SQLite に取り込み
  • 自動の同期は、成功した日はもうしません(1日1回まで)。成功した日付を JSON ファイルに書いておき、失敗したときは書かないので、次に起動したときにやり直します(失敗が続くと、起動のたびにアクセスします)。
  • メニューの「今すぐ同期」を押したときだけは、この制限に関係なく同期します(手動のとき)。
  • 取り込むとき、データベースにすでに記録がある日は、その日を丸ごとスキップします。同じ記録が二重に入らないようにするためです。
    • そのため、その日に同期したあとで、もう一度トレーニングを記録した場合、その分は自動では入りません(1日1回の設計にしたためです)。

ログインの扱い:パスワードは保存しない

最初は「パスワードを保存して、毎回自動でログイン」にするつもりでした。
でも、自分は Hevy に Google アカウントでログインしていたので、パスワードを入力する方式は使えません。

そこで、Playwright の launch_persistent_context を使いました。

launch_persistent_context って何?

普段の Chrome は、一度ログインすれば、次に開いてもログインしたままです。ログイン情報(Cookie)を、パソコンのフォルダに保存しているからです。

起動方法 たとえ ログイン状態
launch 毎回、真っさらなブラウザを出す 標準では、閉じると消える(context.storage_state() で保存し、new_context(storage_state=...) で引き継ぐこともできる)
launch_persistent_context いつものブラウザを出す 指定したフォルダに保存されて、次も残る

persistent は「持続する・残る」という意味です。初回にそのフォルダで自分がログインすれば、2回目からは「前にログインした人」としてブラウザが始まります。

from pathlib import Path
from playwright.sync_api import sync_playwright

# "data/..." のような相対パスだと、実行する場所(カレントディレクトリ)が変わると別の場所に作られてしまう。
# そこで、このファイルの場所を基準にしている。
# 自分のアプリでは、このファイルは utils フォルダの中にあるので、.parent.parent で2つ上(アプリのフォルダ)にしている。
# 1つのファイルで試すなら、.parent(このファイルと同じフォルダ)で十分。
APP_DIR = Path(__file__).resolve().parent.parent
PROFILE_DIR = APP_DIR / "data" / "hevy_browser_profile"  # ログイン状態を保存する、このアプリ専用のフォルダ
EXPORT_DIR = APP_DIR / "data" / "hevy_exports"          # ダウンロードした CSV の保存先

def open_browser(p, first_time: bool):
    # Cookie などをフォルダに保存しながら動く「いつものブラウザ」のような起動方法
    return p.chromium.launch_persistent_context(
        user_data_dir=str(PROFILE_DIR),
        channel="chrome",        # PC に入っている Google Chrome を使う
        headless=not first_time, # 初回は画面を出して自分でログイン。2回目からは画面を出さない
        accept_downloads=True,   # ダウンロードを受け取る(既定でも True。分かりやすくするために書いている)
    )

with sync_playwright() as p:
    # ここでは説明のために「初回」を想定して True にしている。
    # 実際のアプリでは、まず画面なし(first_time=False)で開き、
    # ログイン画面に転送されたときだけ、画面ありで開き直している
    context = open_browser(p, first_time=True)
    # persistent context は、起動した時点でタブが1つ開いていることが多い。あればそれを使い、無ければ作る
    page = context.pages[0] if context.pages else context.new_page()
    page.goto("https://hevy.com/settings?export")

このフォルダは「ログイン済みの鍵」と同じです。
Google でログインした場合は、Hevy だけでなく Google アカウントのログイン状態も入ります。

  • .gitignore に入れて、Git にコミットしない・人に渡さない(.gitignore は、一度 git add したファイルには効きません。入れてしまったら git rm --cached で Git の管理から外します。履歴には残るので、push してしまったら、下のログアウトもしてください)
  • OneDrive などのクラウド同期の対象になっているフォルダに置かない
  • 共有の PC では使わない
  • このブラウザで Google にログインするときは、サイトへのログインだけにする(Chrome 自体の同期はオンにしない。オンにすると、パスワードやブックマークもこのフォルダに入る)
  • 使わなくなったらフォルダごと消し、Google アカウントの「デバイス」の一覧からもログアウトする(普段の Chrome と同じような名前で出ることがあるので、ログインした日時も見る)
  • user_data_dir に、普段使っている Chrome のプロファイルを指定しない(専用のフォルダを作る)。Playwright の公式ドキュメントにも、普段の Chrome のプロファイルの自動操作はサポートされていない、と書かれています

なお、自動で操作しているブラウザだと、Google のログインで「安全でないブラウザ」と表示され、ログインできないことがあります。Playwright に付いてくるブラウザだと起きやすいと言われているので、自分は channel="chrome" で PC の Chrome を使っています(それでも起きないとは限りません)。

ログインしているかどうかの見分け方

Hevy は、ログインしていないままエクスポート画面を開くと、ログイン画面に転送されます(自分の環境で確認した動きです)。
なので、URL を見て判断しています。

from urllib.parse import urlparse

def is_login_page(url: str) -> bool:
    """ログインしていないと /login に転送される"""
    return "/login" in url or "/signup" in url

def is_hevy_page(url: str) -> bool:
    """URL のホスト名(https://〇〇/ の〇〇)が hevy.com かどうか"""
    host = urlparse(url).hostname or ""
    return host == "hevy.com" or host.endswith(".hevy.com")

is_hevy_page() がなぜ必要なのかは、あとの「ハマったところ」で説明します。

ハマったところ:ログインしたのに、ずっと待ち続ける

初回、画面に出たブラウザで Google ログインを済ませました。
なのに、プログラムはいつまでも「ログインを待っています」のままで、5分後にタイムアウトしました。タイムアウトしたので、CSV はダウンロードされず、保存先のフォルダは空のままでした。

最初のコードはこうでした(抜粋)。

# ダメだった例
import time

deadline = time.time() + 300  # 最大5分待つ
while time.time() < deadline:
    if "hevy.com" in page.url and not is_login_page(page.url):
        break  # ログイン完了
    time.sleep(1)  # 1秒待つ

原因:time.sleep() の間、Playwright は何も処理できない

Playwright の公式ドキュメントにも、time.sleep() を使うと状態が古くなる、と書かれています(Known issues)。

公式に書かれているのは、ここまでです。ここから先は、Playwright(1.60.0)のソースコードを読んで分かったことです。

  • ブラウザからは「ページが移動した」などの知らせが届いています。
  • でも同期版の Playwright は、Playwright の関数(待つ関数も含む)を呼んでいる間にしか、その知らせを処理しません。
  • time.sleep() は Python が止まるだけなので、知らせは処理されずに溜まったままになります。
  • page.url は、ブラウザに毎回問い合わせるのではなく、知らせで更新される手元の値を返すだけです。

その結果、ログインが終わってページが移動しても page.url は古いまま(ログイン画面のまま)で、ずっと待ち続けていました。

直し方①:page.wait_for_timeout() で待つ

まず、time.sleep() を Playwright の待ち方に変えました。待っている間も知らせが処理されるので、これで動くようになりました。

 while time.time() < deadline:
     if "hevy.com" in page.url and not is_login_page(page.url):
         break  # ログイン完了
-    time.sleep(1)  # 1秒待つ
+    page.wait_for_timeout(1000)  # 待っている間も、ブラウザからの知らせが処理される

直し方②(おすすめ):page.wait_for_url() で「条件」を待つ

ただ、公式ドキュメントでは wait_for_timeout() はデバッグ用とされていて、本番では「決まった時間だけ待つ」より「条件がそろうまで待つ」方がよい、とされています。

そこで、ループをやめて wait_for_url() にしました。URL がこの条件に合うまで待ってくれます。

from playwright.sync_api import TimeoutError as PlaywrightTimeoutError

try:
    # 「Hevy のページで、ログイン画面ではない」URL になるまで、最大5分待つ
    page.wait_for_url(
        lambda url: is_hevy_page(url) and not is_login_page(url),
        timeout=5 * 60 * 1000,  # ミリ秒で指定する
    )
except PlaywrightTimeoutError:
    raise RuntimeError("5分以内にログインが完了しませんでした")

url には、文字列や正規表現のほか、URL を受け取って True / False を返す関数も渡せます。timeout はミリ秒です。どちらも公式ドキュメントで確認しました(Page.wait_for_url)。

なぜ「Hevy の画面かどうか」も確かめるのか

Google でログインすると、ブラウザの URL は次のように変わっていきます。

① Hevy のログイン画面   hevy.com/login               ← /login が入っている → 待つ
② Google の入力画面     accounts.google.com/...      ← /login が入っていない(※)
③ ログイン完了          hevy.com/settings?export     ← Hevy に戻ってきた → 完了

条件が「ログイン画面ではない(/login が入っていない)」だけだと、②の Google の画面も当てはまってしまい、Google のパスワード入力の途中なのに「ログイン完了」と判断します。そのまま先に進んで、エクスポートボタンを探しに行って失敗します。

そこで、「Hevy の画面で、かつログイン画面ではない」という条件にしています。

"hevy.com" in url では足りなかった

最初のコード(ダメだった例・直し方①)では、Hevy の画面かどうかを "hevy.com" in url で見ていました。これは URL 全体から文字を探すだけです。

Google のログイン画面の URL には、「ログインが終わったらどこに戻るか」が入っていることがあります(例: accounts.google.com/signin?continue=https://hevy.com/...)。こうなると、②でも "hevy.com" in url が当てはまってしまいます。

そこで、wait_for_url() に直すときに、URL のホスト名(https://〇〇/ の〇〇)だけを見る is_hevy_page() に変えました。ネットにつながずに偽の①②③の画面を用意して試したところ、古い条件は②で「完了」と誤判定し、新しい条件は③まで待ちました。

なお、URL が Hevy に戻ったことは「ログインできた」ことの確認にはなりますが、エクスポートできる状態かまでは分かりません。そのため、このあとボタンが見つからなければ、画面を保存して失敗にしています(次の章)。

同期版の Playwright では time.sleep() を使わない。できれば wait_for_url() などで条件を待つ。これが今回の一番の学びです。

ボタンを押してダウンロードする

エクスポートボタンは、画面の文字で探しています。画面の言語が変わっても動くように、日本語と英語の両方の候補を用意しました(抜粋。実際は候補が4つあり、ボタンを押したあとに別の画面が出たときのために、最大3回まで押し直しています)。

import re
from datetime import datetime

# 上にあるものほど優先して探す
EXPORT_BUTTON_PATTERNS = [
    re.compile(r"トレーニングデータ.*エクスポート"),
    re.compile(r"export\s*workouts?", re.I),
    re.compile(r"エクスポート|export", re.I),
]

# 保存するファイル名に日時を入れる(例: hevy_20261119_210000.csv)
save_path = EXPORT_DIR / f"hevy_{datetime.now():%Y%m%d_%H%M%S}.csv"

for pattern in EXPORT_BUTTON_PATTERNS:
    button = page.get_by_role("button", name=pattern)  # name には正規表現も渡せる
    if button.count() == 0:
        continue
    # このブロックの中でダウンロードが始まるのを待つ(20_000 は 20000 ミリ秒 = 20秒。_ は読みやすくする区切り)
    with page.expect_download(timeout=20_000) as download_info:
        button.first.click()
    download_info.value.save_as(save_path)
    break
else:
    # どのボタンも見つからなかったとき:原因を調べるために画面を保存する
    page.screenshot(path=EXPORT_DIR / "last_error.png", full_page=True)
    raise RuntimeError("エクスポートボタンが見つかりませんでした")

button.count() は待たずに、その瞬間のボタンの数を返します。画面の表示が遅いと、ボタンがあるのに0と数えてしまいます。自分のアプリでは、エクスポート画面を開いたあと、通信が落ち着くまで(最大15秒)待ってから探しています。

エラー時のスクリーンショットには、メールアドレスや表示名が写ることがあります。ダウンロードした CSV も、自分の健康に関わるデータです。
どちらも .gitignore に入れて、質問するときなどに画像をそのまま貼らないようにしています。

もう1つの落とし穴:CSV の種目名が英語のことがある

自分の環境では、スマホ版の CSV は種目名が日本語でした。でも、Web 版の CSV は英語(Bench Press (Dumbbell) など)でした(言語の設定によって違うかもしれません)。
そのまま取り込むと、知らない種目として「その他」に入ってしまいます。

そこで、英語名を日本語名に直す対応表を作りました。表に無い種目は、英語のキーワードから部位を推測しています(抜粋。名前は簡単にしています。実際は日本語のキーワードも入っていて、推測の前に「データベースに同じ名前の種目があれば、その部位を使う」という段階もあります)。

# 英語名(小文字にしたもの) → (アプリの種目名, 器具, 部位)
EXERCISE_MAP = {
    "bench press (dumbbell)": ("ベンチプレス", "ダンベル", "胸"),
    "chest fly (dumbbell)":   ("ダンベルフライ", "ダンベル", "胸"),
    "lat pulldown (machine)": ("ラットプルダウン", "マシン", "背中"),
}

# 対応表に無いときは、キーワードで部位を推測する(上から順に調べる)
KEYWORD_TO_PART = [("bench", "胸"), ("fly", "胸"), ("row", "背中"), ("pulldown", "背中"), ("squat", "脚")]

def guess_part(name: str) -> str:
    lower = name.lower()
    for keyword, part in KEYWORD_TO_PART:
        if keyword in lower:
            return part
    return "その他"

やってみて

  • 手作業(スマホでエクスポート → PC に送る → PC でダウンロード → 自作アプリで取り込む)がなくなり、アプリを開くだけになりました。自分の操作が減ったのが、一番良かったことです。
  • time.sleep() のハマりは、自分ではコードが読めず、原因が分かりませんでした。「そういう原因もあるんだな」と、AI に教えてもらいながら学べました。
  • AI に書いてもらうと、誰でも開発できるのだなと思いました。自分だけで使うもので、流出してもあまり困らないデータなら、気楽に作れます。ただし、ログイン状態を保存したフォルダは、流出すると困る(Google の分も入っている)ので、ここだけは気をつけています。

注意

  • Hevy の利用規約(2026年11月19日に確認。2019年6月23日付の版)には、自動操作を名指しで禁止する条文はありませんでした。ただし、許可されているわけでもありません。また、規約には「許可されていない使い方、またはその疑いがある使い方」があれば、アカウントを止めることがある、とも書かれています。この記事は、自分のデータを、公式のエクスポート機能で、自動では1日1回だけ取る目的で作っています。公式の API が使える場合は、そちらを使ってください。
  • Hevy の画面やボタンの名前は、2026年11月時点のものです。変わると動かなくなることがあります。

参考

3
0
1

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
3
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?