
note 投稿を自動化したら CAPTCHA に殴られた話
前回はこちら(シリーズ「早速自動化しました」の続きです)。
前回、ブログ制作を12個のスキルに割った話をしました。今回はその中の1つ、いちばん地味で泥臭い「投稿」工程の裏側です。
先に言っておくと、note には投稿 API がありません。じゃあブラウザを操作すればいい、と思って手を動かしたら、いきなり CAPTCHA に殴られました。
この記事で書くのは、「なぜブラウザ自動操作なのか」と「自動化のリアルなハマりどころ」。キレイに動く話ではなく、殴られながら道を作った記録です。
結論:API が無いなら、ブラウザごと動かす
結論から言います。note に投稿する道具が欲しいなら、ブラウザごと動かすのが早い。
理由はシンプルで、note には外部から記事を送り込む API が無いからです。データを渡す窓口が無いなら、人間がやることをそのまま機械にやらせるしかない。エディタを開いて、本文を貼って、下書きを保存する。この一連を Playwright(ブラウザを自動操作する道具)に肩代わりさせました。
やることは一つ。手元の Markdown ファイルを読んで、note の下書きを自動で作る。それだけです。
道具立ては最小限にしました。Bun で書いて、ビルドなしで即実行。TypeScript と Playwright、あとで触れる 1Password CLI。派手さはありません。「動けばいい、けど秘密は漏らさない」を満たす、いちばん短い構成を選びました。
ただ、「自動化した」の一言の裏は、泥臭いハマりの連続でした。ここからが本題です。
ハマり①:note は Markdown を食べてくれない
最初の壁。note のエディタは Markdown を解釈しません。
## 見出し と書いたテキストをそのまま貼っても、## 見出し という文字列が並ぶだけ。見出しにも太字にもなりません。僕らが書いているのは Markdown なのに、note はそれを知らない。
回避策は、相手の土俵に合わせることでした。Markdown を一度 HTML に変換してから、エディタに貼り付ける。すると note 側のパーサが「これは見出し」「これは箇条書き」と解釈してくれる。見出し(h2 / h3)、段落、箇条書き、区切り線、太字。このあたりを HTML にしてから流し込むと、ちゃんとした記事の見た目になります。
面白いのは、note の癖を逆に味方につけられること。URL を単独の行に置くと、note はそれをリンクカードに勝手に変換します。 この記事の先頭にある前回リンクも、その仕組みで出しています。相手の作法を知ると、押し付けるのではなく乗っかれる。
学びはここです。自動化で相手のあるサービスを触るときは、こちらの都合を押し付けない。相手がどう解釈するかに、こちらが合わせる。
ハマり②:CAPTCHA と headless の二重の壁
次の壁は、二段構えで殴ってきました。
一発目が CAPTCHA。初回ログインで「あなたは機械ですか」と問う、あの画像認証です。機械で突破しようとすると、当然、弾かれる。自動化の天敵です。
ここで無理に突破しようとしないのが、僕の割り切りでした。初回だけ、可視ブラウザ(画面が見える状態)を立ち上げて、人間が自分で CAPTCHA を解く。 解いてログインが通ったら、そのログイン状態(セッション)をファイルに保存しておく。次からはその状態を読み込むので、CAPTCHA はもう出ません。1回だけ手で通せば、あとは自動です。
二発目が headless 問題。ブラウザ自動操作は普通、画面を出さない「headless」で速く回します。ところが note のエディタは、headless だとうまく描画されなかった。仕方ないので、常に画面が見えるブラウザで動かすことにしました。速さは少し捨てて、確実に動く方を取った。
学びは、全部を機械に任せないこと。人間が1回だけ介在すべき点を見極めて、そこだけ手で通す。無理に全自動を目指すより、この線引きの方がずっと現実的でした。
ハマり③:秘密を残さない・壊さない設計
最後は、ハマりというより「先に決めておいた設計」です。自動化は油断すると、事故ります。
まず秘密の扱い。note のログイン情報を、コードやファイルに直書きするのは論外です。だから認証情報は 1Password CLI から実行時に取り出す。パスワードはどこにも保存せず、実行の瞬間だけ 1Password から借りてくる。コードにもファイルにも、秘密は一切残りません。
次に安全弁。自動化がこわいのは、勝手に危険なことを実行するからです。だから既定は「下書き保存まで」で止める。公開まで一気に進めるのは、明示的にオプションを付けたときだけ。うっかり全世界に公開、を仕組みで防ぎます。
そして失敗したときのために、エラーが出たらその瞬間の画面をスクショに残す。何が起きたか後から追える。自動化は見ていないところで動くからこそ、転んだ跡を残しておく。
学びは、止まりどころを先に設計すること。自動化は「進める」設計より、「安全に止める」設計の方が効きます。
まとめ:自動化は、全自動という意味じゃない
3行でまとめます。
note に API が無いなら、ブラウザごと動かせばいい
CAPTCHA は「1回だけ人間が解く+セッション保存」で回避できる
秘密は 1Password、公開は慎重に、失敗はスクショで追える
今日いちばん持ち帰ってほしいのは、これです。「自動化」は「全自動」という意味じゃない。 人間が1回だけ介在すべき点を見極めて、そこ以外を仕組みに乗せる。全部を機械に押し付けようとした瞬間、CAPTCHA に殴られる。線を引くのが、いちばんの近道でした。
今回は「なぜ・どう回避したか」まで。note のどこを掴むか、Markdown をどう HTML に変換するかといった動くコード一式は、そのまま再現できる形でいずれ別途まとめるつもりです。
次回は header編。記事のアイキャッチ画像を、Gemini で毎回同じ作風に生成する話です。これも「手でやると毎回ブレる」を仕組みで消した回になります。
繰り返しを仕組みで消すのが好きな人。更新はフォローで受け取ってもらえると、続きが届きます。
最後まで読んでくれて、ありがとうございました。
正直なところ、応援してもらえるほど頑張れます。
「面白かった」「役に立った」と思ってもらえたら、スキで教えてください。フォローしてもらえると更新が届くし、それが次を書く一番の力になります。
いまの目標は、まずはフォロワー100人。
応援、よろしくお願いします。一緒に人生を最適化していきましょう。
次回はこちら(シリーズ「早速自動化しました」の続き)。