qiaomu-markdown-proxy

install

source · Clone the upstream repo

git clone https://github.com/joeseesun/qiaomu-markdown-proxy

Claude Code · Install into ~/.claude/skills/

git clone --depth=1 https://github.com/joeseesun/qiaomu-markdown-proxy ~/.claude/skills/joeseesun-markdown-proxy-qiaomu-markdown-proxy

manifest: SKILL.md

source content

Markdown Proxy - URL to Markdown

将任意 URL 转为干净的 Markdown。支持需要登录的页面、PDF、专有平台。

URL Routing (先判断再执行)

收到 URL 后，先判断类型，不同类型走不同通道：

URL Pattern	Route To	Reason
`mp.weixin.qq.com`	`scripts/fetch_weixin.py`	公众号需 Playwright 抓取
`feishu.cn/docx/` `feishu.cn/wiki/` `larksuite.com/docx/`	`scripts/fetch_feishu.py`	需飞书 API 认证
`youtube.com` `youtu.be`	`yt-search-download` skill	YouTube 有专用工具链
`.pdf` (URL or local path)	`scripts/extract_pdf.sh`	PDF 专用提取
All other URLs	`scripts/fetch.sh`	代理级联自动 fallback

Workflow

Step 1: Route by URL Type

if URL contains "mp.weixin.qq.com":
    → python3 ~/.claude/skills/qiaomu-markdown-proxy/scripts/fetch_weixin.py "URL"
    → Done

if URL contains "feishu.cn/docx/" or "feishu.cn/wiki/" or "larksuite.com/docx/":
    → python3 ~/.claude/skills/qiaomu-markdown-proxy/scripts/fetch_feishu.py "URL"
    → Done

if URL contains "youtube.com" or "youtu.be":
    → Call yt-search-download skill
    → Done

if URL ends with ".pdf" or is local PDF path:
    if remote URL:
        → Try: curl -sL "https://r.jina.ai/{url}"
        → If fails: download + extract_pdf.sh
    if local path:
        → bash ~/.claude/skills/qiaomu-markdown-proxy/scripts/extract_pdf.sh "PATH"
    → Done

else:
    → bash ~/.claude/skills/qiaomu-markdown-proxy/scripts/fetch.sh "URL"
    → Done

Step 2: Display Content

After fetching, show to user:

Title:  {title}
Author: {author} (if available)
Source: {platform} (公众号 / 飞书文档 / 网页 / PDF)
URL:    {original_url}

Summary
{3-5 sentence summary}

Content
{full Markdown, truncated at 200 lines if long}

Step 3: Save File (Default)

Save to

~/Downloads/{title}.md

with YAML frontmatter by default.

Filename: use article title, remove special characters
Format: YAML frontmatter (title, author, date, url, source) + Markdown body
Tell user the saved path
Skip only if user says "just preview" or "don't save"

After saving and reporting the path, stop. Do not analyze, comment on, or discuss the content unless asked.

Examples

General URL

bash ~/.claude/skills/qiaomu-markdown-proxy/scripts/fetch.sh "https://example.com/article"

X/Twitter Post

bash ~/.claude/skills/qiaomu-markdown-proxy/scripts/fetch.sh "https://x.com/username/status/1234567890"

WeChat Article

python3 ~/.claude/skills/qiaomu-markdown-proxy/scripts/fetch_weixin.py "https://mp.weixin.qq.com/s/abc123"

Feishu Document

python3 ~/.claude/skills/qiaomu-markdown-proxy/scripts/fetch_feishu.py "https://xxx.feishu.cn/docx/xxxxxxxx"

PDF (Remote)

curl -sL "https://r.jina.ai/https://example.com/paper.pdf"

PDF (Local)

bash ~/.claude/skills/qiaomu-markdown-proxy/scripts/extract_pdf.sh "/path/to/paper.pdf"

With Custom Proxy

bash ~/.claude/skills/qiaomu-markdown-proxy/scripts/fetch.sh "https://example.com" "http://127.0.0.1:7890"

Notes

r.jina.ai and defuddle.md require no API key
```
fetch.sh
```
handles proxy cascade with automatic fallback
Content validation: filters error pages, requires >5 lines

WeChat script requires:

pip install playwright beautifulsoup4 lxml && playwright install chromium

Feishu script requires:
```
FEISHU_APP_ID
```
+
```
FEISHU_APP_SECRET
```
env vars
PDF extraction tries: marker-pdf → pdftotext → pypdf
For detailed method documentation, see
```
references/methods.md
```