Clipper

Unified web content clipper for Obsidian. One entry point, auto-detects platform, uses optimal method.

Usage

When user provides a URL and wants to save it:

python3 {{SKILL_DIR}}/scripts/clip.py "\x3Curl>"

Output:

• Twitter: \x3Cvault>/clippings/tweet/YYYY-MM-DD-\x3Chandle>-\x3Cid>.md
• Other: \x3Cvault>/clippings/web/\x3Cdomain>/YYYY-MM-DD-\x3Cslug>.md

Platform Routing

Workflows

Twitter / General Web (Auto)

python3 {{SKILL_DIR}}/scripts/clip.py "https://x.com/user/status/123"

One command, done.

WeChat MP (Two-step)

WeChat articles need browser rendering. The script will return needs_browser: true.

Step 1: Open in browser

browser action=open profile=openclaw targetUrl=\x3Curl>

Step 2: Get snapshot

browser action=snapshot profile=openclaw targetId=\x3CtargetId>

Step 3: Extract content and save

python3 {{SKILL_DIR}}/scripts/wechat.py \
  --url "\x3Curl>" \
  --title "\x3Ctitle>" \
  --author "\x3Cauthor>" \
  --date "\x3Cdate>" \
  --content "\x3Cmarkdown>"

Or pipe content via stdin:

echo "\x3Cmarkdown>" | python3 {{SKILL_DIR}}/scripts/wechat.py \
  --url "\x3Curl>" \
  --title "\x3Ctitle>"

Supported URL Formats

Twitter:

• https://twitter.com/\x3Chandle>/status/\x3Cid>
• https://x.com/\x3Chandle>/status/\x3Cid>

WeChat:

• https://mp.weixin.qq.com/s/\x3Cid>

Others:

• Any valid HTTP/HTTPS URL

Requirements

• obsidian-cli (for vault detection) OR manually configured vault path
• x-reader for general web: pipx install 'git+https://github.com/runesleo/x-reader.git'

Example

User: https://x.com/naval/status/1234567890 save this
You: [runs clip.py] → Saved to clippings/tweet/2026-03-18-naval-1234567890.md

User: https://mp.weixin.qq.com/s/abc123 保存这个
You: [runs clip.py] → needs_browser: true
    [opens browser, gets snapshot]
    [extracts content, runs wechat.py]
    → Saved to clippings/web/mp_weixin_qq_com/2026-03-18-article-title.md

Git Sync

All saves trigger automatic git sync: pull --rebase → add → commit → push

Git warnings (non-fatal) are returned in git_warnings array.