X Tracker 用于同步并归档 X(Twitter)数据,覆盖关注列表、书签和个人推文,并支持内容聚合、改写与 Notion 同步。
用途与能力:同步书签、个人推文和关注者推文到本地 data/ 目录;生成每日精选(Digest),按 score = like + retweet×3 + bookmark×2 排序取 Top 20,输出 digests/{date}/digest.json;对推文进行内容改写(Rewrite),输出 rewrite.json 与 rewrite.md;分析个人推文风格,输出 data/my-style/style-profile.json;通过 X API v2 获取单条推文全文;增量推送数据到 Notion 数据库。
使用方式:首次需配置 OAuth 2.0(参考 references/oauth-setup.md),所需 scope 为 tweet.read, users.read, follows.read, bookmark.read, offline.access。初始化与登录命令:cd {SKILL_DIR} && bun scripts/auth.ts init、cd {SKILL_DIR} && bun scripts/auth.ts login。日常同步命令:bun scripts/sync-bookmarks.ts && bun scripts/fetch-my-tweets.ts && bun scripts/fetch-following-tweets.ts。每日精选:cd {SKILL_DIR} && bun scripts/analyze.ts digest [--date YYYY-MM-DD]。改写:cd {SKILL_DIR} && bun scripts/analyze.ts rewrite [--date YYYY-MM-DD] [--top 10]。风格分析:cd {SKILL_DIR} && bun scripts/analyze.ts style。单条推文:cd {SKILL_DIR} && bun scripts/fetch-tweet.ts <tweet_id>。Notion 同步:cd {SKILL_DIR} && bun scripts/notion-sync.ts <following|bookmarks|all>。
限制与注意:不要主动运行 sync-following.ts,关注列表由定时任务或用户手动同步,新增关注需用户确认后才纳入跟踪;改写时纯链接推文(is_link_only: true)需用户手动转存网页内容后再处理;配置存放于 {PROJECT_ROOT}/config.json(gitignored)。其余细节暂未提供。