/ ディレクトリ / プレイグラウンド / md2wechat-skill
● コミュニティ geekjourneyx ⚡ 即起動

md2wechat-skill

作者 geekjourneyx · geekjourneyx/md2wechat-skill

Markdownで微信公众号の記事を執筆 — Claudeがスタイリング変換、画像アップロード、下書き投稿までを自動で行います。

Markdownの下書きからスタイル付きの微信公众号記事を生成するClaudeスキルです。APIモードではmd2wechat.cnを呼び出してテーマ付きの即時変換を行い、AIモードではClaudeがよりリッチなカスタムスタイリングを生成します。メタデータの抽出、微信メディアライブラリへの画像アップロード、バックエンドへの下書き作成までを一貫して処理します。

なぜ使うのか

主な機能

ライブデモ

実際の動作

md2wechat-skill.replay ▶ 準備完了
0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "md2wechat-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/geekjourneyx/md2wechat-skill",
        "~/.claude/skills/md2wechat-skill"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "md2wechat-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/geekjourneyx/md2wechat-skill",
        "~/.claude/skills/md2wechat-skill"
      ],
      "_inferred": true
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "md2wechat-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/geekjourneyx/md2wechat-skill",
        "~/.claude/skills/md2wechat-skill"
      ],
      "_inferred": true
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "md2wechat-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/geekjourneyx/md2wechat-skill",
        "~/.claude/skills/md2wechat-skill"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "md2wechat-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/geekjourneyx/md2wechat-skill",
        "~/.claude/skills/md2wechat-skill"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json
{
  "context_servers": {
    "md2wechat-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/geekjourneyx/md2wechat-skill",
          "~/.claude/skills/md2wechat-skill"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add md2wechat-skill -- git clone https://github.com/geekjourneyx/md2wechat-skill ~/.claude/skills/md2wechat-skill

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方: md2wechat-skill

Markdownの下書きをワンステップで微信公众号の下書きに変換する

👤 Markdownで執筆したい運営担当者・公众号エディター ⏱ ~5 min beginner

使うタイミング: Obsidian/VSCodeで下書きを書いているが、微信エディターでの手動フォーマットが面倒なとき。

前提条件
  • md2wechat.cn APIキー — md2wechat.cnでアカウント登録 — 無料枠あり
  • 微信公众号APIの認証情報 — 公众号を登録し、AppID/AppSecretを取得
フロー
  1. APIモードで変換
    Use md2wechat-skill. Take this draft at article.md, convert with the 'modern' theme, and push to WeChat drafts.✓ コピーしました
    → テーマ付きHTML+微信バックエンドの下書きURL
  2. 微信エディターで確認
    (manual step — open the draft)✓ コピーしました
    → プレビューが意図通りであること

結果: 20分のコピー&ペースト作業の代わりに、数秒で公開可能な微信の下書きが完成します。

注意点
  • Markdown内の画像がローカルパスになっている — スキルがローカル画像を微信メディアライブラリにアップロードします — 実行環境からアクセス可能である必要があります
組み合わせ: filesystem

AIモードで視覚的に際立つ長文エッセイを作成する

👤 テンプレートテーマ以上の表現を求めるクリエイター ⏱ ~15 min intermediate

使うタイミング: カスタムの引用ブロック、コールアウト、視覚的な階層構造が必要な記事の場合。

フロー
  1. AIモードをリクエスト
    Use md2wechat-skill in AI mode. Style this essay with warm typography and pull-quotes.✓ コピーしました
    → Claudeがプリセットテーマより豊かなHTMLスタイリングを生成
  2. 下書きにアップロード
    Now push to the 公众号 draft backend.✓ コピーしました
    → 下書きIDが返却される

結果: フィード上で目を引く、視覚的に独自性のある記事が完成します。

注意点
  • 過度なスタイリングがモバイルでの可読性を損なう — 公開前にモバイルでプレビューしてください — 微信ユーザーの95%以上がモバイル利用です
組み合わせ: claude-blog-skill

組み合わせ

他のMCPと組み合わせて10倍の力を

md2wechat-skill + claude-blog-skill

claude-blog-skillが記事を執筆し、md2wechat-skillが微信に公開する

Use /blog write for a new post, then md2wechat-skill to push to the 公众号 drafts.✓ コピーしました
md2wechat-skill + filesystem

ローカルのMarkdownファイルフォルダから下書きを読み込む

For every .md in ~/wechat-drafts ready to ship, convert and push.✓ コピーしました

カバー画像のプロンプトを推薦し、外部で生成後、このスキルでアップロードする

Pick a cover prompt from nano-banana, then publish the draft with the resulting image.✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
API conversion (themed) markdown + theme name テーマ付きの高速出力が必要なとき md2wechat.cn credits
AI styling mode markdown + style brief プリセット以上のカスタムデザインが必要なとき LLM tokens only
Image upload image paths / URLs 画像が含まれる場合、下書き作成前に実行 0 (WeChat API)
Draft creation HTML + metadata + media IDs 最終ステップ 0
Cover image generation article or custom brief カバー画像が未指定の場合 Depends on generator

コストと制限

運用コスト

APIクォータ
md2wechat.cnには無料・有料プランがあり、WeChat APIにも独自のクォータがあります
呼び出しあたりのトークン
APIモードは少量、AIモードは中程度
金額
基本無料。md2wechat.cnの無料枠を超えた場合のみ有料
ヒント
通常の投稿にはAPIモードを使い、AIモードはこだわりたい記事に温存しましょう。

セキュリティ

権限、シークレット、影響範囲

認証情報の保管: md2wechat.cn APIキーとWeChat AppID/AppSecretは環境変数に保存してください。リポジトリにコミットしないこと。
データ送信先: md2wechat.cnおよびWeChatの公式APIエンドポイントへデータが送信されます

トラブルシューティング

よくあるエラーと対処法

40001 invalid credential (WeChat)

AppSecretが間違っているか、access_tokenが期限切れです。スキルが自動更新するはずですが、更新されない場合はシークレットをローテーションしてください。

微信で画像が表示されない

微信は外部ドメインの画像をブロックします — すべての画像がメディアAPIを通じてアップロードされていることを確認してください。

変換APIが401を返す

md2wechat.cnのキーが未設定または使用上限に達しています — ダッシュボードを確認してください。

代替案

md2wechat-skill 他との比較

代替案代わりに使う場面トレードオフ
Manual copy-paste into WeChat editor投稿頻度が低い場合遅いがセットアップ不要
Mdnice / Mdx editorAI自動化よりもWebUIで操作したい場合手動フロー、下書きAPIへの自動投稿なし

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る