WeChat Article → Obsidian

Save WeChat MP articles (微信公众号) as clean Markdown notes in Obsidian. No browser, no CDP, no plugins needed.

How it works

WeChat articles are server-side rendered — the full content is in the HTML, just CSS-hidden. A curl with browser UA fetches it, a Node.js script converts it to clean Markdown (with images, merged section headings, promotional tails stripped), and the result goes into the user's Obsidian vault via the obsidian CLI.

Dependencies

• - curl (pre-installed on macOS/Linux)
• Node.js >= 18
• obsidian CLI (for writing to vault — if not available, fall back to direct file write)

First-time setup

On first use, check <skill-path>/config.json. If obsidian_vault or default_path is empty, ask the user:

1. 1. "What is your Obsidian vault name?" — this is the vault name used with obsidian CLI (e.g., vault=MyVault)
2. "Where should I save WeChat articles by default?" — a path inside the vault (e.g., notes/wechat, articles/wechat)

Then write the answers to <skill-path>/config.json:

CODEBLOCK0

This only needs to happen once. After that, the skill uses the saved config automatically.

Configuration

Natural language override (per-request)

The user can override the default path anytime:

• - "把这篇文章存到 reading/tech 目录"
• "save this under articles/ai/"
• "导入到 Obsidian 的 inbox 文件夹"

Parse the target path from the user's message and use it instead of default_path.

Config file (persistent default)

INLINECODE11:

• - obsidian_vault: the vault name for obsidian CLI
• INLINECODE14: where to save articles when the user doesn't specify a path

Workflow

Single article

CODEBLOCK1

The save script automatically:

• - Reads config.json for vault name and default path
• Derives filename from the YAML frontmatter title
• Tries obsidian CLI first, falls back to direct file write if CLI is not available

Batch save (multiple URLs)

For 2+ URLs, process them sequentially. For 4+ URLs, consider using subagents in parallel (each with its own temp file).

CODEBLOCK2

Output format

The parser produces clean Markdown with YAML frontmatter:

CODEBLOCK3

The parser automatically:

• - Preserves all article images (WeChat CDN URLs)
• Removes WeChat decoration text (THUMB, STOPPING)
• Merges "PART.XX" + title into proper ## PART.XX Title headings
• Strips promotional tails (关注/点赞/在看, author bios, QR codes)
• Preserves bold, italic, code blocks, blockquotes, lists, links

Post-processing by Claude

After the parser runs, review the output and apply any remaining cleanup:

1. 1. If the user specified tags, add them to the frontmatter
2. Verify the filename is clean and descriptive
3. Confirm save location with the user if ambiguous

Troubleshooting

curl returns empty or verification page

WeChat may rate-limit. Wait 30 seconds and retry. If persistent, the article may require login — inform the user.

Empty content / no #js_content

Some special article types (mini-programs, video-only) aren't supported. Inform the user.

obsidian CLI not available

Fall back to direct file write using the Write tool to the vault's disk path.