Skill

markdown-proxy

markdown-proxy — a Claude Code skill from joeseesun/markdown-proxy

Features

✓[ ] [Claude Code](https://docs.anthropic.com/en/docs/claude-code) installed
✓[ ] **curl** (built-in on macOS/Linux)
✓[ ] (Optional - WeChat scraping) Python 3.8+ with playwright
✓[ ] (Optional - PDF extraction) One of:
✓[ ] (Optional - Proxy fallback) [agent-fetch](https://github.com/teng-lin/agent-fetch)
✓[ ] (Optional - Feishu docs) Environment variables `FEISHU_APP_ID` and `FEISHU_APP_SECRET`
✓"Read this article: https://example.com/post"
✓"Fetch this tweet: https://x.com/user/status/123456"
✓"Read this WeChat article: https://mp.weixin.qq.com/s/abc123"
✓"Convert this Feishu doc to Markdown: https://xxx.feishu.cn/docx/xxxxxxxx"
✓Supports new docs (docx), legacy docs (doc), and wiki pages
✓Auto-parses document blocks into Markdown format
✓Supports headings, lists, code blocks, quotes, todos, equations, images, etc.
✓Requires `FEISHU_APP_ID` and `FEISHU_APP_SECRET` environment variables
✓App needs `docx:document:readonly` permission
✓[r.jina.ai](https://r.jina.ai) — Free URL-to-Markdown proxy by Jina AI
✓[defuddle.md](https://defuddle.md) — Clean article extraction service
✓[agent-fetch](https://github.com/teng-lin/agent-fetch) — Local URL content extraction tool
✓[Playwright](https://playwright.dev/) — Browser automation for WeChat scraping
✓[Feishu Open Platform](https://open.feishu.cn/) — Feishu Document API

Installation Guide

bash

npx skills add joeseesun/qiaomu-markdown-proxy

Verify:

bash

ls ~/.claude/skills/qiaomu-markdown-proxy/SKILL.md

Usage

Just send Claude a URL:

"Read this article: https://example.com/post"

"Fetch this tweet: https://x.com/user/status/123456"

"Read this WeChat article: https://mp.weixin.qq.com/s/abc123"

"Convert this Feishu doc to Markdown: https://xxx.feishu.cn/docx/xxxxxxxx"

Proxy Priority

r.jina.ai — Most complete content, preserves image links

defuddle.md — Cleaner output with YAML frontmatter

agent-fetch — Local tool, no network proxy needed

defuddle CLI — Local CLI, good for standard web pages

Feishu/Lark Document Support

Built-in fetch_feishu.py script fetches documents via Feishu Open API and auto-converts to Markdown:

Supports new docs (docx), legacy docs (doc), and wiki pages

Auto-parses document blocks into Markdown format

Supports headings, lists, code blocks, quotes, todos, equations, images, etc.

Requires FEISHU_APP_ID and FEISHU_APP_SECRET environment variables

App needs docx:document:readonly permission

Troubleshooting

| Issue | Solution |
|-------|----------|
| WeChat scraping fails | Run playwright install chromium to install browser |
| Feishu returns permission error | Check FEISHU_APP_ID and FEISHU_APP_SECRET env vars, confirm app has document read permission |
| Feishu wiki page fails | Confirm app has wiki:wiki:readonly permission |
| r.jina.ai returns empty | Auto-falls back to defuddle.md (no action needed) |
| All proxies fail | URL may have strict auth restrictions, try npx agent-fetch |

Credits

r.jina.ai — Free URL-to-Markdown proxy by Jina AI

defuddle.md — Clean article extraction service

agent-fetch — Local URL content extraction tool

Playwright — Browser automation for WeChat scraping

Feishu Open Platform — Feishu Document API

---