File to WeChat

File to WeChat

将任意格式的文件（PDF、Word、Excel、PPT、图片、音频、网页等）一站式转换为精美的微信公众号文章，并发布到草稿箱。

User-Facing Promise

Accept requests like:

• "把这个 PDF 发到我的微信公众号"
• "帮我把这个 PPT 转成公众号文章"
• "把这个 Excel 报表发布到微信"
• "把这张图片变成微信文章"
• "把这段音频转成公众号文章"
• "把这个网页内容发到我的公众号"

Return a published draft in the WeChat draft box, not a proposal.

How It Differs from anything-to-wechat

Use this skill when the user provides a file type that anything-to-wechat doesn't handle natively (PPTX, XLSX, images, audio, EPUB, ZIP).

First-Time Setup

1. Install Python Dependencies

python -m pip install markitdown markdown beautifulsoup4 requests

2. Install Companion Skill

This skill uses publish_to_wechat.py from the anything-to-wechat skill. Install it from ClawHub:

clawhub install anything-to-wechat

3. Configure WeChat Credentials

You need a WeChat Official Account (服务号 or 订阅号 with API access).

Get your credentials:

1. Log in to https://mp.weixin.qq.com/
2. Go to: 设置与开发 → 基本配置
3. Copy your AppID and reset/view AppSecret
4. Add your server's public IP to the IP白名单

Set environment variables (recommended):

On macOS / Linux — add to ~/.bashrc or ~/.zshrc:

export WECHAT_APP_ID="your_appid_here"
export WECHAT_APP_SECRET="your_appsecret_here"

On Windows — use PowerShell:

[Environment]::SetEnvironmentVariable("WECHAT_APP_ID", "your_appid_here", "User")
[Environment]::SetEnvironmentVariable("WECHAT_APP_SECRET", "your_appsecret_here", "User")

No environment variables? The publish script will prompt you interactively on first run — just paste your AppID and AppSecret when asked.

4. Verify Setup

python -c "from markitdown import MarkItDown; print('markitdown OK')"
python -c "import markdown; print('markdown OK')"

Prerequisites

Workflow

Phase 1: Collect Input

If the user has NOT provided a source file, ask using AskUserQuestion:

Question: "请提供你想发布到微信公众号的文件"
Options:
  - "提供文件路径" (PDF, DOCX, PPTX, XLSX, images, audio, etc.)
  - "粘贴 URL" (web page or YouTube video)
  - "选择文件夹" (batch convert)

If the user already provided a file path or URL, skip and proceed.

Phase 2: Convert File to Markdown

IMPORTANT: Always use UTF-8 encoding. On Windows, the console defaults to GBK which will garble Chinese text. Use Python with explicit encoding='utf-8' for all file I/O and sys.stdout.reconfigure(encoding='utf-8') for console output.

Primary: markitdown pip package (free, no API key, always available)

python -c "
import sys; sys.stdout.reconfigure(encoding='utf-8')
from markitdown import MarkItDown
md = MarkItDown()
result = md.convert(r'')
with open(r'/article.md', 'w', encoding='utf-8') as f:
    f.write(result.text_content)
print('Done, length:', len(result.text_content))
"

Alternative: all-to-markdown skill (if installed)

bash "/scripts/run.sh" "" -o "/article.md"

Fallback: markdown-anything (cloud API, requires MDA_API_TOKEN)

MDA_API_TOKEN="" bash "/scripts/convert.sh" "" > "/article.md"

After conversion: Read the Markdown output with encoding='utf-8'. Inspect the structure (headings, tables, images, code blocks). Use this to inform the HTML generation style.

Phase 3: Generate WeChat-Compatible HTML

Two approaches, pick based on content:

Approach A: Use md_to_wechat_html.py (quick, for structured documents) — PREFERRED

python "/scripts/md_to_wechat_html.py" \
  --input "/article.md" \
  --output "/wechat_article.html" \
  --title ""

This script converts Markdown directly to WeChat-ready inline-style HTML with Clockless design tokens. No additional CSS inlining step needed.

Approach B: Use html-anything (richer design, for complex content)

1. Load the html-anything skill.
2. Feed it the Markdown content as the source.
3. Follow html-anything workflow with WeChat compatibility rules (inline styles, light background, no CSS vars, max-width 680px, system fonts).
4. Then run anything-to-wechat's convert script:

python "/scripts/convert_for_wechat.py" \
  --input "/wechat_article.html" \
  --output "/wechat_article_final.html"

Decision guide:

• PPTX, XLSX, data-heavy → Approach A (structured, table-friendly)
• Long essays, research papers, narrative → Approach B (richer design)
• Images, audio transcripts → Approach A (simpler layout)

Phase 4: Generate Cover Image

Use the ImageGen tool with a prompt derived from the article's topic and content.

• Save as wechat_cover.png in the workspace.
• Size: 1024x768 (WeChat cover ratio 4:3).
• Make it visually compelling.

Phase 5: Publish to WeChat Draft Box

IMPORTANT: On Windows, use Python subprocess to pass environment variables. The set VAR=val && python ... pattern does NOT work reliably on Windows CMD.

Cross-platform approach (recommended):

python -c "
import os, subprocess, sys
os.environ['WECHAT_APP_ID'] = ''
os.environ['WECHAT_APP_SECRET'] = ''
result = subprocess.run([
    sys.executable,
    r'/scripts/publish_to_wechat.py',
    '--file', r'/wechat_article.html',
    '--title', '',
    '--cover', r'/wechat_cover.png',
    '--digest', ''
], capture_output=True, text=True, encoding='utf-8')
print(result.stdout)
print(result.stderr)
"

Or with environment variables already set:

python "/scripts/publish_to_wechat.py" \
  --file "/wechat_article.html" \
  --title "" \
  --cover "/wechat_cover.png" \
  --digest ""

Credentials: The publish_to_wechat.py script reads from WECHAT_APP_ID / WECHAT_APP_SECRET env vars. If not set, it will prompt interactively — the user just needs to paste their AppID and AppSecret.

Phase 6: Confirm & Handoff

Report success with Media ID and link to https://mp.weixin.qq.com/.

Tell the user: "文章已发送到你的微信公众号草稿箱，请登录微信公众平台审核后一键发布。"

WeChat HTML Compatibility

Same rules as anything-to-wechat:

• Inline styles only (no `` tags)
• Light background (#ffffff)
• No CSS variables
• No position: fixed/sticky
• System fonts
• max-width: 680px
• Under 2MB total

Error Handling

Supported Input Formats

Script Reference

Configuration