SuperAPI AI 工具集

soia-pkm-clip-x

编程与开发

查看项目

更新于 10-16 09:30

技能介绍

用途:把 X 上的推文、thread 与 Article 一键沉淀进 Obsidian vault,解决 X 原生 UI 不利于长期回看的问题(thread 分散、Article 排版乱、链接易失效、搜索弱)。

主要能力:基于 fxtwitter API(把 URL 里的 x.com 换成 api.fxtwitter.com 直接 GET JSON,无需 X API key、无需登录);thread 完整 unroll、Article 取全量 content.blocks;元数据含作者、metrics、媒体直链、created_at;frontmatter 主题双链便于 MOC 聚合;多语言识别(zh/en/ja/ko),非中文默认补## 中文译文;归档后可走 Obsidian 原生导出 PDF。

使用方式:自然语言触发,如「归档这条 X:URL」「archive this:URL」「整理一下这条 thread:URL」。安装命令:npx skills add soia-team/soia-open-pkm-clip-skills -g -a '*' -s soia-pkm-clip-x -y。归档脚本用法:python3 archive_x.py <URL>,可加 --force、--vault /path/to/vault、--articles-dir <subdir>。vault 定位优先 --vault、其次环境变量 OBSIDIAN_VAULT、再从 cwd 向上自动发现。私有配置放 ~/.config/soia-skills/soia-pkm-clip-x/config.yml,或用 SOIA_PKM_CLIP_X_CONFIG_FILE 指定。Telegram 同步分 JSON 导出与 MTProto 两条路径。

限制:依赖 Obsidian vault 与 Python 3(纯 stdlib);MTProto 同步需 pip install telethon。fxtwitter 404 表示推文被删或私密,5xx 会重试后兜底 syndication 端点;非 x.com/twitter.com 链接拒绝;纯转推/纯回复可能无独立内容;视频仅在 frontmatter 记 mp4 直链不内嵌。「我的看法」段留空给用户。PDF 优先用 Obsidian 导出,第三方引擎仅作降级。具体依赖、凭证要求与平台账号状态等以 SKILL.md 后续说明为准,资料未提供默认价格与效果数据。