SuperAPI AI 工具集

x-bookmarks-fetcher

编程与开发

查看项目

更新于 10-15 19:58

技能介绍

用途:通过官方 X API v2 获取 X(Twitter)书签,不使用爬虫或 Chrome 会话,将推文文本、元数据、图片和视频保存到本地文件夹。

主要能力:抓取书签并按时间窗口过滤;保存完整 API 响应、解析后的索引、可读摘要、每条书签的文本文件以及媒体文件(图片、最高码率 MP4、视频缩略图)。

使用方式:首次需按 SETUP.md 创建启用 OAuth 2.0 的 X 开发者应用,回调地址设为 http://127.0.0.1:8765/callback,将 client ID/secret 写入 .env,运行 npm run auth 完成一次性授权。之后进入 scripts 目录执行 node auth.mjs 授权,node fetch.mjs 抓取默认最近 48 小时书签。支持 --hours、--since、--out、--max-pages、--no-media 等选项。

适用场景:需要将 X 书签归档到本地、批量下载书签媒体或做后续处理的用户。

限制:过滤基于推文发布时间而非书签保存时间,今天收藏的旧推文会被排除;接口为 GET /2/users/:id/bookmarks,需 OAuth 2.0 用户上下文与 bookmark.read 权限;免费层可用但有速率限制(约每 15 分钟 10 次请求)。