name: browser-bookmarks-cleanup description: Analyze, organize, and clean browser bookmarks on macOS using on-disk bookmark and history files. Detects duplicates, stale bookmarks, tracking parameters, and folder issues. All writes are opt-in with backup and rollback.

Browser Bookmark Cleanup

Analyze first, organize, then clean up. All writes are opt-in and reversible.

Supported browsers: Chrome and Firefox out of the box. Other Chromium-based browsers (Edge, Brave, Arc, etc.) can be handled by pointing to their profile directories, which use the same Bookmarks JSON format as Chrome.

Workflow

1. Discover browser profiles.
2. Run read-only analysis and share findings.
3. Propose cleanup plan with preview.
4. Get explicit user approval before any writes.
5. Dry-run first, then write with automatic backup.
6. Report changes and how to roll back.

Hard Safety Rule

Never send network requests to bookmark URLs. Analysis uses only local files.

Commands

Discover profiles:

python3 scripts/browser_bookmarks.py discover [--browser chrome|firefox]

Analyze bookmarks:

python3 scripts/browser_bookmarks.py analyze --bookmarks "<PATH>" --output /tmp/bookmark-analysis.json

Apply plan (dry-run by default, --write to commit):

python3 scripts/browser_bookmarks.py apply-plan --bookmarks "<PATH>" --plan /tmp/bookmark-plan.json [--write]

Analysis Categories

7w4.net小蔥技能站收錄全網優質技能，值得收藏。

1. Exact and semantic duplicate URLs
2. Tracking-parameter variants (utm_*, gclid, fbclid, etc.)
3. Subdomain and domain concentration
4. HTTP links that should be HTTPS
5. Empty, singleton, deep, and oversized folders
6. Weak bookmark names
7. Old bookmarks by age
8. Never-visited and stale bookmarks (from browser history)

Approval Gate

Before any write: show plan preview, get explicit approval, ask user to close the browser.

Plan Format

See references/plan-schema.md for the JSON plan structure.

Rollback

Restore the timestamped backup file created before any write.

這個書籤清理工具質量不錯，能自動發現 Chrome 和 Firefox 瀏覽器配置檔案，分析重複、過期、追蹤引數等各類書籤問題，並生成可預覽的清理計劃，寫入前會自動備份，設計很安全。缺點是 Firefox 使用者只能分析但無法自動清理書籤，必須手動操作。整體適合有技術基礎的使用者使用，命令列引數較多對新手不太友好。