noteの新インプレッションを自動収集！記事別データで改善へ｜Github｜API｜インプレッション｜#508

はじめに｜買う前に読んでほしい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% やった。

ただな、あの記事の最後にこう書いてん。

これや。
率は絶対値やない。

インプレッションが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に毎朝を任せた

やっとることは単純や。

1. 毎日決まった時刻にGitHub Actionsが起動する

2. noteのダッシュボードが使っとる仕組みを、自分のCookieで叩く

3. 返ってきた数字をdata/funnel/のCSVに追記する

4. そのままリポジトリにコミットされる

早朝に走らせとるのは、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無料枠で収まる）

• コマンドライン操作 → 要らん

1. テンプレートの入手