SuperAPI AI 工具集

soia-pkm-clip-x

通用与其它

查看项目

更新于 10-16 08:44

技能介绍

用途:把 X/Twitter 上的推文、thread、Article 沉淀进 Obsidian vault,形成可检索的知识资产。基于 fxtwitter API(把 x.com 换成 api.fxtwitter.com 直接 GET JSON),无需 X API key、无需登录、零成本;失败时兜底 cdn.syndication.twimg.com 公开端点。

主要能力:thread 完整 unroll;X Article 取全量 content.blocks;元数据齐全(作者、metrics、媒体直链、created_at);frontmatter 主题双链便于 MOC 聚合;多语言识别(zh/en/ja/ko);非中文内容默认补完整中文译文;正文 t.co 短链优先用 facet replacement 展开为 canonical 链接。

使用方式:安装推荐 claude plugin marketplace add soia-team/soia-open-skills 与 claude plugin install soia-pkm-vault@soia;单技能可用 npx skills add soia-team/soia-open-pkm-vault-skills -g -a '*' -s soia-pkm-clip-x -y。归档命令:python3 archive_x.py <URL>,可选 --force、--vault、--articles-dir。vault 定位优先级为 --vault、OBSIDIAN_VAULT、从 cwd 向上自动发现;文章目录优先级为 --articles-dir、OBSIDIAN_ARTICLES、默认 Articles。私有配置放 ~/.config/soia-skills/soia-pkm-clip-x/config.yml,可用 SOIA_PKM_CLIP_X_CONFIG_FILE 指定。

适用场景:归档单条推文、整理 thread、导出 PDF(优先 Obsidian 原生导出)、批量同步 Telegram 收藏(JSON 导出或 MTProto)。

限制:仅支持 x.com/twitter.com URL;推文被删或私密时 fxtwitter 返回 404,建议查 archive.org;纯转推/纯回复可能无独立内容;视频仅记 mp4 直链不内嵌;PDF 深度处理交给 soia-pkm-clip-drive。依赖 Obsidian vault 与 Python 3(纯 stdlib),MTProto 同步需 pip install telethon。