
noteの新インプレッションを自動収集!記事別データで改善へ|Github|API|インプレッション|#508
- 残り7
はじめに|買う前に読んでほしい4つ
noteの新しいインプレッションを記事別に貯める話をする。
……の前に、長い記事やから大事なことだけ4つ置いとく。
1|note公式の変更で、使えんくなることがある
これはnoteの公式APIやない。
ダッシュボードが裏で使っとる仕組みを、自分のログイン情報で叩いとるだけや。
note側が構造を変えたら、ある日いきなり止まる。
現に昨日、ダッシュボードが変わって指標の意味が変わったところや。
次に何が変わるかはわからん。
2|商品というより、ワイがやってることの共有や
「誰でも安心して使える完成品」やない。
ワイが自分のために組んで、毎日回しとるものをそのまま出しとる。
動作保証もサポートもない。
そこは先に言うとく。
3|こういう人に買ってほしい
KITAcoreがやっとることを、自分でも真似したい人
同じもんを一から作る時間を削りたい人
AIに頼んで作らせるトークンを節約したい人
「ゼロから設計するのは面倒やけど、動くベースがあるなら触れる」人
逆に、丸投げで完璧に動くもんが欲しい人には向かん。
そこは正直に。
4|#284とは別物や。2本で1セットになる
半年前に出した収集記事(#284)は今も動いとる。置き換えやない。
#284 → フォロワー・ビュー・スキ。アカウント全体の分母
今回 → インプレッション・PV・売上・流入元。記事ごとの分子
わからんって思ったらAIに聞いて、楽しめる人
今回のだけでも単体で動く。
詳しくは本文で書く。
ほな、いこか。


昨日、noteのダッシュボードが変わった。
これまで「ビュー」ひとつやった数字が、インプレッションとページビューに割れてん。
今まで見えんかった「note内で表示された回数」が、数字で出るようになった。
速報は昨日のうちに書いた。
ワイの累計PVが自作ダッシュボードと2.13倍ズレとった話や。
▼【速報】noteダッシュボードが改訂されて、ワイのPVが2.13倍ズレた話
で、記事を出してからも、ずっと同じことを考えとった。
この数字、今日から取っといたほうがええんちゃうか。
……というわけで、その日のうちに取りに行った。
記事ごとのインプレッション・ページビュー・スキ・コメント・売上・流入元を、日付つきでCSVに積んでいく仕組み。
GitHub Actionsに載せて、毎朝03:30に勝手に走るようにした。
もう動いとる。
昨日ぶんから入っとる。
そのテンプレート一式を、この記事の有料パートに置いとく。
この記事でわかること
noteの数字を露出 → 閲覧 → 反応の3段で読む方法
インプレッション・PV・スキ・売上・流入元を記事別 × 日次で自動保存する仕組み
GitHub Actionsで毎朝回す設定(初回10分・コマンド操作なし)と、詰まったときそのままAIに貼れる質問文3本
Cookieを預けるときに、何が安全で何が危ないんか(無料パートで全部書く)
開封率(PV ÷ インプレッション)とスキ率が落ちたとき、タイトルと本文のどっちを疑うか
テンプレート一式(Actions定義・収集スクリプト・SQLite化スクリプト・README)
要するに、 新しい数字の見方の話やなくて、 新しい数字を、今日から残す話や。
先に、これが何の商品なんかを言うとく
順番として、ここを最初に置いとく。
これは「保証されたツール」やない。
ワイが実際にやっとる取得方法の記録や。
note公式のAPIやない。
ダッシュボードが裏で使っとる仕組みを、自分のログイン情報で叩いとるだけ。
note側が構造を変えたら、ある日いきなり止まる。
現に、昨日それが起きた。
ダッシュボードが変わって、指標の意味が変わった。次に何が変わるかはわからん。
ワイは1人でやっとるから、問い合わせ窓口も用意できひん。
ずっと安定して動く保証は、どこにもない。
個別のサポートはせん。
ここは先にはっきり言うとく。
その代わり、こういう構造になっとる。
1|ワイもこれを使い続ける
このツールはワイ自身が毎日回しとるやつや。
止まったらワイが一番困る。
せやから、動かんくなったら直す。
読者のためやなくて、自分のために。
直したら記事に書く。
それがそのまま更新版になる。
逆に言うと、ワイが困らんかったら気づかんこともある。
そこは期待せんといてくれ。
2|ワイの環境で出んエラーは、直しようがない
WindowsかMacか、GitHubのUIがいつ変わったか、Cookieをどこで切ってもうたか。
環境が違えば起きることも違う。
ワイの手元で再現せんもんは、直せん。
これは意地悪やなくて、単純にそういうもんや。
で、そこは正直に言うけど、ワイよりAIのほうが賢いし丁寧や。
エラー文を貼って聞いたほうが、ワイに聞くより速いし詳しい。
ワイ自身このスクリプトを直すときにそうしとる。
有料パートに、そのまま貼れる質問文を3本置いといた。
3|止まっても、貯めたデータは消えん
手元のCSVはそのまま残る。
止まるのは「今日以降が増えん」だけや。
時計が止まるだけで、過去は消えん。
ここを飲めるなら読み進めてくれ。
飲めんなら、ここで閉じてもらってええ。
ほんまに。
なんで、その日のうちに取りに行ったんか
割れたこと自体はええことや。
露出と閲覧が別物やと、やっと数字の上で言えるようになったんやから。
#506でワイは開封率という指標を勝手に置いた。
ページビュー ÷ インプレッション。
noteの公式にそんな指標はない。
メールマーケの言葉を借りただけや。
ワイの全期間は 4.61% やった。
ただな、あの記事の最後にこう書いてん。
ただし4.61%が高いんか低いんかは、まだわからん。
比較対象がおらんからな。
これや。
率は絶対値やない。
インプレッションが1,000でPVが80。
開封率8%。……で、これは高いんか低いんか。
わからん。
比較して初めて意味が出る数字や。
先週の自分、先月の自分、他の記事の自分。
そこと並べられて初めて「今回は低い」が言える。
比較対象が手元にないと、率は出せても読めん。
ぜんぶ「へえ」で終わる。
で、その比較対象は、毎日の数字を残しとかんと作れんのや。
ここでもう一個、大事なことがある。
ダッシュボードは「見る」もんや。「貯める」もんやない。
今日のインプレッションは、今日見た人の記憶にしか残らん。
明日には明日の数字になっとる。
……それ、データちゃう。
感想や。
つまり、改訂された昨日が起点になる。
今日から貯めはじめた人は、1ヶ月後に30日ぶんの分布を持っとる。
貯めてへん人は、1ヶ月後もまだ「今日の開封率」しか見られへん。
差がつくのは、たぶんここや。
せやから、その日のうちに取りに行った。
この記事は#506の続きで、あそこの「これからやること」に並べたやつの1個目にあたる。
露出 → 閲覧 → 反応。noteのインプレッションは3段の1段目や
数字を3段に割る。
それだけで、犯人がだいぶ絞れる。


PVだけ見とると「伸びた」「伸びてない」しか言えん。
3段に割ると「どこでコケたか」が出る。
たとえば、こういうのが見えてくる。
インプレッションは出とるのに開封率が低い記事 → タイトルが弱い
開封率は高いのにスキ率が死んどる記事 → 導入で期待させて本文で裏切っとる
両方ええのにインプレッションだけ少ない記事 → 出す時間かタグの問題
これ、1記事ずつ電卓で出すもんやない。
記事別 × 日次の表があれば、並べ替えるだけで出る。
……で、その表がない。
前に配った収集の仕組みは、今も動いとる
先に整理しとく。
ワイは半年前にも、noteの数字を自動収集する記事を出しとる。
▼Noteの閲覧数・スキ数を自動で収集する方法|#284
あっちはダッシュボード改訂後の今も、問題なく動いとる。
ワイの手元でも回り続けとる。
で、今回のこれは置き換えやない。追加や。
というより、2本で1セットになる設計や。
#284が取るもの 今回が取るもの 単位 アカウント全体 記事ごと 中身 ビュー / スキ / フォロワー数 / 記事一覧 インプレッション / PV / スキ / コメント / 売上 / 流入元 役割 分母 分子
フォロワー数は今回のツールには入っとらん。
#284がもう取っとるからや。
同じもんを2回取っても意味がない。
そして、フォロワーの日次データはあとから遡って取れん。
noteは過去のフォロワー数をくれんからな。
#284を早い時期に入れとった人は、それだけで数ヶ月ぶんの分母を持っとることになる。
もちろん、リポジトリを分けて両方まわしてもええし、今回のだけ入れても単体で動く。
依存関係はない。
#284を持ってへん人でも、この記事だけで完結する。
GitHub Actionsに毎朝を任せた
やっとることは単純や。

毎日決まった時刻にGitHub Actionsが起動する
noteのダッシュボードが使っとる仕組みを、自分のCookieで叩く
返ってきた数字をdata/funnel/のCSVに追記する
そのままリポジトリにコミットされる
早朝に走らせとるのは、noteの集計が前日ぶんで落ち着いたあとに取りに行くためや。
同じ日を2回まわしても、その日の行は削除してから書き直す設計にしてあるから、重複行は増えん。
GitHubの無料枠で足りる。
Actionsの無料時間は月2,000分あって、このジョブは1回1分くらいや。
そして、コマンドは1行も打たん。
リポジトリ作って、ファイルをドラッグして、Cookieを1個登録する。
全部GitHubの画面の中で終わる。
ローカルにPythonを入れる必要もない。
できるCSVは5本。

地味に効くのがreferrers_daily.csvや。
note.comの中から来たんか、Google検索からか、Xからか。
これが記事によってびっくりするくらいちゃう。
「Xで伸びた気がしとる記事」の流入内訳を見て、Xがほぼおらんかったときの顔、あんまり人に見せられん。
Cookieを預ける話をしとく
さっき「保証はない」の話はした。
もう一個、買う前に知っといてほしいことがある。
この仕組みは、noteのログインCookieをGitHubのSecretsに登録して動かす。
Cookieはログイン情報そのものや。
ここを曖昧にしたまま買わせる気はない。
やっとる対策
GitHubのSecretsは暗号化されて保存される。設定画面にも、Actionsの実行ログにも値は出えへん
スクリプト側でも、Cookieとトークンの値は一切printせん設計にしてある(文字数だけ出す)
リポジトリはPrivate必須。自分の解析データやし、公開する理由がひとつもない
それでも残るリスク
Cookieを他の場所に貼ったら終わりや。ファイル、メモ帳、チャット、他人。GitHubのSecrets以外に置かんこと
取るのは自分のダッシュボードのデータだけ。他人のデータは触らんし、投稿・スキ・フォローみたいな操作も一切せん。1日1回、数十リクエストだけや
繰り返しになるけど、詰まったらAIに聞いてもらう前提で全部書いてある。エラー文をそのままChatGPTなりClaudeなりGeminiに貼れば、たいていその場で返ってくる。
有料パートにはそのまま貼れる質問文も置いといた。
ここから先に入っとるもの
ここまでが、なんでこれを作ったんかの話。ここから先は実物や。
テンプレート一式(Actions定義 / 収集スクリプト / SQLite化スクリプト / README)の入手先
セットアップ全手順(初回10分・6ステップ・押すボタンの場所まで)
Cookieの取り出し方(DevToolsのどこを見て、どこからどこまでコピーするか)
CSV 5本の列の意味と、スプレッドシートでの開き方
開封率・スキ率が動いたときの判断分岐表(数字 → 次の一手)
過去分をまとめて取りに行くバックフィルのやり方
SQLiteにまとめて、率つきのビューを2つ生やすスクリプトの使い方
詰まったときの症状別の対処表(5パターン)と、AIに投げるための質問文3本
既知の制約(当日は途中経過 / 累積は前日まで / 売上が合わん理由 ほか)
では、以下有料パートや。
0. まず、必要な人かの確認
3つ揃っとったらいける。
GitHubアカウント(無料枠でええ。作ってから5分の人でも問題ない)
noteアカウント(自分のダッシュボードのデータだけ取る)
Chrome(Cookieを取り出すのに使う。Edgeでも手順はほぼ同じ)
逆に、要らんものも書いとく。
ローカルのPython環境 → 要らん(バックフィルとSQLite化だけは手元で回すけど、それは任意)
サーバー → 要らん
課金 → 要らん(GitHub無料枠で収まる)
コマンドライン操作 → 要らん