Chrome・Firefox・Safari・Edge のブックマークを集約し、AI が自動で要約・タグ付け。 このページはツールのポータルと使い方ガイドです。
本ページに USAGE.md の内容を反映しています。該当セクションへはヘッダーのナビから移動できます。
npm install -g pnpm で導入）git clone https://github.com/watanabe3tipapa/bookmark-manager-pe.git
cd bookmark-manager-pe
pnpm installpnpm install の最後に、SQLite 用のネイティブモジュールが Electron 向けに自動ビルドされます。
pnpm dev初回は数秒かかりますが、アプリのウィンドウが開きます。
画面は 3 つのパネル で構成されています。
| パネル | 場所 | 役割 |
|---|---|---|
| サイドバー | 左 | 検索・スマートビュー・タグ・デバイススコープ・同期 |
| ブックマーク一覧 | 中央 | 絞り込んだブックマークの一覧と操作ボタン |
| 詳細パネル | 右 | 1件のブックマークの編集・タグ操作 |
中央の一覧でブックマークをクリックすると右に詳細パネルが開き、タイトル・URL・メモの編集やタグの追加・削除ができます。
一覧上部にあります。
タイトル・タグは省略可能です。
各ブラウザで HTML ファイルを書き出して、アプリの インポート ボタンから取り込みます。
Cmd + Option + B）→ ⋯ → ブックマークをエクスポートCmd + Shift + O）→ インポートとバックアップ → HTML 形式でエクスポート⋯ → お気に入りをエクスポート× を押すと、そのタグだけ外せます。サイドバー上部の検索ボックスに入力すると、タイトル・URL・タグ を横断検索します。検索中もスマートビューやタグフィルタはそのまま適用されます。
| ビュー | 内容 |
|---|---|
| すべて | 全ブックマーク（デフォルト） |
| 未分類 | タグが1つも付いていないもの |
| 最近追加 | 7日以内に追加したもの |
| 使われていない | 追加から30日以上経過し、一度も開いていないもの |
| よく見る | 訪問回数が多いもの |
タグをクリックするとそのタグの付いたものだけに絞り込み。スコープは「すべて / 共有のみ / デバイス固有のみ」を切り替えられます（詳細パネルで各ブックマークも切替可）。
URL は自動正規化（utm_* 等の広告パラメータを除去）して比較するため、実質同じページは確実に重複判定されます。
| 項目 | ルール |
|---|---|
| タイトル | 一番長いタイトルを採用 |
| タグ | 両方のタグを合体 |
| 訪問回数 | 合算 |
| メモ | 改行で連結 |
Cloudflare のブラウザ（Kitesurf）で、保存したブックマークを自動分析します。日本語で 2〜3 文の AI 要約、サムネイル保存、関連リンクの発見を行います。
この機能は Cloudflare Worker として動くため、まずデプロイが必要です。
cd workers/explore
pnpm install
npx wrangler login # 初回のみ（Cloudflare アカウント）
npx wrangler deploy成功すると https://bookmark-explore.xxxxx.workers.dev のような Worker URL が表示されます。
アプリの一覧上部にあります。
パネル内の「設定」→ 接続テスト → 保存。
デフォルトは「未分類のみ」。全件 / 現在の絞り込みも選択可。
完了後、結果の「適用」で要約・タグ・サムネイルを保存。
「発見したリンク」から未登録のページをまとめて登録。
一覧上部の「AI」ボタン。
パネルの「起動」で http://localhost:9876 が起動。
タグ分類 / タイトル正規化 / 重複マージ提案 / コレクション分析。
AI チャット（Cmd + I）に貼り付け、生成された JSON をパネルで適用。
GitHub → Settings → Developer settings → Personal access tokens (classic)。スコープは repo。
公開・非公開どちらでも可。
サイドバー下部「同期」→ トークン / 所有者 / リポジトリ名 / デバイス名 → 接続テスト＆保存。
同期ボタン をクリックすると、取得 → マージ → 送信 → 結果通知が自動で行われます。
| 選択肢 | 動作 |
|---|---|
| ローカルを保持 | このデバイスの内容を残す |
| リモートを採用 | GitHub 上の内容で上書き |
| 自動マージ | タイトル・タグ・メモを統合 |
| スキップ | 今回は保留して、後でまた同期 |
| OS | 保存場所 |
|---|---|
| macOS | ~/Library/Application Support/bookmark-manager-pe/bookmarks.db |
| Windows | %APPDATA%/bookmark-manager-pe/bookmarks.db |
| Linux | ~/.config/bookmark-manager-pe/bookmarks.db |
バックアップはアプリを終了した状態で bookmarks.db をコピーするのが確実です。GitHub 同期を設定していればリポジトリ内にもデータが残るため二重に安全です。
| 症状 | 対処 |
|---|---|
| アプリが起動しない | pnpm rebuild を実行してから pnpm dev |
| 同期が「接続失敗」 | トークンの期限切れ・リポジトリ名/所有者の誤りを確認 |
| AI が応答しない | http://localhost:9876/api/health が開くか確認、AI パネルでサーバを起動 |
| 探索がすべて失敗する | Worker URL の接続テストを確認。Kitesurf の制限（beta）の可能性 |
| 重複が検出されない | 正規化後も別 URL の場合は手動で判断 |