Writing & Content markdown-to-htmlwechat-mpclipublishingcontent-automationimage-generation

md2wechat: AI-Agent CLI for WeChat Official Account Publishing

A CLI for AI agents to create and publish WeChat articles: Markdown to styled HTML, 40+ templates, AI images, batch publishing, and multi-account management.

FollowAgents review · FARS-2.1
Not recommended
47/ 100 5-point scale 2.4 / 5
1 2 3 4 5 6
1Trust12 / 29 · 2.1/5

Evidence shows: README clearly distinguishes side-effect-free inspect/preview from explicit-side-effect convert (--draft/--upload), requiring explicit user request for upload/draft side effects, demonstrating user confirmation. However, there is no systematic statement on least privilege, e.g., whether the CLI requests more permissions than needed. Data flow transparency is insufficient: it does not detail what data is sent to which external services (e.g., API service, image providers). Sensitive data handling: mentions not outputting Secret, but does not explain how credentials are stored and protected. Dependency security: go.mod lists dependencies, but no vulnerability scanning or update policy. External effects: clearly states convert side effects require explicit request, but does not explain potential impact on WeChat accounts. Rollback: no rollback mechanism or undo operation. Source attribution: README and LICENSE provide author info, but publisher is unverified.

2Reliability6 / 14 · 2.1/5

Evidence shows: README and docs describe command behavior consistently, e.g., inspect returns structured metadata, preview only writes successful conversion HTML, convert executes side effects only on explicit request, demonstrating self-consistency. However, dependency availability: relies on external API services (professional API mode) and image providers, with no availability guarantees. Failure messages: docs mention preview does not create file on failure, but no detailed error message examples or troubleshooting guide.

3Adaptability10 / 18 · 2.8/5

Evidence shows: README identifies target audience (AI agents, individual creators) and scenarios (Markdown to WeChat HTML, pre-publish checks, multi-account publishing), and provides adaptation notes for multiple agents. Capability boundaries: clear via discovery commands like capabilities, doctor, themes, layout. Trigger precision: command boundaries fixed, e.g., inspect has no side effects, convert requires explicit request. Environment fit: provides installation and configuration guides, but does not specify support for non-Linux environments.

4Convention9 / 18 · 2.5/5

Evidence shows: README provides clear information architecture including quick start, professional API, agent workflow, advanced layout, common commands, and doc links. Install notes: provides npm install and configuration guides. Naming stability: command names stable, but no version naming policy. Examples and FAQ: provides example commands and FAQ doc. Known limitations: mentions local layout validate cannot prove remote renderer deployment, but does not list all limitations. License: provides detailed Source Available License terms. Versioning/changelog: package.json has version, but no CHANGELOG content. Maintenance responsibility: provides contact and commercial licensing info, but no explicit maintenance commitment.

5Effectiveness7 / 13 · 2.7/5

Evidence shows: Output usability: convert returns final HTML, inspect returns structured metadata, suitable for agents. Marginal value: provides unique features like AI image generation, multi-account management, advanced layout. Cost-benefit: free AI mode for experimentation, professional API mode requires payment, but no pricing info, making cost-benefit hard to assess.

6Verifiability3 / 8 · 1.9/5

Evidence shows: Claim traceability: feature claims (e.g., 68 layout scenarios, 53 syntax names) are supported by docs, but no test evidence. Cross-source corroboration: no third-party verification or user feedback. Fact-inference separation: docs distinguish local validation and remote rendering validation, but do not clearly separate facts and inferences.

Evidence confidence: Low Reviewed Aug 11, 2026 Reviewed revision d656438f1e99
The upstream repository has new commits since this review. The score still applies to the reviewed revision shown and may not cover the latest changes.
Before you use it
  • Publisher identity is unverified; assess risk before use.
  • Professional API mode relies on external services; be aware of data privacy and availability.
  • License is Source Available; commercial use requires authorization; read terms carefully.
  • No rollback mechanism provided; use publishing operations with caution.
Review evidence [1][2][3][4][5][6]
See the full review method →

What does this agent do, and when should you use it?

md2wechat is a CLI designed for AI agents to create and publish articles to WeChat Official Accounts. It breaks down the publishing workflow into verifiable commands: Markdown conversion, pre-publish inspection, professional API mode (48 themes, 53 advanced layout syntaxes), AI image generation (covers, infographics), and multi-account management. Agent integrations like Claude Code, Codex, WorkBuddy, Kimi Work, Hermes Agent, and OpenClaw can invoke it reliably via JSON discovery commands (capabilities, doctor, themes, layout). The project is Source-Available licensed, free for personal use, commercial licensing required for business use, and offers an API service with a fixed egress IP option.

md2wechat reads Markdown files and converts them to WeChat HTML using the convert command, with preview and draft creation options. The inspect command outputs structured metadata, checks, and readiness information. The professional API returns final HTML, supporting 48 professional themes and :::module advanced layouts. generate_cover and generate_infographic call image providers to create cover images and infographics, or output image plans. It also provides AI content enhancement commands like title suggest, humanize, and write. Publishing workflows use --draft and --cover flags to explicitly create WeChat drafts. Multi-account management is handled via config wechat-accounts, without exposing secrets.

  1. Content creators write in Markdown and use md2wechat to convert and publish to WeChat, saving formatting time.
  2. Operations teams batch-process multiple articles using multi-account management for matrix accounts.
  3. AI agents (e.g., Claude Code) call the CLI in automated workflows for inspection, conversion, and draft creation.
  4. Design users leverage generate_cover and generate_infographic to produce covers and infographics without a designer.
  5. Users needing stable formatting use the professional API mode with 48 themes and 53 advanced layout modules.
  6. Organizations with WeChat IP whitelist requirements use the advanced API service for fixed egress IP.

What are this agent's strengths and limitations?

Pros
  • Native support for AI agent invocation with rich JSON discovery commands, reducing integration effort.
  • Professional API mode offers 48 themes and 53 advanced layout modules for strong formatting capabilities.
  • Built-in image generation for covers and infographics, with optional handoff to host agent's Image Gen.
  • Multi-account management and WeChat IP whitelist support for teams and matrix operations.
Limitations
  • Professional API mode requires applying for an API Key and relies on external services, adding cost.
  • Advanced layout modules are only parsed in API mode; free AI mode does not process :::module.
  • Commercial use requires a license, with Source-Available restrictions on redistribution.
  • WeChat credential setup is complex, involving IP whitelisting, requiring reading related docs.

How do you install or deploy this agent?

Install globally via npm: npm install -g @geekjourneyx/md2wechat. Verify with md2wechat version --json. Requires Node.js.

How do you use this agent?

Initialize config: md2wechat config init --json, then validate with md2wechat config validate --json. Convert an article: md2wechat convert article.md --output article.html (needs API Key). Inspect: md2wechat inspect article.md --json. Create draft: md2wechat convert article.md --draft --cover cover.jpg. For agents, use discovery commands: md2wechat capabilities --json, md2wechat themes list --json, md2wechat layout list --json.

How does this agent compare with similar options?

No direct alternatives are named in the source, but similar tools like markdown-nice exist; md2wechat emphasizes agent integration and API services.

FAQ

How does md2wechat integrate with agents like Claude Code?
It provides machine-readable interfaces via JSON discovery commands (capabilities, doctor, themes, layout), allowing agents to directly call the CLI for preview, conversion, and publishing.
What's the difference between professional API and free AI modes?
Free mode generates prompts for external LLMs with 3 basic themes; professional mode returns final HTML with 48 themes and advanced layouts, suitable for production.
Do I need WeChat credentials?
Yes, creating drafts and uploading images requires configuring WeChat credentials, possibly with IP whitelisting, as detailed in WECHAT-CREDENTIALS docs.
How does commercial licensing work?
Personal, educational, and non-profit use is free; commercial use, SaaS, client delivery, etc., requires obtaining a commercial license from the project.

Compare agents like this one

The same FARS review applied across the shortlist this agent qualifies for.

Related agents