TweetMark Skill:将推特收藏夹变成本地可检索知识库
TweetMark Skill:将你的推特收藏夹变成本地可检索知识库
功能与原则
TweetMark 是一个 Claude Code / Codex 智能体技能(Agent Skill),通过自然语言指令让 AI 自动将你保存的所有 X(原 Twitter)收藏夹抓取下来,转化为本地纯 Markdown 文件,并生成一个快速可搜索的网页界面。核心设计原则:零登录、零 API Key、全程本地化,利用你已登录 Chrome 的会话完成认证,不上传任何数据到云端。
认可度
截至 2026-08-10,TweetMark 属于新晋小众工具类仓库,尚无公开的大规模 star 统计,但自 2026 年 6 月上线以来在 Claude Code / Codex 玩家圈中讨论度持续上升,被多位社媒 AI 博主推荐为”个人知识管理 + AI Agent 结合”的典型案例。GitHub 页面显示最近有活跃提交记录。
链接
GitHub:https://github.com/harrrshall/tweetmark
原作者
GitHub 用户 harrrshall,专注于 AI Agent 工具与本地优先(local-first)工作流开发,目前主力项目即为 TweetMark。
介绍
很多人有一个习惯:在刷 X(Twitter)时看到有价值的内容就点收藏,但收藏之后几乎不会再翻出来看——时间一长,收藏夹变成了”数字垃圾堆”。
TweetMark 解决的就是这个问题。它不是一个网页爬虫,而是一个给 AI Agent 的技能包。用户只需在 Claude Code 或 Codex 里粘贴一行指令,AI 就会自动完成以下全部工作:
- 克隆 TweetMark 仓库,进入正确目录
- 打开你浏览器中已登录的 X 收藏夹页面,抓取所有收藏推文
- 运行完整的处理管道:collect → ingest → enrich → build_kb → index
- 在本地生成一个 kb.html 文件——这就是你的推特收藏知识库界面
整个过程你不需要配置任何 API、不需要登录、不需要手动操作。AI 通过复用你已有的 Chrome 会话完成认证,全程在本地磁盘读写,无任何数据上传。
特点
- 零门槛安装:只需在 Claude Code/Codex 里粘贴一条指令,AI 自动完成克隆、配置、运行全部流程
- 隐私优先:所有数据存在本地磁盘,不上传云端;无需提供任何 API Key 或密码
- 自然语言查询:用普通英语提问,如”我收藏过哪些关于 RLHF 的推文”,AI 返回带原始链接引用的答案
- 低成本运行:分类、标注、摘要等昂贵操作只在首次导入时执行一次并缓存,后续每次查询仅消耗约 1.5k–3.5k token(无论收藏 100 条还是 10,000 条)
- 命令行工具:也提供独立的 tweetmark 命令行工具,支持
import(抓取+建库)、sync(增量同步新收藏)、open(重新打开知识库界面)
使用方法
方式一:一行指令搞定全部(推荐)
在 Claude Code 或 Codex 任意文件夹中,粘贴以下完整指令块:
Clone and run the TweetMark skill from https://github.com/harrrshall/tweetmark, then
show me the UI with all of my X/Twitter bookmarks on screen. Do the whole thing end to
end. Never ask me to log in, and never ask me for any API keys.
AI 会自动完成:仓库克隆 → 读取 SKILL.md → 驱动浏览器抓取收藏夹 → 运行完整管道 → 打开 kb.html 界面。
方式二:使用 tweetmark 命令行工具
git clone https://github.com/harrrshall/tweetmark
cd tweetmark
./tweetmark import # 抓取收藏夹 → 建立知识库 → 打开 UI
./tweetmark sync # 增量同步新收藏
./tweetmark open # 重新打开知识库界面
依赖条件:本地已安装 Google Chrome 并在普通配置文件中保持登录 X.com。
使用场景与人群
适用场景:
– 将分散的推特收藏转化为结构化、可检索的个人知识库
– 在 AI 学习研究中,快速回顾收藏过的相关技术推文(LLM、RLHF、Agent 进展等)
– 内容创作者整理行业资讯素材
– 任何人希望把”收藏了但不会看”变成”随时能查到我到底收藏了什么”
目标用户:
– 深度使用 X/Twitter 的 AI 研究者、开发者、内容创作者
– 重视数据隐私、不希望将社交数据授权给第三方服务的用户
– Claude Code / Codex 重度用户,希望扩展 Agent 能力边界
输入与输出案例
案例一:自然语言知识查询
输入(向已建好的知识库提问):
“What did I save about RLHF reward models?”
输出(AI 基于本地收藏数据回答):
“Based on your bookmarks, you saved 3 tweets about RLHF reward models. [Tweet by @someuser] discusses… [Tweet by @another] covers… Here’s the original link: https://x.com/i/status/…”
案例二:增量同步
用户在 X 上新增了 20 条收藏后,在 Claude Code 里运行 ./tweetmark sync,AI 自动打开浏览器抓取新收藏,更新本地索引,用户再次提问时即可涵盖最新内容。
TweetMark 的核心价值在于它展示了一种”AI Agent + 本地数据”结合的范式:不是把所有数据交给 AI 服务商,而是在本地建立 AI 可读的索引,让 AI 帮你检索和组织你已经拥有的数据。如果你有大量推特收藏,这可能是让它们从”沉睡”到”活用”的最简方案。
评论区
登录后可评论。