ricono 作ったものと、詰まった箇所の記録

noteへの投稿をPlaywrightで自動化する(ヘッドレスが弾かれる話と、UIの罠7つ)

Playwrightnote業務自動化スクレイピング

毎朝1本、記事の下書きを自動で用意する仕組みを作りました。生成はAPIで済みますが、noteには投稿用の公開APIがありません。 ブラウザを動かすしかない。

Playwrightで書けば30分だろうと思っていました。実際には丸一日かかりました。公式ドキュメントにも、検索で出てくる記事にも載っていない罠が7つあったからです。

ここに全部書きます。同じことをやる人の時間を半日ぶん節約できるはずです。

前提として、自分のアカウントに、自分の記事を、自分の手で確認してから出すための自動化です。他人のコンテンツを収集したり、無断で大量投稿したりする用途ではありません。noteは広告メディアではないので、そこは踏み外さないほうがいい。


罠1:ヘッドレスだと、そもそも入れない

最初にぶつかって、最後まで効いていたのがこれです。

headless: true でログインを試みると、こう返ってきます。

しばらくたってからもう一度お試しください

パスワードは合っています。何度か試すとさらに固くなります。ボット判定です。

さらに厄介なのがエディタ側で、こちらは認証が通っていても壊れます。https://editor.note.com/new を開くと、

SPAが描画されません。「ログインできていないのでは」と疑って認証まわりを何度も見直しましたが、見当違いでした。

解決は1行です。

const browser = await chromium.launch({ headless: false });

画面ありにすると、ログインもエディタも素直に通ります。常駐マシンで動かすなら、誰も見ていない画面にウィンドウが開くだけなので実害はありません。

半日のうち、この切り分けに2時間使いました。ヘッドレス前提で詰まったら、まず画面ありで試す。 それだけで原因の層が一発で分かります。

罠2:ログイン判定が、ほぼ確実に誤検知する

よくある実装がこれです。

// ❌ 動かない
await page.goto("https://note.com/");
const loggedIn = await page.locator('button:has-text("投稿")').isVisible();
if (loggedIn) return;   // ← ここを必ず通ってしまう

noteのトップページは、未ログインでも「投稿」ボタンを表示します。 押すとログインを促される仕掛けです。

つまりこの判定は常にtrueを返し、ログイン処理に一度も入りません。そのままエディタへ進んで /login に飛ばされ、「タイトル欄が見つからない」で30秒タイムアウトする。エラーメッセージが本当の原因から一番遠いところに出ます。

正しい判定はリダイレクトを見ることです。

// ✅ 編集画面を開いて、/login に飛ばされるかで判定する
const EDITOR = "https://editor.note.com/notes/new";
await page.goto(EDITOR, { waitUntil: "domcontentloaded" });
if (page.url().includes("/login")) {
  // 未ログイン。ここでログイン処理へ
}

「ログインしているか」を直接聞かず、「やりたいことができるか」で判定する。 画面の見た目は嘘をつきますが、リダイレクトは嘘をつきません。

罠3:メールアドレスの入力欄が type="email" ではない

ログインフォームのセレクタです。

// ❌ 存在しない
await page.fill('input[type="email"]', email);

// ✅ これ
await page.fill('input[name="login"]', email);     // type は "text"
await page.fill('input[name="password"]', password);
await page.click('button:has-text("ログイン")');

id も付いていますが、_r_eho_ のようなReactの自動生成値で読み込むたびに変わります。使えません。name 属性で取るのが唯一安定します。

罠4:セッションは「人の手で1回だけ」作る

ログインを毎回走らせると、そのうち弾かれます。頻繁なログインが不審な挙動として扱われるためです。

一度だけ人がログインして、セッションを保存する。 以後は使い回してログインしない、という形にしました。

// 初回だけ:画面を見ながら人が手でログインする
const ctx = await browser.newContext();
// …ログイン完了を待ってから…
await ctx.storageState({ path: "state/note-session.json" });

// 2回目以降:保存したセッションで開く
const ctx = await browser.newContext({ storageState: "state/note-session.json" });

保存できたかの確認はファイルサイズで分かります。 失敗していると数百バイト(=中身が空)、成功していると数キロバイトになります。私は最初、549バイトの空ファイルを掴んだまま「セッションはあるのに通らない」と悩みました。

罠5:Markdownは一切解釈されない

note のエディタに Markdown を流し込んでも、記号がそのまま本文に出ます。

## 見出しのつもり    ← 「## 見出しのつもり」と表示される
**強調のつもり**     ← 記号ごと表示される

原因は2つ重なっています。

  1. page.keyboard.insertText() は実際のキーイベントを発生させません。エディタの入力ルール(「# と打つと見出しになる」類)が発火しない
  2. そもそも noteには ## を見出しに変換する入力ルールが無い

1だけなら keyboard.type() に変えれば解決しますが、2があるので打ち方を変えても直りません。

装飾記号を落としてから入れるのが現実解でした。

const stripMd = (s) => s
  .replace(/!\[[^\]]*\]\([^)]*\)/g, "")        // 画像
  .replace(/\[([^\]]+)\]\([^)]*\)/g, "$1")      // リンク → 文字だけ
  .replace(/\*\*(.+?)\*\*/g, "$1")              // 太字
  .replace(/`([^`]+)`/g, "$1")                  // コード
  .trim();

罠6:見出しをツールバーで付けると、本文が壊れる

「記号が駄目なら、ツールバーのボタンで見出しにすればいい」と考えました。実際、行を選択すると button[aria-label="見出し"] が現れます。

やってみると、本文が20段落から2段落に減りました。

ボタンを押した瞬間にエディタからフォーカスが外れ、以降の insertText がどこにも入らなくなります。見出しの見た目を取りにいって、本文の大半を失うという割に合わない結果でした。

完全性を優先して取り下げました。 見出し行は記号を落とした「ただの段落」として入れています。体裁は落ちますが、全文が確実に入るほうが大事です。

どうしても見出しにしたいなら、入力を全部終えてから最後にまとめて指定する順序にする必要があります(挿入中に触らない)。

罠7:公開しても、画面では公開済みか分からない

最後の仕上げでこれです。

公開ボタンを押したあと、page.url() を記事URLだと思って記録していました。実際に返ってきたのは、

https://note.com/like_reaction_setting?kind=recommend

noteは公開後にリアクション設定の画面へ遷移します。 記事URLはどこにも残りませんでした。

さらに、公開済みの記事を編集画面で開いても「公開に進む」ボタンが残ったままです。見た目では下書きと区別がつきません。

判定もURL取得も、APIで取るのが唯一確実でした。

// note.com 上で実行する(オリジンを合わせる必要がある)
const info = await page.evaluate(async (id) => {
  const res = await fetch(`/api/v3/notes/${id}`, { credentials: "include" });
  const d = (await res.json()).data || {};
  return { status: d.status, url: d.note_url, publishedAt: d.publish_at };
}, noteId);

if (info.status !== "published") throw new Error("公開できていません");

status が published かどうかで確実に判定でき、記事URLもここで取れます。


結局どうなったか

毎朝、下書きが1本できてSlackに通知が飛びます。中身を読んで「出していい」と判断したときだけ公開する。生成から公開まで全自動にはしていません。

公開は取り消せないからです。素材に出せない情報が混ざっていないかは、最後は人が見るしかない。自動化するのは公開の手前まで、と決めています。

ここは好みではなく設計だと思っています。取り返しのつく工程だけ自動化して、取り返しのつかない1点に人を残す。

まとめ:どこから疑うか

同じことをやるなら、この順番で潰すのが早いです。

  1. ヘッドレスをやめて画面ありにする(罠1)— 原因の層が切り分けられる
  2. ログイン判定をリダイレクトで書き直す(罠2)— 見た目で判定しない
  3. セレクタは name 属性で取る(罠3)— 自動生成の id は使わない
  4. 公開の成否はAPIで確認する(罠7)— 画面は信用しない

このうち1と2で、詰まりの大半は解けるはずです。

使っているもの

← 記事一覧