メインコンテンツへスキップ
見出し画像

Playwright永続化でnote投稿を完全自動化した話

    「毎日、決まった時間にnoteを更新する」

    この単純な作業が、クリエイターやエンジニアにとってどれほど大きな心理的負荷になるか。執筆自体は楽しくても、管理画面にログインし、画像をアップロードし、ハッシュタグを設定して投稿ボタンを押すという「ルーチン」は、創造性を削り取る単純作業でしかない。


    特に、セキュリティが強固なnote.comにおいて、従来のスクレイピング手法は通用しない。ログインのたびに求められる2要素認証(2FA)や、頻繁に変わるセレクタ(要素の指定)が、多くの自動化チャレンジャーを挫折させてきた。


    しかし、Playwrightの「永続化(Persistence)」とClaude Codeという強力な武器を組み合わせることで、この壁は完全に突破できる。本記事では、私が実際に構築し、現在も安定稼働している「note完全自動投稿システム」の全貌を公開する。


    なぜ従来の自動化は失敗するのか


    多くの人が「Puppeteer」や「Selenium」で自動化を試み、そして失敗する。その最大の理由は「セッションの維持」ができないことにある。


    通常のブラウザ自動化ツールは、実行のたびに「クリーンなブラウザ」を立ち上げる。そのため、毎回ログイン処理が必要になり、note側のbot検知システムに引っかかるか、2要素認証で足止めを食らう。


    解決策は唯一無二だ。「一度人間がログインしたブラウザの状態(Cookieやローカルストレージ)を、そのままファイルとして保存し、プログラムから再利用する」ことである。これがPlaywrightの「永続化コンテキスト」だ。


    Playwright永続化のコア・コンセプト


    Playwrightには、launch_persistent_contextというメソッドが存在する。これは、指定したディレクトリにブラウザのプロファイル(ユーザーデータ)を保存・読み込みするものだ。


    これを利用すれば、以下のワークフローが実現する。


    1. 初回実行時のみ、プログラムが立ち上げたブラウザで人間がログインする。

    2. ログイン状態が指定したフォルダ(user_data等)に保存される。

    3. 2回目以降は、そのフォルダを読み込むだけで「ログイン済み」の状態で操作を開始できる。


    実装:Claude Codeでスクリプトを生成する


    ここからは具体的な実装に入る。私はエンジニアとして、このスクリプトの土台をClaude Code(AnthropicのCLIツール)に生成させた。Claude Codeは、ローカルのファイル構成を理解した上で、極めて精度の高いPlaywrightスクリプトを書き出す。


    以下に、私が使用しているPython版のコアコードを示す(TypeScriptでも同様のロジックで構築可能だ)。


    import os
    from playwright.sync_api import sync_playwright
    
    # ユーザーデータを保存するディレクトリ
    USER_DATA_DIR = os.path.join(os.getcwd(), "note_session")
    
    def post_to_note(title, content, image_path=None):
        with sync_playwright() as p:
            # 永続化コンテキストを使用してブラウザを起動
            context = p.chromium.launch_persistent_context(
                user_data_dir=USER_DATA_DIR,
                headless=False,  # 初回やデバッグ時はFalseにして挙動を確認
                args=["--start-maximized"]
            )
            
            page = context.new_page()
            
            # noteの投稿画面へ直接遷移
            page.goto("https://note.com/notes/new")
            
            # ログインが必要な場合は、ここで一時停止して人間にログインさせる
            if "login" in page.url:
                print("ログインが必要です。ブラウザでログインを完了させてください。")
                page.wait_for_url("https://note.com/notes/new", timeout=0)
            
            # タイトルの入力
            page.fill('textarea[placeholder="記事タイトル"]', title)
            
            # 本文の入力
            # noteのエディタは特殊なため、キーボードシミュレーションが確実
            page.click('.note-editor-container')
            page.keyboard.type(content)
            
            # 投稿設定へ
            page.click('button:has-text("公開設定")')
            page.wait_for_selector('button:has-text("投稿する")')
            
            # 最終的な投稿ボタン(ここを自動化すれば完了)
            # page.click('button:has-text("投稿する")')
            
            print(f"記事「{title}」の投稿準備が完了しました。")
            context.close()


    note特有の難所を突破する3つのテクニック


    コードを書くだけでは不十分だ。noteのUIは非常にモダンであり、React等のフレームワークで構築されているため、単純なfillコマンドでは文字が正しく認識されないケースがある。


    1. キーボードシミュレーションの活用

    noteのエディタは、テキストエリアに見えて実はそうではない。そのため、要素に対して直接値を流し込むのではなく、page.keyboard.type()を使用して、人間がタイピングしているようにエミュレートするのが最も確実だ。


    2. セレクタの「曖昧さ」を排除する

    noteのHTMLクラス名は頻繁に変更される可能性がある。そのため、class=".note-abc-123"のような指定は避け、button:has-text("公開設定")のように、ユーザーの目に触れる「テキスト内容」を基準に要素を特定すべきだ。これにより、サイト改修によるスクリプト崩壊を防ぐことができる。


    3. スリープ(待機)の戦略的配置

    APIではない自動化において、page.wait_for_load_state("networkidle")(ネットワーク通信が止まるまで待つ)だけでは不十分だ。画像のアップロードやプレビュー生成には時間がかかる。要所要所でpage.wait_for_timeout(2000)のような明示的な待機を入れることが、エラー率を0%にする秘訣である。


    Claude Codeによる運用管理


    このシステムを構築した後、私は日々の運用をClaude Codeに任せている。ターミナルから以下のようなコマンドを打つだけだ。


    > 「昨日書いたmarkdownファイルを読み込んで、タイトルを『AI自動化の未来』にしてnoteに投稿するスクリプトを実行して。ログインセッションは既存のものを使って」


    Claude Codeは、私のディレクトリにあるnote_auto_post.pyを呼び出し、引数を適切に設定して実行してくれる。コードを一行も書かずに、自然言語で投稿指示が出せる。これが「次世代の自動化」だ。


    導入後の数字:90時間の節約


    このシステムを導入した結果、私のワークフローは劇的に変化した。


    • 作業時間: 1記事あたり15分(手動) → 0分(全自動)

    • 投稿頻度: 週2回 → 毎日(予約投稿機能を自作プログラム側で実装)

    • 精神的負荷: 「投稿しなきゃ」という強迫観念からの解放


    年間で見れば、約90時間以上の時間をクリエイティブな執筆や学習に充てられるようになった計算だ。


    まとめ:自動化は「怠慢」ではなく「投資」である


    Playwrightの永続化コンテキストとClaude Codeの組み合わせは、これまで「技術的に不可能」「運用が面倒」とされてきたブラウザ操作の壁を完全に取り払った。


    設定に苦戦している初中級者の方は、まずは「永続化ディレクトリ」を正しく作成し、自分のブラウザプロファイルを固定することから始めてほしい。一度セッションが安定すれば、そこから先は無限の自動化が待っている。


    この記事が、あなたのAI自動化ライフを加速させる一助になれば幸いである。



    いいね・フォローで、Claude CodeやPlaywrightを活用した最新のAI自動化情報を受け取れます。実践的なTipsを随時発信中です。




    📚 関連記事


    • [dev-browser完全解説 — AIに本物のブラウザ操作をさせる新手法](https://note.com/nice_flax6883/n/nc46f9dce4d9c?app_launch=false)

    • [ClawRouter解説 — Claude自動化コスト月$75→$3.17の仕組み](https://note.com/nice_flax6883/n/nad2162281a99?app_launch=false)

    • [Typefully × AI運用術 — バズるパターンを自動再現する4機能](https://note.com/nice_flax6883/n/n7c88b8fb1e21?app_launch=false)

    • [X完全自動化の設計図 — 1日6投稿を人間ゼロで回す全手順](https://note.com/nice_flax6883/n/ndb94fb947fcd?app_launch=false)

    • [launchd × Python × Claude Codeで毎日の作業を完全自動化する](https://note.com/nice_flax6883/n/n12dbcd3b3c71?app_launch=false)


    ▶ すべての記事はこちら: https://note.com/nice_flax6883


    💡 いいね・フォローで最新のAI自動化テクニックを見逃さずチェックできます!


     
     

    鬼徹

     
     
    青森の建設現場で働くおっさんが、AIエージェントと仕事と副業を回す実録。技能実習生の教育、機械の修理、見張りと検収の型づくり。有料noteで実務テンプレートも販売中。X: @raindog_kitetu

    あなたへのおすすめ