本工具提供浏览器控制台脚本和 Node.js/Puppeteer 模块,用于管理 X/Twitter 书签。
用途与脚本选择:在 x.com/i/bookmarks 页面运行。导出完整书签使用 scripts/scrapeBookmarks.js;按分类整理使用 src/bookmarkOrganizer.js;清空全部书签使用 src/clearAllBookmarks.js;通过程序化管理使用 src/bookmarkManager.js(Puppeteer)。
主要能力:scrapeBookmarks.js 会滚动书签页并导出帖子的完整元数据,包括 tweetId、作者、文本、链接、时间、点赞、转推、回复、浏览量、图片、视频、外链、话题标签和提及,可输出 JSON、CSV 或两者。可配置 MAX_BOOKMARKS(默认 2000)、FORMAT、INCLUDE_MEDIA_URLS、INCLUDE_LINKS。
bookmarkOrganizer.js 按关键词匹配自动分类(默认类别:Tech、News、Crypto、Funny、Business),未匹配归入 Uncategorized,支持 JSON 和 CSV 导出,并在控制台打印分类统计。
clearAllBookmarks.js 优先尝试内置“Clear All”按钮,否则逐条滚动点击删除;支持 keepKeywords 保护含特定词的书签、dryRun 预览、exportOnComplete 导出删除日志,并可通过 window.XActions.pause() / .resume() / .abort() 控制。
bookmarkManager.js 提供 getBookmarks(page, { limit, format })、createFolder(page, folderName)(需 Premium)、clearAllBookmarks(page) 等函数。
使用方式:对于控制台脚本,导航至 x.com/i/bookmarks,打开 DevTools(F12)→ Console,粘贴脚本后回车,完成后自动下载。Puppeteer 模块需在 Node.js 环境中调用。
限制与注意:清空操作不可逆,建议先用 scrapeBookmarks.js 导出;书签文件夹功能需要 Premium 订阅;脚本内置约 1.5 秒滚动延迟、0.8–2.2 秒删除间隔,并通过 toast 检测限流,触发后冷却约 60 秒;若未找到书签,需确认当前位于 x.com/i/bookmarks 而非 /i/lists。