モバイル連携
モバイル連携により、Social Archiverモバイルアプリは完了したアーカイブを外部のナレッジツールやRead-it-laterツールへ送信できます。これらの連携は、Obsidianプラグインではなくモバイルアプリから設定します。
現在のモバイルアプリ連携には、Notion、Reader、Karakeepがあります。
概要
| 連携 | 状態 | 最適な用途 | 接続方法 |
|---|---|---|---|
| Notion | 利用可能 | アーカイブ済み投稿とページのNotionデータベース構築 | モバイルアプリからNotion OAuth |
| Reader | モバイルアプリに表示される場合に利用可能 | Readwise Readerへアーカイブを送信 | Readwiseアクセストークン |
| Karakeep | ベータ、モバイルアプリに表示される場合に利用可能 | セルフホストのブックマークマネージャーへ保存 | KarakeepサーバーURLとAPIキー |
モバイルアプリ内のReaderはReadwise Readerを意味します。設定にReaderまたはKarakeepが表示されない場合は、まずモバイルアプリを更新してください。一部の連携は、ロールアウトまたはビルド提供状況にも依存する場合があります。
接続前に
- Social Archiverモバイルアプリをインストールしてサインインします。
- Settings -> Integrationsを開きます。
- 完了したアーカイブをNotionや他の接続済みクライアントへ自動同期したい場合は、Auto-syncを有効のままにします。
- ReaderとKarakeepでは、それぞれの連携のAuto-save設定を使います。
- クライアント同期をWiFiまで待たせたい場合は、WiFi onlyをオンにします。
各連携はSocial Archiverアカウントを使用しますが、外部サービス側にはそれぞれ独自の認可、トークン、またはAPIキーが必要です。
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ブックマークは削除されません。
自動保存と手動保存
自動保存はアーカイブ完了後に実行されます。ReaderとKarakeepの手動保存アクションは、次の条件を満たす場合にアーカイブアクションメニューから利用できます。
- 連携が接続され、有効になっている
- アーカイブに元URLがある
- アーカイブのプラットフォームが、その連携設定で除外されていない
- モバイル端末がオンラインである
ReaderとKarakeepは、アイテムがすでに存在することを報告する場合があります。その場合、モバイルアプリは重複を作成せずに「Already in Reader」または「Already in Karakeep」メッセージを表示します。
トラブルシューティング
| 問題 | 確認すること |
|---|---|
| 連携行がない | モバイルアプリを更新してください。ReaderとKarakeepは対応ビルドまたはロールアウトグループでのみ表示される場合があります。 |
| 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に接続されているかを確認してください。 |