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

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人。

    応援、よろしくお願いします。一緒に人生を最適化していきましょう。
    次回はこちら(シリーズ「早速自動化しました」の続き)。


     
     
    AccelHack CTO / 東大卒。常にさぼる方法を探すエンジニア。効率・自動化・ミニマリズムで人生を最適化するのが好き。無駄は嫌いだけど、無駄なカロリーは取ってしまう。最短ルートを一緒に。

    あなたへのおすすめ