前言¶
做資料整理、二次編輯或歸檔時，公衆號文章往往只剩一個 mp.weixin.qq.com 鏈接。手動複製正文會丟排版和圖片；只存網頁又依賴在線資源和微信側展示邏輯。下面介紹 SkillHub 上的社區 Skill「微信文章格式轉換」（@user_733f3aed/wechat-article-exporter，v1.0.0），在 Agent 裏用自然語言或腳本，把單篇或多篇鏈接導出爲 Markdown、HTML、純文本、JSON、Excel，並儘量把圖片與樣式落到本地。
這是什麼¶
一句話定位：面向微信公衆號文章 URL 的抓取與多格式導出 Skill，無需配置 API Key（requires_api_key=false），無需微信登錄即可請求文章頁。
- 座標：
@user_733f3aed/wechat-article-exporter - 來源：SkillHub 社區（
community），分類爲data-analysis - 發佈者：
user_733f3aed；SkillHub 技能頁標註作者爲羅江勇 - 官方入口：SkillHub 技能頁、API 座標
Skill 內置 SKILL.md 與 Python 腳本，供 Cursor、Claude Code、Codex 等支持 Skills 的客戶端調用。
核心功能¶
以下能力均來自官方 SKILL.md 與安裝包內腳本說明，已覈對一致。
-
五種導出格式
- Markdown（.md）：含標題、作者、日期、來源鏈接
- Excel（.xlsx）：表格形式，含元信息與正文（行高約 300px）
- HTML（.html）：獨立網頁，CSS 與圖片本地化，可直接用瀏覽器打開
- 純文本（.txt）：無格式正文
- JSON（.json）：結構化數據與完整元數據 -
抓取方式
- 直接請求mp.weixin.qq.com，使用 Chrome 風格 User-Agent，且 Referer 須帶該域名
- 圖片優先讀data-src（懶加載），並同步到src；空img佔位會清理 -
HTML 離線包結構（效果最好的閱讀格式）
- 目錄示例：文章標題_文章ID/index.html+assets/（CSS、圖片）
- 資源 URL 替換爲本地相對路徑；按內容 hash 去重
- CSS 總量 ≤ 500KB 時內聯到<style>，更大則走assets/的<link>
- 會處理#js_content的visibility:hidden，避免空白頁 -
單篇與批量
- 單篇默認保存到~/Desktop/文章標題_文章ID/
- 批量默認保存到~/Desktop/微信文章批量/ -
Agent 側交互規則
- 觸發：用戶發送https://mp.weixin.qq.com/s/xxx、多鏈接，或「幫我轉這篇文章」「保存這篇微信文章」等
- 每次導出前必須先詢問格式（支持序號1–5或名稱，可多選，如1,3,5） -
已知限制（官方寫明）
- 閱讀量、點贊、評論等需登錄態接口，純抓取拿不到
- 已刪除或違規文章可能失敗
安裝與啓用¶
1、安裝 SkillHub CLI（若尚未安裝）¶
command -v skillhub && skillhub --version
未安裝時，可按 SkillHub 安裝文檔 執行完整安裝：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安裝本 Skill¶
安裝時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 可能不會被識別；安裝後通常需重啓客戶端。
Cursor：
skillhub install wechat-article-exporter --namespace user_733f3aed --dir ~/.cursor/skills/
Claude Code：
skillhub install wechat-article-exporter --namespace user_733f3aed --dir ~/.claude/skills/
Codex：
skillhub install wechat-article-exporter --namespace user_733f3aed --dir ~/.codex/skills/
也可把下面提示詞發給 AI，讓其按官方流程安裝：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_733f3aed/wechat-article-exporter`。
3、腳本依賴¶
SKILL.md 要求安裝 html5lib（純 Python）。核心腳本 fetch_article.py 還使用 beautifulsoup4 解析頁面，運行前建議：
pip install html5lib beautifulsoup4
導出 Excel 時腳本會調用表格相關庫（按你本機 Python 環境補齊缺失依賴即可）。
典型用法¶
在 Agent 對話中使用¶
- 發送一篇或多篇微信文章鏈接。
- 按 Skill 要求選擇格式（示例：
markdown,html或1,3）。 - Agent 調用安裝目錄下的腳本，完成後彙報文件名與大小。
命令行直接調用腳本¶
安裝後腳本位於（以 Cursor 爲例）：
~/.cursor/skills/@user_733f3aed/wechat-article-exporter/scripts/
單篇、單格式：
python ~/.cursor/skills/@user_733f3aed/wechat-article-exporter/scripts/fetch_article.py \
"https://mp.weixin.qq.com/s/xxxxxxxx" markdown
format 可選：markdown | html | text | json | excel。第三個參數可指定 output_dir。
批量、多格式：
先把鏈接寫入文本文件（每行一個 URL），再執行：
python ~/.cursor/skills/@user_733f3aed/wechat-article-exporter/scripts/batch_fetch.py \
/path/to/urls.txt markdown,html,json
formats_csv 省略時默認 markdown。
適用場景與注意¶
適合誰
- 需要把公衆號文章歸檔到本地知識庫（Obsidian、Git、網盤）的編輯與開發者
- 要做摘抄、比對、結構化分析，希望一次導出 JSON / Excel / Markdown
- 需要離線保留版式和圖片，優先選 HTML 導出
使用注意
- 遵守微信平臺與著作權規定，僅抓取你有權保存的內容
- 抓取成功率受文章狀態與網絡影響；批量場景以腳本彙報的成功/失敗數爲準
- SkillHub 頁面上該 Skill 評分 100000（平臺展示值），截至資料抓取時下載約 1835、安裝約 34，選用前可在技能頁查看最新數據
結尾¶
「微信文章格式轉換」把公衆號鏈接變成可長期保存的五種文件，並強調 HTML 場景下的資源本地化。若你已在用 SkillHub 管理 Agent 能力，可按上文命令裝入對應 skills 目錄，用鏈接或腳本完成單篇與批量導出。技能頁：https://www.skillhub.cn/skills/user_733f3aed/wechat-article-exporter。
