md2wechat-skill

왜 쓰나요

핵심 기능

Two modes: fast API conversion (themed) or AI-driven custom styling
Automatic handling of headings, lists, code blocks, tables
Image processing + upload to WeChat's media library
Cover image generation or integration
Draft creation posted straight into the 公众号 backend

라이브 데모

실제 사용 모습

md2wechat-skill.replay ▶ 준비됨

0/0

설치

작성자 저장소 · Claude Skills 공식 문서

사용 사례

실전 활용법: md2wechat-skill

Turn a Markdown draft into a WeChat Official Account draft in one step

👤 运营 / 公众号 editors who prefer writing in Markdown ⏱ ~5 min beginner

언제 쓸까: You draft in Obsidian/VSCode and dread the manual formatting in the WeChat editor.

사전 조건

md2wechat.cn API key — Sign up at md2wechat.cn — free tier available
WeChat Official Account API credentials — Register your 公众号 and get AppID/AppSecret

흐름

Convert via API mode

Use md2wechat-skill. Take this draft at article.md, convert with the 'modern' theme, and push to WeChat drafts.✓ 복사됨

→ Themed HTML + draft URL in the WeChat backend
Review in WeChat editor

(manual step — open the draft)✓ 복사됨

→ Preview matches intent

결과: A publish-ready WeChat draft in seconds instead of 20 minutes of copy-paste.

함정

Images in your Markdown are local paths — Skill uploads local images to WeChat's media library — they must be accessible to the runner

함께 쓰기: filesystem

Use AI mode for a visually distinctive long-form essay

👤 Creators who want more than a template theme ⏱ ~15 min intermediate

언제 쓸까: The piece warrants custom pull-quotes, callouts, or visual hierarchy.

흐름

Request AI mode

Use md2wechat-skill in AI mode. Style this essay with warm typography and pull-quotes.✓ 복사됨

→ Claude produces richer HTML styling than a preset theme
Upload to drafts

Now push to the 公众号 draft backend.✓ 복사됨

→ Draft ID returned

결과: A visually distinct article that stands out in the feed.

함정

Over-styling hurts mobile readability — Preview on mobile before publishing — WeChat users are 95%+ mobile

함께 쓰기: claude-blog-skill

조합

다른 MCP와 조합해 10배 효율

md2wechat-skill + claude-blog-skill

claude-blog writes the article, md2wechat-skill publishes it to WeChat

Use /blog write for a new post, then md2wechat-skill to push to the 公众号 drafts.✓ 복사됨

md2wechat-skill + filesystem

Read drafts from a local vault of markdown files

For every .md in ~/wechat-drafts ready to ship, convert and push.✓ 복사됨

md2wechat-skill + nano-banana-pro-prompts-recommend-skill

Recommend a cover image prompt, generate externally, then upload via this skill

Pick a cover prompt from nano-banana, then publish the draft with the resulting image.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
API conversion (themed)	markdown + theme name	Fast themed output	md2wechat.cn credits
AI styling mode	markdown + style brief	Custom look beyond presets	LLM tokens only
Image upload	image paths / URLs	Before draft creation if images present	0 (WeChat API)
Draft creation	HTML + metadata + media IDs	Final step	0
Cover image generation	article or custom brief	No cover supplied	Depends on generator

비용 및 제한

운영 비용

API 쿼터: md2wechat.cn has free + paid tiers; WeChat API has its own quotas
호출당 토큰: Low for API mode, medium for AI mode
금액: Mostly free; paid only if you exceed md2wechat.cn's free tier
팁: Use API mode for routine posts; save AI mode for showpieces.

보안

권한, 시크릿, 파급범위

자격 증명 저장: md2wechat.cn API key + WeChat AppID/AppSecret in env vars. Never commit.

데이터 외부 송신: To md2wechat.cn and WeChat's official API endpoints

Your draft content transits md2wechat.cn — don't send confidential material through API mode.

문제 해결

자주 발생하는 오류와 해결

40001 invalid credential (WeChat)

AppSecret wrong or access_token expired. The skill should refresh; if not, rotate secret.

Images don't render in WeChat

WeChat blocks cross-domain images — make sure all images are uploaded via the media API.

Conversion API returns 401

md2wechat.cn key missing or exhausted — check dashboard.

대안

md2wechat-skill 다른 것과 비교

대안	언제 쓰나	단점/장점
Manual copy-paste into WeChat editor	Infrequent posts	Slow but zero setup
Mdnice / Mdx editor	You want a web UI rather than AI automation	Manual flow, no draft API push