この記事でわかること
- Playwright の
launch_persistent_contextで、パスワードを保存せずに、2回目から自動でログインした状態にする方法 - 同期版の Playwright で
time.sleep()を使うとpage.urlが古いままになる落とし穴と、wait_for_url()での直し方 - 筋トレアプリ Hevy の記録を、自作の PC アプリを開くだけで取り込めるようにした流れ
「ログインしたのに、page.url がログイン画面のまま変わらない」という症状で困っている人に、特に読んでほしいです。
はじめに
筋トレの記録は、スマホアプリの Hevy(無料版)でつけています。
体重や成長のグラフは、自分で作った PC アプリ(Python + PySide6 + SQLite)で見ています。
困っていたのは、この2つをつなぐ作業です。
- スマホの Hevy で CSV をエクスポートする
- PC に送る
- PC でダウンロードする
- 自作アプリを開いて、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月時点のものです。変わると動かなくなることがあります。