NOTE 連携セットアップ手順 (ViralForge)
本書は ViralForge から note.com へ自動投稿するための、クライアント様側の準備手順です。
note.com アカウントの準備と、運営担当者との立会いログインで完了します。所要 15 分ほど。
1. NOTE 連携の仕組み
note.com は第三者向けの投稿 API を公開していないため、ViralForge は note.com にログイン中のセッション情報 (cookie) を引き継いで自動投稿を行います。
- ローカル PC で取得した session cookie を ViralForge に登録
- ViralForge が cookie 経由で note.com にアクセスし、記事下書き作成から公開までを自動化
- cookie は Fernet 対称暗号化で DB 保存され、組織間で参照されません
note.com 側の bot 保護強化を受けて、従来の email + password による自動ログイン方式は使用していません。cookie 取得時に問題が発生した場合は §6 よくあるエラー をご参照ください。
2. 事前準備
2-1. note.com アカウント
- note.com のアカウント (無料プランで可)
- 直近で BAN / ロック / 凍結などの制限を受けていないこと
- 一度手動で記事を投稿できることを確認
- 立会い当日の前 24 時間以内に、お手元 PC の通常ブラウザで note.com に 1 回ログインしておく (bot 判定を緩めるため)
3. 連携手順 (立会いログイン、所要 15 分)
連携作業は 運営サポート が立会いの上で実施します。お客様の note.com パスワードを運営に共有する必要はありません。
パスワード共有は推奨していません。立会いログインでは、お客様自身が note.com にログインしていただき、運営側はその後発行された session cookie のみを受領します。パスワード本体が運営に渡ることはありません。
3-1. 立会いログインの流れ
- (お客様) Zoom などの画面共有ツールで運営サポートと接続し、note.com にログインします。2 段階認証 (2FA) を設定済みの場合も、通常通り 2FA を通過してください。ViralForge 側は cookie のみ受領するため、2FA 構成は不問です。
- (運営) 画面共有経由で session cookie を取得し、ViralForge の対応プランに登録します。
- (運営) ViralForge から手動投稿テストを 1 件実行し、お客様側の note.com マイページで投稿が公開されることを確認します。
3-2. 上級利用 (技術担当者が常駐する場合)
技術担当者がいらっしゃる場合は、お客様側で session cookie を JSON 形式で export して運営に送付する経路もご利用いただけます。詳細は運営サポートまで別途ご相談ください。
3-3. 連絡先 / 立会い予約
立会い日時の調整は 運営サポート までご連絡ください。具体的な連絡経路はご契約時にお伝えする窓口情報をご利用ください。
- SLA: 営業時間内のお問い合わせは即日着手、営業時間外は翌営業日 9:00 までに着手
- 立会い時間枠: 15 分 (画面共有 + cookie 取得 + 投稿テスト)
4. プラン側の NOTE 設定
cookie 登録だけでは投稿されません。プラン側で NOTE を有効化する必要があります。
- プラン編集画面を開く
- NOTE タブを選択
- 以下を設定
- 投稿時刻 (JST): 例 09:00
- スケジュール: 毎日 / 曜日指定 / スプレッドシート連動
- ハッシュタグ (任意、カンマ区切り)
- マガジン (任意、note.com 側で事前作成済のもの)
- 保存
投稿は Phase 1 (本文生成) → Phase 2 (画像生成) → Phase 3 (note.com 投稿) の順で実行されます。承認モード manual の場合は Phase 2 完了で停止し、管理画面から承認するまで公開されません。
5. cookie 期限切れ対応
session cookie の有効期限は運営観測値で 約 4 ヶ月 です。期限が近づくと再ログイン立会いが必要になります。
- 現在は cookie 期限切れ時の再取得は 立会い再ログイン (15 分) で対応します
- 期限切れ前の自動 push 通知は検討中 (時期未確定)。push 通知が整備されるまでの間は、運営からご連絡することがあります
- 投稿が止まっていることに気づかれた場合は、運営サポートまでご連絡ください。投稿履歴画面のエラー文言と、直近で投稿に成功していた日時をお手元にご準備いただくとスムーズです
6. よくあるエラー
| エラー |
原因 |
対処 |
cookies not configured |
連携未完了 (cookie 未登録のプラン) |
運営サポートに連携手順 (§3) を依頼 |
cookie_session_invalid |
cookie 期限切れ、または note.com 側で session が強制ログアウトされた (パスワード変更時など) |
立会い再ログインを運営サポートに依頼 (§5) |
| 投稿が見当たらない / 投稿失敗が続く |
cookie / プラン設定 / note.com 側制限のいずれか |
履歴画面でエラー文言を確認の上、運営サポートに連絡 |
連絡前に揃えていただく情報: ViralForge 履歴画面のエラー文言 (コピペで OK) / 直近で投稿が成功していた日時 / 対象プラン名。
7. 投稿制限の目安
note.com は公式のレート制限値を公開していません。運用実績からの目安として 1 アカウント 1 日 5 記事以内、同一アカウントへの同時刻投稿は避ける (10 分以上ずらす) を推奨します。ViralForge 側では 1 投稿ごとに 25 秒待機、2 投稿完了ごとにブラウザリセットで bot 判定を回避しています。
8. セキュリティ
- パスワードは ViralForge に保存されません。新規プランを連携する際、パスワード入力欄は空欄のままで構いません (cookie 単独運用となり、Fernet 暗号化対象は session cookie のみです)。
- 過去に登録されたパスワードについては、互換性維持のため一部のプランで暗号化保存されたまま残存しています。cookie 切替後の安全確認を経て、運営が順次削除いたします。
- session cookie および残存パスワードは Fernet 対称暗号化で DB 保存され、multi-tenant で組織間分離されています。他組織から参照されることはありません。
チェックリスト
- [ ] note.com で手動ログイン・手動投稿ができる
- [ ] 立会い当日の前 24 時間以内に通常ブラウザで note.com にログイン済 (顧客側で)
- [ ] 立会いログイン枠を運営サポートと予約済
- [ ] プラン側で NOTE を有効化、投稿時刻・スケジュール設定済
- [ ] カレンダーに 4 ヶ月後のリマインダーを登録済 (運営連絡が来なかった場合の保険として、顧客側で)
以上で NOTE 連携の準備は完了です。不明点は運営サポートまでお問い合わせください。