Skip to content

SKILL.md

Latest commit

 

History

History
70 lines (49 loc) · 2.04 KB

SKILL.md

File metadata and controls

70 lines (49 loc) · 2.04 KB
Raw
name wxarticle
description Export a WeChat article to Doc/PDF/Markdown. Use when user wants to save, export, or convert a WeChat MP article.
user-invocable true
allowed-tools Bash, AskUserQuestion
argument-hint <微信文章链接>

将微信公众号文章导出为 Doc（Word）/ PDF / Markdown，保留标题、作者、正文和图片。

参数：$ARGUMENTS（微信文章 URL）

流程

1. 验证 URL

检查 $ARGUMENTS 是否包含 mp.weixin.qq.com。若为空或不合法，告知用户并要求提供正确链接。

2. 询问导出格式

使用 AskUserQuestion 询问用户：

  • Doc（Word .docx）— 方便二次编辑
  • PDF — 方便阅读和分享
  • HTML — 带样式的网页，可在浏览器中查看
  • Markdown — 轻量文本，保留原始 Markdown + 本地图片

3. 导出

执行以下命令：

cd ~/.claude/skills/wxarticle && source venv/bin/activate && python3 wxarticle_cli.py "$URL" --format <FORMAT>

其中 $URL 替换为用户提供的链接，<FORMAT> 替换为 doc、pdf、html 或 markdown。

4. 报告结果

告知用户：

  • 文章标题
  • 作者
  • 图片数量
  • 导出格式
  • 文件保存位置（~/Desktop/new-wechat-article/）

若抓取失败（未提取到标题），可能触发了验证码或网络问题，告知用户稍后重试。

前置安装

# 安装抓取工具（仅需一次，首次运行会自动下载 Camoufox 浏览器 ~300MB）
uv tool install wechat-article-to-markdown

# 创建 venv 并安装转换依赖
cd ~/.claude/skills/wxarticle
python3 -m venv venv
source venv/bin/activate
pip install python-docx reportlab Pillow beautifulsoup4 lxml markdown

注意事项

  • 不要挂 VPN 运行，微信是国内服务，VPN 会导致抓取失败或空白页
  • Camoufox 首次运行需下载浏览器 (~300MB)，之后缓存在 ~/Library/Caches/camoufox/
  • 图片在 Doc/PDF 中的位置与 Markdown 中一致
  • PDF 导出依赖系统中文字体（macOS: PingFang）
  • 不支持视频内容，仅支持文字和图片