geekjourneyx/md2wechat-skill

md2wechat – AI 에이전트 친화적인 CLI for WeChat 공개 계정 기사 게시

주요 기능

• Markdown 파일을 WeChat의 공개 계정 편집기가 요구하는 정확한 HTML 레이아웃으로 변환합니다.
• JSON 기반 디스커버리 인터페이스를 통해 AI 에이전트(Claude, Codex, WorkBuddy 등)가 호출할 수 있는 일련의 CLI 명령을 제공합니다.
• 미리보기, 이미지 업로드, 표지 생성, 초안 작성, 다중 계정 관리를 처리합니다.
• 외부 LLM용 프롬프트만 생성하는 무료 AI 모드와 최종 HTML을 직접 반환하는 유료 프로페셔널 API 모드를 제공합니다.

중요한 이유

• WeChat용 글쓰기는 악명 높게 까다롭습니다. 플랫폼은 특정 HTML 구조, 고급 레이아웃용 사용자 지정 ":module" 블록, 엄격한 이미지 처리를 기대합니다. md2wechat는 전체 파이프라인을 자동화하여 개발자나 자율 에이전트가 수동 포맷팅 대신 콘텐츠 작성에 집중할 수 있게 합니다.
• 이 도구는 의도적으로 에이전트를 위해 설계되었습니다. capabilities, doctor, inspect, layout list 등을 노출하며, 모두 에이전트가 다음 단계를 결정하기 위해 파싱할 수 있는 컴팩트한 JSON을 출력합니다.

주요 기능(README에 설명된 대로)

기능	설명
Markdown → WeChat HTML	convert 명령은 최종 HTML을 생성합니다. preview는 로컬 파일을 작성합니다. inspect는 구조적 메타데이터(제목, 요약, 이미지, 준비 상태)를 반환합니다.
고급 레이아웃	83개의 권장 레이아웃 시나리오와 59개의 :::module 구문(히어로, 콜아웃, 갤러리 등)을 지원하며, 프로페셔널 API 모드에서만 파싱됩니다.
에이전트 디스커버리	capabilities, doctor, themes list, layout list 등의 명령은 CLI가 할 수 있는 작업을 기계가 읽을 수 있는 JSON 형식으로 노출합니다.
콘텐츠 생성 도우미	write, humanize, title suggest, generate_cover, generate_infographic – 모두 에이전트가 기사 부분을 생성하거나 개선하기 위해 호출할 수 있습니다.
이미지 생성	Volcengine, ModelScope, OpenAI, Gemini, MiniMax, Atlas Cloud와 같은 공급자와 통합됩니다. 프리셋 기반 표지/인포그래픽 생성과 생성 계획만 반환하는 "플랜(plan)" 모드를 지원합니다.
다중 플랫폼 초안 동기화	WeChat 외에도 동일한 워크플로우로 Zhihu, CSDN, Toutiao, Tencent Cloud Developer Community용 초안을 준비할 수 있습니다.
다중 계정 지원	비밀을 노출하지 않고 여러 WeChat 공개 계정 자격 증명을 구성할 수 있습니다.
프로페셔널 API	최종 HTML을 반환하고, 48개의 프리미엄 테마를 제공하며, 배치 또는 팀 사용을 위한 안정적인 변환을 보장하는 유료 서비스입니다.
소스 사용 가능 라이선스	개인, 학습, 비상업적 사용은 무료입니다. 상업적 사용에는 유료 라이선스가 필요합니다.

일반적인 워크플로우

1. 설치 – npm install -g @geekjourneyx/md2wechat@3.8.0(또는 Go 바이너리 사용).
2. 구성 – md2wechat config init을 실행하고 API 키 / WeChat 자격 증명을 추가합니다.
3. 검사 – md2wechat inspect article.md --json로 기사가 초안 준비가 되었는지 확인합니다.
4. 미리보기 – md2wechat preview article.md --output preview.html(무료 AI 모드는 프롬프트만 생성).
5. 변환 및 초안 – md2wechat convert article.md --draft --cover cover.jpg로 기사를 WeChat 초안 상자에 푸시합니다.
6. 에이전트 통합 – 자율 에이전트는 md2wechat capabilities --json을 호출하여 명령을 발견한 다음 더 큰 작성 파이프라인의 일부로 md2wechat generate_cover … 또는 md2wechat title suggest …를 실행할 수 있습니다.

대상 사용자

• WeChat 콘텐츠 게시를 자동화하는 도구를 구축하는 개발자.
• 뉴스레터, 제품 업데이트, 마케팅 카피를 위한 반복 가능하고 버전 관리된 파이프라인이 필요한 팀.
• 최종 HTML용 안정적인 엔드포인트가 필요한 LLM 기반 콘텐츠 생성을 실험하는 연구자.

제한 사항/메모

• 고충실도 렌더링(:::module 구문)은 유료 프로페셔널 API 서비스가 활성화된 경우에만 작동합니다.
• 이미지 생성은 외부 공급자에 의존하므로 적절한 API 키를 구성해야 합니다.
• CLI 자체는 오픈소스이지만 변환 서비스는 소스 사용 가능 라이선스의 상업용 오퍼링입니다.

링크

• 문서: docs/ 폴더(Quickstart, Usage, Layout, Agent Image Gen 등)
• 테마 갤러리: https://www.md2wechat.cn/theme-gallery
• 가격/API 키: https://www.md2wechat.cn/pricing
• 연락처/지원: WeChat 공개 계정 "极客杰尼" 또는 이메일 skrphper@gmail.com

---

위의 모든 정보는 저장소의 README에서 직접 가져온 것이며 추가 기능은 추론되지 않았습니다.