X High Exposure to Obsidian Skill

一个本地自动化工具：输入 X/Twitter 博主链接，自动筛选最近高曝光推文，并通过官方 Obsidian Web Clipper 保存到 Obsidian。

它适合内容创作者、运营、产品经理、独立开发者做热点素材库：不用每天手动刷 X，只要给出目标账号，就能把近期被市场验证过的高浏览内容沉淀到自己的知识库。

它能帮你拿到什么

• 指定博主最近 30 天的高曝光推文
• 如果 30 天内候选不够，最多扩展到 90 天
• 默认筛选浏览量 > 90000 的内容
• 默认每个账号保存浏览量最高的 5 篇
• 自动保存到 Obsidian 的 高曝光/博主名/ 目录
• 自动记录 tweet_id、浏览量、作者、原始链接、发布时间等元数据

简单说：它帮你从 X 信息流里筛出“已经跑出来的数据热点”，然后归档成可复盘的素材库。

工作流程

输入目标 X 博主链接
      ↓
读取本机 Chrome/Dia 登录态
      ↓
抓取该博主近期推文
      ↓
按浏览量筛选高曝光内容
      ↓
按浏览量排序取 Top 5
      ↓
打开推文原页面
      ↓
触发 Obsidian Web Clipper
      ↓
保存到 Obsidian/高曝光/博主名/

前置要求

运行者需要在自己的电脑上准备：

• macOS
• Google Chrome 或 Dia
• 浏览器已登录自己的 X/Twitter 账号
• 已安装官方 Obsidian Web Clipper
• Obsidian 已打开目标 vault
• macOS 已允许 Terminal/Codex 控制 System Events、Chrome/Dia、Obsidian

这个工具不会保存你的 X 密码，也不会上传你的 Cookie。它只在本机读取浏览器登录态，用来请求你自己能访问的 X 内容。

1. 下载项目

git clone https://github.com//x-high-exposure-to-obsidian-skill.git
cd x-high-exposure-to-obsidian-skill

如果你是直接下载 ZIP，也可以解压后进入项目目录。

2. 检查环境

Chrome 用户：

python3 scripts/x_to_obsidian.py --browser chrome --setup
python3 scripts/x_to_obsidian.py --browser chrome --vault-subdir "高曝光" --preflight

Dia 用户：

python3 scripts/x_to_obsidian.py --browser dia --setup
python3 scripts/x_to_obsidian.py --browser dia --vault-subdir "高曝光" --preflight

如果 macOS 弹出权限提示，请允许 Terminal/Codex 控制浏览器、Obsidian 和 System Events。

3. 先 Dry Run

Dry run 只找候选，不写入 Obsidian：

python3 scripts/x_to_obsidian.py \
  --browser chrome \
  --accounts-text "https://x.com/levelsio" \
  --vault-subdir "高曝光"

默认规则已经内置：

最近 30 天
不够时扩展到 90 天
浏览量 > 90000
每个账号最多预览 5 篇

4. 保存到 Obsidian

保存单个账号的高曝光内容：

python3 scripts/x_to_obsidian.py \
  --browser chrome \
  --accounts-text "https://x.com/levelsio" \
  --vault-subdir "高曝光" \
  --save-required \
  --save \
  --clip-mode popup \
  --close-after-save

保存多个账号：

python3 scripts/x_to_obsidian.py \
  --browser chrome \
  --accounts-text $'https://x.com/levelsio\nhttps://x.com/paulg' \
  --vault-subdir "高曝光" \
  --save-required \
  --save \
  --clip-mode popup \
  --close-after-save

多账号运行时，每个账号默认最多保存 5 篇。

保存后的目录

Obsidian Vault/
└── 高曝光/
    ├── levelsio/
    │   ├── 推文1.md
    │   ├── 推文2.md
    │   └── 推文3.md
    └── paulg/
        ├── 推文1.md
        └── 推文2.md

常用参数

• `--b