📘 SNS連携セットアップガイド

各SNSを sns-auto-poster に繋ぐ手順。基本は「ワンクリック連携」が用意されているSNSから始めるのがおすすめ。

📹 動画投稿の概要

7媒体すべてに mp4 動画を投稿できます。各媒体の API・仕様に合わせて自動で変換・アップロードします。

対応形式

• mp4 (H.264) 推奨 — 全媒体で確実に通る
• mov / webm も受け付けますが、媒体によっては自動変換されます
• クライアント側で 100MB / 10分 以内に制限 (Bluesky 60秒の最小値に合わせる)

📝 動画の添付手順

1. ダッシュボード → ✨ AI Generate でドラフトを通常通り作成
2. 📝 Drafts タブに移動 → 作成したドラフトの行に 📹 動画 ボタンが見える
3. クリック → ファイル選択ダイアログ → mp4 を選ぶ
4. サーバーが Supabase Storage (video-assets バケット) に保存 + DBに記録
5. サムネが動画プレビュー (▶ オーバーレイ付き) に変わる
6. Approve → 予約 or Post Now で実投稿

NOTE は特殊

NOTE は ローカル PC の Playwright runner が15分おきに拾います。Approve しても即時投稿されません。サーバー側 (Railway) からは NOTE 投稿は走りません。

📓 note 連携 セクションの ③ で Task Scheduler 登録手順を参照してください。

📊 媒体別の制限一覧

🆘 動画投稿のトラブル対処

♾️ 自律改善ループとはPro限定

Resonate Post の 最大の特徴 がこれ。投稿するたびに AI が反響を学習して、来週の生成プロンプトに自動反映するループ。
運用するほど発信が磨かれていきます。

仕組み

1. 投稿            → 7媒体 (X / LinkedIn / Bluesky / Threads / FB / WP / NOTE)
2. 反響を毎時計測  → いいね / コメント / 保存 / シェア / 閲覧
3. 日曜 23:30 UTC  → AI が「効いた要素」「避ける要素」を抽出 → WeeklyInsight に保存
4. 月曜 08:30 JST  → 週次サマリーメールで通知
5. 以降の生成     → systemPrompt に自動注入されて、次週の投稿に反映

📊 /insights ページの見方

ダッシュボード右上の ♾️ Insights ボタンから開けます。3つのセクションで構成:

① ステータスサマリー (4カード)

• 累計インサイト: これまで生成された AI 分析の数
• 最新週: 最後に AI が分析した週
• 対象プラットフォーム: 分析対象になった SNS の数
• ステータス: ✅稼働中 / ⏳初回待ち / 🔒Pro限定

② 過去のインサイト一覧

プラットフォーム別カード:

• 📝 サマリー: AI が書いた今週の総括 (300字程度)
• ✅ 効いた要素: 来週の生成プロンプトに自動注入されるルール
• ⚠️ 避ける要素: 来週の生成で減点対象として明示

③ 📡 読者が次に聞きたがってる話題

過去30日のあなたの投稿のうち、以下のいずれかが「異常に高い」投稿から続編ネタを自動抽出:

• 🔖 保存が伸びた: 「もっと深く読みたい」シグナル → 深掘り版・3つの実例
• 💬 質問が来てる: 「読者が質問している」シグナル → FAQ・誤解の解消
• 🔁 シェアされた: 「アイデンティティに刺さった」シグナル → 別事例・別業界版

各カードの 📝 この角度でドラフト作成 ボタンで、その角度のままダッシュボードの Generate タブに飛んで投稿作成できます。

④ 📅 14日以内のイベント・先回りネタ

祝日・季節・ビジネス周期 (年度末・ボーナス時期 etc) を AI があなたのテーマと結びつけて角度提案。「桜が綺麗」じゃなくて「桜と起業3年目で気付くこと」のような切り口を出します。

⚡ 重要投稿モード (マルチAI討論)

ダッシュボードの AI Generate タブにある ⚡ 重要投稿モード チェックボックス。絶対外したくない投稿だけに使ってください。

4段パイプライン

Stage 1: OpenAI が初期草案を3つの角度で生成
Stage 2: 別 AI (Claude / Gemini) が独立した視点で辛口批評
Stage 3: OpenAI が批評を踏まえて統合・書き直し
Stage 4: 「重要投稿の格」最終仕上げ (フック最強化、無駄削除)

コストとレイテンシ

使い方

1. ダッシュボード → ✨ AI Generate タブ
2. テーマ・切り口を入力
3. ⚡ 重要投稿モード のチェックを ON
4. 「生成 (プレビュー)」をクリック
5. 結果カードの下に ⚡ マルチAI討論の中身を見る という折りたたみセクションが出る → クリックで Stage 1〜4 の中身が全部見られる

💡 ネタ候補を効率よく回す

毎週月曜の朝にやるルーティン例:

1. 📧 週次サマリーメールを開く → 「今週のAI分析」セクションを読む
2. ♾️ Insights ページを開く → 「効いた要素」を頭に入れる
3. 📡 「読者が次に聞きたがってる話題」セクションから1〜2件、続編ネタを選ぶ
4. 各カードの 📝 この角度でドラフト作成 をクリックして AI Generate へ
5. 3案から選んで予約投稿 (定期ルールに組み込めばさらに自動化)
6. 📅 「先回りネタ」もチェック → 来週の祝日 / 業界イベントに合わせた投稿を予約

🚀 はじめに

各SNSを sns-auto-poster と連携するには大きく2つの方法があります。

💡 おすすめ順: まず LinkedIn (ワンクリック連携) で動作確認 → 次に note (運用者側設定が必要) → そのあと使いたいSNSを順次追加。

🔵 LinkedIn 連携かんたん

ワンクリックで連携できます。アクセストークンの手動取得は不要です。

クライアント側 (利用者) の手順

運用者 (サービス提供側) の事前セットアップ

ワンクリック連携を使えるようにするには、サービス管理者が LinkedIn Developer Console で1回だけ設定する必要があります。

LINKEDIN_CLIENT_ID=86xxxxxxxxxx
LINKEDIN_CLIENT_SECRET=WPL_xxxxxx==

手動でアクセストークンを入れる場合 (緊急用)

OAuth が動かない場合の逃げ道。LinkedIn 公式 Token Generator を使います。

1. https://www.linkedin.com/developers/tools/oauth/token-generator を開く
2. 自分の作ったアプリを選択
3. Scopes チェック: openid profile email w_member_social
4. 「Request access token」→ 認証画面で許可 → access token が表示される
5. ダッシュボード → SNS Credentials → 「認証情報の追加 / 更新」:
   • サービス: LinkedIn
   • キー名: access_token
   • 値: コピーした token
   • 「保存」

トークンの有効期限は2ヶ月。失効したら再取得して同じ手順で上書き。

📓 note 連携かんたん

note は 公式投稿APIがない ため、他媒体と違って ローカル PC でブラウザ自動化 (Playwright) を使います。サービス運用者側の Windows PC (常時稼働) で 15分おきに動く仕組みです。

使い方 (クライアント側)

1. ダッシュボード → ✨ AI Generate タブ
2. プラットフォーム: NOTE を選択
3. テーマを入れて「生成」→ 3案から選ぶ
4. 「Draft 作成」または「予約投稿」をクリック
5. 15分以内にローカル runner が拾って note.com に投稿 (下書きor公開、設定による)

運用者側セットアップ (Windows PC で1回だけ)

cd C:\Users\weapo\OneDrive\デスクトップ\SNS\自動投稿
npm i -D playwright
npx playwright install chromium

npx tsx scripts/note-spike/login.ts

schtasks /create /f /sc minute /mo 15 /tn "SnsAutoPoster-NoteTick" /tr ""C:\Users\weapo\OneDrive\デスクトップ\SNS\自動投稿\scripts\run-note-tick.bat"" /ru "ガレリア\weapo" /it

schtasks /create /f /sc daily /st 23:00 /tn "SnsAutoPoster-NoteMetrics" /tr "cmd /c cd /d "C:\Users\weapo\OneDrive\デスクトップ\SNS\自動投稿" && set NOTE_METRICS_ENABLED=1 && npx tsx scripts/note-metrics-runner.ts" /ru "ガレリア\weapo" /it

NOTE_PUBLISH_MODE=publish      # 自動公開する場合 (draft なら下書き保存まで)
NOTE_USERNAME=your_note_user   # note.com の自分のユーザー名 (URL用)
NOTE_METRICS_ENABLED=1         # メトリクス取得を許可 (安全装置、未設定なら走らない)

動作確認

1. 投稿: ダッシュボードから NOTE 向けドラフト作成 → 15分以内に runner が拾う → タスクスケジューラの「最終実行結果」が成功になる → note.com に反映
2. メトリクス: 23:00 のメトリクスタスク実行後、/insights ページで NOTE 向けのインサイトが累積される

トラブルシューティング

🦋 Bluesky 連携かんたん

App Password 方式。OAuth不要、簡単。

1. Bluesky 設定 → App Passwords でアプリパスワード生成
2. ダッシュボード → SNS Credentials → 「認証情報の追加 / 更新」:
   • サービス: Bluesky
   • キー名: identifier / 値: ハンドル (例: username.bsky.social)
   • もう一度: キー名: app_password / 値: 生成したパスワード

📘 Facebook 連携ふつう

Facebook Page への投稿のみ対応 (個人ウォール投稿は API 非対応)。

1. Meta for Developers でアプリ作成
2. 製品「Facebook ログイン」+「Pages API」を追加
3. Graph API Explorer で Page Access Token 取得 (権限: pages_manage_posts pages_read_engagement)
4. 長期トークンに変換 (60日有効)
5. ダッシュボードに登録:
   • キー名: page_id / 値: 投稿先 Page の ID
   • キー名: page_access_token / 値: 取得したトークン

権限 pages_manage_posts は Meta の App Review 必須。承認に数日〜数週間かかります。

🧵 Threads 連携ふつう

Meta の Threads API。設定方法は Facebook と類似。

1. Meta for Developers でアプリに「Threads API」を追加
2. Threads User ID と Long-lived Access Token を取得
3. ダッシュボードに登録:
   • キー名: user_id
   • キー名: access_token

📝 WordPress 連携ふつう

WordPress 5.6+ の Application Password 機能で連携。

1. WordPress 管理画面 → ユーザー → プロフィール → Application Passwords セクション
2. 名前 (例: sns-auto-poster) を入れて「新しいアプリケーションパスワードを追加」
3. 表示される xxxx xxxx xxxx xxxx xxxx xxxx 形式のパスワードをコピー
4. ダッシュボードに登録:
   • キー名: site_url / 値: https://example.com (末尾スラッシュ無)
   • キー名: username / 値: WPログイン名
   • キー名: app_password / 値: コピーしたパスワード

📔 はてなブログ 連携ふつう

AtomPub API + WSSE 認証。

1. はてなブログ管理画面 → 設定 → 詳細設定 → AtomPub セクション
2. 「APIキー」をコピー
3. ダッシュボードに登録:
   • キー名: user_id / 値: はてなID
   • キー名: api_key / 値: コピーしたAPIキー
   • キー名: blog_id / 値: ブログのドメイン (例: username.hatenablog.com)

🐦 X (Twitter) 連携むずかしい

⚠️ X API は有料です
投稿APIを使うには Basic tier ($200/月) 以上が必須。無料枠では投稿できません。
法人向け運用で X が必須でない場合、LinkedIn / note / Facebook で十分なケースがほとんどです。

1. X Developer Portal で開発者アカウント取得 (Use Case 申請審査あり)
2. Basic Plan ($200/月) に課金
3. App を作成し、OAuth 1.0a の4つの値を取得:
   • API Key (Consumer Key)
   • API Secret (Consumer Secret)
   • Access Token
   • Access Token Secret
4. ダッシュボードに4つ全て登録 (service=X, key_name はそれぞれ api_key / api_secret / access_token / access_token_secret)

🆘 困ったときは

• 接続テストで401 → トークンの有効期限切れか、キー名/値の貼り間違い。再取得して上書き保存。
• 投稿が失敗 → ダッシュボードの「Drafts」タブで該当ジョブの「last_error」を確認。
• その他のエラー → お問い合わせ から運営にご連絡ください。

最終更新: 2026-05-18