sakuraoxo-clio/wechat-publisher

wechat-publisher is a tool built to work with Claude, an AI assistant, to format written articles into the specific HTML style that WeChat's official account platform accepts, then push the finished result straight into that account's draft folder. WeChat only allows a narrow subset of HTML and CSS in its posts, so most conversion tools either wrap content in one fixed template or require manual copy and paste cleanup. This project instead has Claude read a library of reusable design components, such as cover cards, numbered subheadings, quote boxes, and step cards, and hand write the layout for each specific article using those pieces, plus inline SVG diagrams for things like comparisons and timelines that render natively inside WeChat without using up the account's image upload quota. There are two ways to use it. The simple path needs no API keys or an authenticated WeChat account: you have Claude format the article into HTML using the component reference file, preview it in a browser using the included template, and then paste the result into the WeChat editor by hand. The second path is for accounts that already have official WeChat authentication and API access, it runs a script that uploads any local or remote images automatically, converts them if needed, and posts the finished draft directly into the account's draft folder through WeChat's official API, ready for a human to review and publish from the WeChat dashboard. The project also supports a simpler fallback mode that renders a Markdown file into a fixed visual theme, for when full custom layout is not needed. Setup requires copying an example environment file and filling in WeChat app credentials, and optionally an OpenAI key if you want automatic cover image generation. The README documents WeChat's strict formatting rules, such as requiring inline styles instead of CSS classes and a per image size limit, along with a table of common error messages and fixes. It is released under the MIT license.