SuperAPI AI 工具集

soia-pkm-clip-x

通用与其它

查看项目

更新于 10-16 09:52

技能介绍

用途:把 X/Twitter 上的推文、thread 与 Article 长期沉淀进 Obsidian vault,形成可检索的知识资产,解决 X 原生界面不利于回看、thread 散乱、Article 排版乱、链接易失效、搜索弱等问题。

主要能力:thread 完整 unroll;X Article 取全量 content.blocks;元数据齐全(作者、metrics、媒体直链、created_at);frontmatter 主题双链便于 MOC 聚合;多语言识别(zh/en/ja/ko);非中文内容默认补全中文译文;可选把 Telegram「我的收藏」中的 X 链接批量归档。

使用方式:安装命令为 npx skills add soia-team/soia-open-skills -g -a '*' -s soia-pkm-clip-x -y。前置依赖为 Obsidian vault 与 Python 3(纯 stdlib);仅 MTProto 同步需 pip install telethon。归档命令:python3 archive_x.py <URL>,支持 --force 覆盖已归档、--vault 指定路径、--articles-dir 指定文章目录。vault 定位优先级为 --vault、OBSIDIAN_VAULT 环境变量、从当前目录向上自动发现。私有配置默认位于 ~/.config/soia-skills/soia-open-skills/soia-pkm/soia-pkm-clip-x/config.yml,也可用 SOIA_PKM_CLIP_X_CONFIG_FILE 指定。

数据来源:fxtwitter API,把 URL 中 x.com 换成 api.fxtwitter.com 直接取 JSON,无需 X API key、无需登录;失败时兜底 cdn.syndication.twimg.com 公开端点。

适用场景:归档单条推文、thread、X Article;批量同步 Telegram 收藏;需要时先归档 Markdown 再按 Obsidian 原生导出 PDF。

限制:仅支持 x.com / twitter.com URL,其他建议用 Web Clipper;fxtwitter 返回 404 表示推文被删或私密,建议查 archive.org;5xx 重试一次后走兜底端点;视频媒体仅记 mp4 直链,不内嵌;纯转推/纯回复可能无独立内容;密钥、cookie、session 只能放在私有 config.yml、进程环境或 provider 登录态,不得写入仓库、vault 正文或日志。涉及未提供的具体收费与价格信息暂未提供。