SuperAPI AI 工具集

x-to-obsidian

通用与其它

查看项目

更新于 10-16 08:45

技能介绍

用途:把 X 上有价值的内容沉淀到 Obsidian vault,形成可检索的知识资产。解决 thread 散落、Article 排版乱、链接易失效、搜索弱等问题。

主要能力:完整 unroll thread;抓取 X Article 全量 content.blocks;记录作者、metrics、媒体直链、created_at 等元数据;生成 frontmatter 与主题双链便于 MOC 聚合;支持多语言识别(zh/en/ja/ko)。

依赖与配置:需 Obsidian vault;归档单条推文需 Python 3(纯 stdlib)。可选 pip install telethon 仅用于 MTProto 同步。环境变量:export OBSIDIAN_VAULT=~/Documents/MyVault;可选 OBSIDIAN_ARTICLES(默认 Articles)、X_ARCHIVE_LANG(默认 zh)。

核心机制:将 X URL 中的 x.com 换成 api.fxtwitter.com 直接 GET JSON,无需 X API key、登录或额外成本;失败时兜底 cdn.syndication.twimg.com 公开端点。

用法:触发词如「归档这条 X:URL」调用 archive_x.py <URL>;「归档并翻译」会在 AI 填译文段;「整理一下这条 thread」强制回溯;「同步我的电报收藏」配合 JSON 路径先 sync_telegram_export.py <path> --dry-run 再实跑;已有凭证可用 sync_telegram_saved.py。命令行示例:python3 archive_x.py <URL> --force、python3 sync_telegram_export.py <result.json> --since 2026-06-01。

Telegram 同步:推荐 JSON 导出路径(Telegram Desktop 导出私聊 JSON 得 result.json),自动按 URL 去重、跳过已归档。MTProto API 需申请 api_id/api_hash、生成 session_string,并要求住宅 IP,中国大陆用户慎用,优先方案 A。

输出:文件名形如 <YYYY-MM-DD>-X-<handle>-<title前50字>.md;同日同作者重复加 -<status_id 后6位>;frontmatter 含 tags、source、url、author、handle、时间、language、type、topics、people、media、content_complete、metrics 等字段。

限制与异常:fxtwitter 404 表示推文被删或私密;5xx 重试一次后兜底;非 x.com/twitter.com 的 URL 拒绝;无正文、无 article、无媒体的纯转推/回复会给出警告;视频仅记录 mp4 直链不内嵌。「我的看法」段留空由用户填写。未提供的信息暂未提供。