MCPInstall

wechat-draft-publisher

by bnd-1Frontend & Design

自动将 HTML 文章发布到微信公众号草稿箱，支持封面图上传、标题、作者和元数据管理。当用户说"推送到微信"、"发布到公众号草稿"、"上传到草稿箱"或提到微信文章发布时使用。

Installs
46
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/bnd-1/wechat_article_skills --skill wechat-draft-publisher
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads wechat-draft-publisher automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

微信公众号草稿发布器

自动将 HTML 格式的文章发布到微信公众号草稿箱，支持封面图上传、标题、作者和摘要等元数据管理。

⚡ 快速开始

最简单的用法：

python publisher.py --title "文章标题" --content article.html

完整参数：

python publisher.py \
  --title "标题" \
  --content article.html \
  --author "作者名" \
  --cover cover.png \
  --digest "文章摘要"

默认值：

  • 作者：YanG
  • 封面图：cover.png

📋 执行步骤

发布文章到微信草稿箱的完整流程：

  1. 查找 HTML 文件

    • 优先查找 *_formatted.html（formatter 输出）
    • 回退到最新的 .html 文件

  2. 提取文章标题

    • 从 HTML 注释提取：<!-- Title: xxx -->
    • 从文件名提取
    • 询问用户

  3. 检查封面图

    • 查找 cover.png
    • 如缺失则警告但继续发布

  4. 调用发布脚本

    python publisher.py --title "xxx" --content xxx.html --cover xxx.png

  5. 验证结果

    • 确认草稿创建成功
    • 获取草稿 media_id

  6. 提示用户

    • 提供微信后台链接
    • 说明下一步操作

🔧 配置要求

首次使用

工具会在首次运行时引导配置：

  1. 获取微信公众号凭证

  2. 运行发布器

    python publisher.py --title "测试" --content test.html

  3. 添加服务器 IP 到白名单（如需要）

配置文件

位置： ~/.wechat-publisher/config.json

格式：

{
  "appid": "wx1234567890abcdef",
  "appsecret": "your_secret_here"
}

✨ 核心功能

  • ✅ access_token 自动缓存（有效期 7200 秒）
  • ✅ 封面图上传和管理
  • ✅ HTML 内容自动优化（适配微信）
  • ✅ 字段长度自动截断（标题/作者/摘要）
  • ✅ 错误处理和重试机制
  • ✅ 中文错误提示和解决方案
  • ✅ 交互模式和命令行模式

🛠️ 工作流集成

与其他 skill 协同工作：

完整工作流：

  1. wechat-tech-writer → 生成文章（xxx_article.md + cover.png）
  2. wechat-article-formatter → 格式化 HTML（xxx_formatted.html）
  3. wechat-draft-publisher → 发布到微信草稿箱（本 skill）

自动检测机制：

  • 自动查找 *_formatted.html 文件
  • 自动查找 cover.png 封面图
  • 自动识别内容图片

🚨 常见问题

错误：IP 不在白名单

症状： invalid ip not in whitelist 解决：

  1. 登录微信公众号后台
  2. 进入 设置 → 基本配置
  3. 添加服务器 IP 到白名单

错误：AppSecret 错误

症状： AppSecret error 解决：

  • 检查配置文件：~/.wechat-publisher/config.json
  • 验证 AppID 以 "wx" 开头（18 个字符）
  • 确认 AppSecret 正确

错误：标题/作者超出限制

症状： title/author size out of limit 解决：

  • 工具会自动截断（标题：32 字节，作者：20 字节）
  • 如需调整，修改 publisher.py

📁 文件结构

wechat-draft-publisher/
├── SKILL.md                # 本文件
├── publisher.py            # 核心发布脚本
├── scripts/                # 工具脚本
│   ├── fix-wechat-style.py # HTML 优化器
│   ├── optimize-html.py    # HTML 压缩工具
│   ├── publish-workflow.sh # 完整工作流
│   ├── install.sh          # 安装助手
│   └── test.sh             # 测试脚本
├── examples/               # 示例文件
│   ├── config.json.example # 配置示例
│   └── example.html        # HTML 示例
└── README.md               # 详细英文文档

💡 使用示例

示例 1：标准发布

python publisher.py \
  --title "VSCode 更名事件" \
  --content article.html

示例 2：完整元数据

python publisher.py \
  --title "技术文章" \
  --content article.html \
  --author "YanG" \
  --cover images/cover.png \
  --digest "这是一篇关于..."

示例 3：交互模式

python publisher.py --interactive

📱 发布后操作

发布成功后：

  1. 登录微信公众号后台
  2. 进入"草稿箱"
  3. 预览效果
  4. 确认后发布

注意事项：

  • ⚠️ 草稿保存在微信后台，不会立即发布
  • ⚠️ 可以在草稿箱中编辑后再发布
  • ⚠️ 封面图会在预览时显示

🔗 相关文档

  • 详细文档： README.md（英文）
  • 安装指南： scripts/install.sh
  • HTML 处理： scripts/fix-wechat-style.py

FAQ

What does the wechat-draft-publisher skill do?

自动将 HTML 文章发布到微信公众号草稿箱，支持封面图上传、标题、作者和元数据管理。当用户说"推送到微信"、"发布到公众号草稿"、"上传到草稿箱"或提到微信文章发布时使用。

How do I install wechat-draft-publisher?

Run npx skills add https://github.com/bnd-1/wechat_article_skills --skill wechat-draft-publisher in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/wechat-draft-publisher/ (personal) or .claude/skills/wechat-draft-publisher/ (project).

Which AI agents can use wechat-draft-publisher?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is wechat-draft-publisher safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains wechat-draft-publisher?

It is published by bnd-1 in bnd-1/wechat_article_skills. It has 46 recorded installs.

More from bnd-1/wechat_article_skills

View all →

wechat-article-formatter

bnd-1/wechat_article_skills

将Markdown文章转换为美化的HTML格式，适配微信公众号发布。应用专业CSS样式、代码高亮、优化排版。当用户说"美化这篇文章"、"转换为HTML"、"优化公众号格式"、"生成公众号HTML"时使用。

Docs & Writing70 installs

wechat-product-manager-writer

bnd-1/wechat_article_skills

从 AI 产品经理视角撰写微信公众号文章。涵盖 AI 产品拆解、场景解决方案、效率提升实战、产品方法论、行业观察。当用户说"写一篇关于XXX的文章"、"分析一下XXX产品"、"聊聊XXX"时使用。

Docs & Writing68 installs

wechat-tech-writer

bnd-1/wechat_article_skills

自动搜索、抓取、改写技术内容，生成适合微信公众号的中文科普文章。涵盖AI大模型、GitHub开源工具、技术话题。当用户说"写一篇关于XXX的文章"、"帮我研究XXX"、"生成公众号文章"时使用。

Docs & Writing42 installs

Popular frontend & design skills

View category →

setup-matt-pocock-skills

mattpocock/skills

Configure this repo for the engineering skills: set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.

Frontend & Design1.1M installs

frontend-design

anthropics/skills

Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.

OfficialFrontend & Design1M installs

hyperframes-animation

heygen-com/hyperframes

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

Frontend & Design1M installs

prototype

mattpocock/skills

Build a throwaway prototype to answer a design question. Use when the user wants to sanity-check whether a state model or logic feels right, or explore what a UI should look like.

Frontend & Design999.2K installs

hyperframes-core

heygen-com/hyperframes

The HyperFrames composition contract — build one renderable project. Use for composition structure, the data- timing attributes, class="clip", tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Frontend & Design930.5K installs

vercel-react-best-practices

vercel-labs/agent-skills

React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.

OfficialFrontend & Design843.1K installs