モバイル連携
このページでは、Social Archiverモバイルアプリから設定する外部サービス連携であるImmich、Raindrop、Notion、Reader、Karakeepを説明します。Instagramの保存と端末ローカルのログインセッションについてはInstagramプラットフォームガイドを参照してください。
Instagramガイドの移動
Instagramは独立したプラットフォームガイドへ移動しました。モバイル・デスクトップセッション、Chromeインポート、ストーリー、購読、Immichエクスポートをまとめて説明します。
概要
| 連携 | 状態 | 最適な用途 | 接続方法 |
|---|---|---|---|
| Immich | 利用可能 | アーカイブ済みの写真・動画をセルフホストのメディアライブラリへ送信 | ImmichサーバーURL、APIキー、アルバム |
| Raindrop | モバイルアプリに表示される場合に利用可能 | ブックマークのインポートと新規アーカイブリンクのエクスポート | Raindrop OAuth |
| Notion | 利用可能 | アーカイブ済み投稿とページのNotionデータベース構築 | モバイルアプリからNotion OAuth |
| Reader | モバイルアプリに表示される場合に利用可能 | Readwise Readerへアーカイブを送信 | Readwiseアクセストークン |
| Karakeep | ベータ、モバイルアプリに表示される場合に利用可能 | セルフホストのブックマークマネージャーへ保存 | KarakeepサーバーURLとAPIキー |
モバイルアプリ内のReaderはReadwise Readerを意味します。必要な連携が設定に表示されない場合は、まずモバイルアプリを更新してください。一部の連携は、ロールアウトまたはビルド提供状況にも依存する場合があります。
接続前に
- Social Archiverモバイルアプリをインストールしてサインインします。
- Settings -> Integrationsを開きます。
- 完了したアーカイブをNotionや他の接続済みクライアントへ自動同期したい場合は、Auto-syncを有効のままにします。
- Immich、Raindrop、Reader、Karakeepでは、それぞれの自動保存設定を使います。
- クライアント同期をWiFiまで待たせたい場合は、WiFi onlyをオンにします。
各サービスには、それぞれ独自の認可、トークン、またはAPIキーが必要です。
Immich
Immich連携は、完了したSocial Archiverアーカイブのメディアを、セルフホストのImmichサーバーにあるアルバムへ送信します。1件を手動保存する、新しいモバイルアーカイブのメディアを自動アップロードする、サーバー同期済み接続で購読メディアを自動エクスポートする、といった使い方ができます。
モバイルでImmichを接続する
- ImmichのAccount Settings → API KeysでAPIキーを作成します。
- Social Archiverモバイルアプリで設定 → 連携 → Immichを開きます。
- ImmichサーバーURLとAPIキーを入力します。
- アルバムを入力または選択します。存在しない場合はSocial Archiverから作成できます。
- 接続をタップします。アプリは保存前に認証情報を検証します。
スマートフォンから到達できる場合、プライベートネットワーク、Tailscale、http://アドレスも手動保存とモバイル自動アップロードに使えます。スキームを省略したホスト名はHTTPSとして扱われるため、必要な場合はhttp://を明示してください。
メディアを保存する
- アーカイブのアクションメニューからSave to Immichを使って1件を保存します。
- 複数のアーカイブを選択し、Immich一括エクスポートを使います。
- 新しいメディアを自動アップロードを有効にし、許可するプラットフォームを選択します。
- 接続済みImmich設定から既定アルバムを選択または作成します。
アーカイブにはダウンロード可能なメディアが必要です。同じアセットを識別できる場合はImmichの重複チェックによって再アップロードせず、保存済みとして通知します。
モバイル専用とサーバー同期済み
| 接続状態 | モバイル手動保存 | モバイル自動アップロード | 購読の自動エクスポート |
|---|---|---|---|
| モバイル専用 | スマートフォンからImmichへ到達できる間は可 | 到達できる間は可 | 不可 |
| サーバー同期済み | 可 | 可 | 可 |
購読ジョブはSocial Archiverサーバーで実行されます。そのため、公開HTTPSエンドポイント、Cloudflare Tunnel、Tailscale Funnelなど、Social Archiverサーバーから到達できるImmich URLが必要です。プライベート・Tailscale専用URLがスマートフォンでは動作してもサーバーから到達できない場合、手動エクスポートを無効にせず、接続をモバイル専用として保持します。
ローカル専用の場合、APIキーはモバイルの安全なストレージに保存されます。サーバー同期に成功した場合は、購読の予約エクスポート用に暗号化されたコピーをサーバーへ保存します。APIキーは分析やログに含まれません。
ChromeからImmichを使う
Chrome拡張には、Settings → Immich Direct Uploadに独立した直接接続があります。サーバーURLとAPIキーを入力し、アルバムを選択または作成すると、Instagramインポートなど対応する直接アップロード画面からImmichへメディアを送信できます。拡張機能はAPIキーをそのChromeプロファイルに保存し、直接アップロードではSocial Archiverサーバー接続を必要としません。
高画質の動画と音声が分離されているソースは、Local Media Helperで結合してからアップロードできます。
Immichを切断する
切断すると保存済み認証情報を削除し、今後のエクスポートを停止します。Immichへアップロード済みのアセットは削除されません。
Raindrop
Raindrop連携は双方向に動作します。選択したRaindropブックマークをSocial Archiverへアーカイブし、新しいSocial ArchiverアーカイブのリンクをRaindropへ保存できます。
接続と設定
- 設定 → 連携 → Raindropを開きます。
- 接続をタップし、Raindrop OAuthリクエストを認可します。
- 新規ブックマークを自動確認するか選択します。
- 購読アーカイブを含む自動エクスポートが必要な場合は、新しいアーカイブをRaindropへ保存を有効にします。
- Social Archiverから送信済みのリンクを再インポートしないよう、エクスポート済み項目を除外を有効のままにします。
今すぐインポートでは、ブックマークをプレビューし、検索またはコレクションで絞り込み、すぐにアーカイブする項目を選べます。アーカイブのアクションメニューからSave to Raindropで1件を送るか、一括エクスポートで複数項目を送信できます。エクスポートしたリンクにはSocial Archiverとプラットフォームのタグが付きます。
切断すると今後のインポート・エクスポートは停止しますが、既存のRaindropブックマークやSocial Archiverアーカイブは削除されません。
Notion
Notion連携は、モバイルアプリから完了したアーカイブをNotionワークスペースへ同期します。Social ArchiverはSocial Archivesデータベースを作成または再利用し、各アーカイブをNotionページとして書き込めます。
送信される内容
- アーカイブタイトル、プラットフォーム、元URL、アーカイブID、アーカイブ日
- 著者、ハンドル、公開日、いいね、コメント、共有、表示数など利用可能なメタデータ
- アーカイブ本文ブロックと利用可能なメディア参照
- バックエンドとNotionファイル制限が対応する場合の動画アップグレード処理
Notionを接続する
- モバイルアプリを開きます。
- Settings -> Integrationsへ移動します。
- Notion行のConnectをタップします。
- NotionブラウザフローでSocial Archiverを認可します。
- データベースを作成できるワークスペースまたはページへのアクセスを許可します。
- 認可が完了したらSocial Archiverへ戻ります。
接続後、Notion行に接続済みワークスペースが表示されます。Auto-syncが有効な場合、新しく完了したアーカイブは自動的に同期できます。
Notionを切断する
Settings -> Integrationsで接続済みNotion行をタップし、切断を確認します。そのワークスペースへの同期は停止しますが、既存のNotionページは削除されません。
Reader
Reader連携は、完了したアーカイブをReadwise Readerへ保存します。Social Archiverのキャプチャを、記事、ニュースレター、保存済みWebページと同じ読書キューに入れたい場合に便利です。
送信される内容
- 元URLとアーカイブタイトル
- 利用可能な場合、著者、要約、コンテンツまたはHTML、画像URL、メモ
- 既定タグと任意のプラットフォームタグを含むタグ
- 記事、ソーシャル投稿、動画など、ソースに基づくReaderカテゴリ
Readerを接続する
- readwise.io/access_tokenを開き、アクセストークンをコピーします。
- Social Archiverモバイルアプリを開きます。
- Settings -> Integrationsへ移動します。
- Reader行のConnectをタップします。
- トークンを貼り付けて接続します。
Reader設定
接続済みReader行をタップして設定します。
- Auto-save: アーカイブ完了時にReaderへ保存
- Save Location: アイテムをLaterまたはNewへ送信
- Default Tags: Reader保存に追加されるタグ
- Include platform tag: ソースプラットフォーム名などのタグを追加
- Platforms: Readerへの保存を許可するモバイルアーカイブソースを選択
アーカイブに元URLがあり、プラットフォームが許可されている場合は、アーカイブアクションメニューからSave to Readwiseも使用できます。
Readerを切断すると、保存済みトークンはモバイルアプリから削除されます。既存のReaderアイテムは削除されません。
Karakeep
Karakeep連携は、完了したアーカイブをKarakeepサーバーのブックマークとして保存します。セルフホストのRead-it-laterまたはブックマークワークフローを運用している場合に便利です。
送信される内容
- 元URLとアーカイブタイトル
- 利用可能な場合、要約またはメモ本文
- 既定タグと任意のプラットフォームタグ
- Karakeepブックマークで表現できるアーカイブメタデータ
Karakeepを接続する
- KarakeepでSettings -> API KeysからAPIキーを作成します。
- Social Archiverモバイルアプリを開きます。
- Settings -> Integrationsへ移動します。
- Karakeep行のConnectをタップします。
https://bookmarks.example.comのようなKarakeepサーバーアドレスを入力します。- APIキーを貼り付けて接続します。
モバイルアプリはベースサーバーURLを受け取り、Karakeep API用に正規化します。/api/v1を追加する必要はありません。
Karakeep設定
接続済みKarakeep行をタップして設定します。
- Auto-save: アーカイブ完了時にKarakeepへ保存
- Default Tags: Karakeepブックマークに追加されるタグ
- Include platform tag: ソースプラットフォーム名などのタグを追加
- Platforms: Karakeepへの保存を許可するモバイルアーカイブソースを選択
アーカイブに元URLがあり、プラットフォームが許可されている場合は、アーカイブアクションメニューからSave to Karakeepも使用できます。
Karakeepを切断すると、保存済み認証情報はモバイルアプリから削除されます。既存のKarakeepブックマークは削除されません。
自動保存と手動保存
自動エクスポートはアーカイブ完了後に実行されます。Immich、Raindrop、Reader、Karakeepの手動保存アクションは、その連携に必要なデータがある場合にアーカイブアクションメニューから利用できます。
Raindrop、Reader、KarakeepなどURLベースのサービスでは、次の条件を確認します。
- 連携が接続され、有効になっている
- アーカイブに元URLがある
- アーカイブのプラットフォームが、その連携設定で除外されていない
- モバイル端末がオンラインである
Immichにはダウンロード可能なメディアと到達可能なサーバーが必要です。Raindrop、Reader、Karakeepはアイテムがすでに存在することを報告する場合があり、その場合は重複を作成せず、保存済みとして通知します。
トラブルシューティング
| 問題 | 確認すること |
|---|---|
| 連携行がない | モバイルアプリを更新してください。ReaderとKarakeepは対応ビルドまたはロールアウトグループでのみ表示される場合があります。 |
| Immichが接続を拒否する | 完全なサーバーURLを確認し、ImmichのAccount Settings → API Keysで新しいAPIキーを作成します。スマートフォンからサーバーへ到達できることも確認してください。 |
| モバイルではImmichが動くが購読では動かない | モバイル専用接続です。Social Archiverサーバーから到達できる公開HTTPS Immich URLへ変更し、サーバー同期を再試行します。 |
| Immichへアップロードするアセットがない | アーカイブに写真・動画があり、元メディアURLが期限切れでないことを確認します。 |
| Raindrop接続の期限切れ | 設定 → 連携 → RaindropからOAuthで再接続します。 |
| エクスポート済みRaindropリンクが再び入る | Raindrop設定でエクスポート済み項目を除外を有効にします。 |
| Notion接続に失敗する | ブラウザ認可が完了し、Social Archiverがデータベースを作成できる少なくとも1つのNotionページにアクセスできることを確認してください。 |
| Readerトークンに失敗する | readwise.io/access_tokenで新しいトークンを生成し、もう一度貼り付けてください。 |
| Karakeep接続に失敗する | サーバーURL、APIキー、HTTPSアクセス、Karakeepサーバーがスマートフォンから到達可能かを確認してください。 |
| Notion同期が実行されない | Auto-syncが有効で、Notion接続が有効であることを確認してください。 |
| ReaderまたはKarakeepの自動保存が実行されない | その連携のAuto-save設定が有効で、プラットフォームが許可され、アーカイブに元URLがあり、スマートフォンがオンラインであることを確認してください。 |
| 同期の待ち時間が長すぎる | WiFi-only同期が有効かどうか、スマートフォンが現在WiFiに接続されているかを確認してください。 |