القائمة
Substack の記事（長文ポスト）と Notes（短文ポスト）を企画→執筆→サムネ生成→公開まで一気通貫で行う。ユーザーが「Substack 記事を書いて」「Substack に投稿して」「Substack で発信したい」「Substack に Note 出して」「短文ポストして」と頼んだときに使う。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | substack-article |
| description | Substack の記事（長文ポスト）と Notes（短文ポスト）を企画→執筆→サムネ生成→公開まで一気通貫で行う。ユーザーが「Substack 記事を書いて」「Substack に投稿して」「Substack で発信したい」「Substack に Note 出して」「短文ポストして」と頼んだときに使う。 |
| license | MIT |
| metadata | {"author":"nanameru","version":"1.0.0"} |
このスキルは substack-mcp（同じリポジトリ内）と codex MCP を組み合わせて、
Substack の 長文記事（カバー画像付き・公開・予約・有料化）と Notes（短文 SNS 的投稿）の両方を、
Claude Code から作成・投稿するためのものです。画像生成は Codex のサブスクリプション内で完結するため OpenAI API キーは不要です。
templates/best-practices.md — Substack 運用フレームワーク・推奨設定・成長戦略の要点（執筆や設定判断時に参照）templates/thumbnail-prompt.md — サムネ生成（Codex 経由）の Prompt テンプレtemplates/notes-workflow.md — Notes（短文）の投稿パターン・運用ルール以下がセットアップ済みであること。未セットアップなら案内する。
substack-mcp が Claude Code に登録されている（~/substack/.venv/bin/substack-mcp を MCP として登録）substack-mcp-setup --yes で認証情報が保存済み（~/Library/Application Support/substack-mcp/config.json）codex MCP が登録されている（サムネ生成に使用）~/substack/thumbnails/ を使用mcp__substack-mcp__create_draft — 下書き作成（タイトル・本文 Markdown・サブタイトル・audience）mcp__substack-mcp__update_draft — 下書き更新（部分更新可）mcp__substack-mcp__upload_image — 画像を Substack CDN にアップロードmcp__substack-mcp__set_cover_image — カバー画像（サムネ）を設定mcp__substack-mcp__publish_draft — 公開（send_email でメール配信切替）mcp__substack-mcp__schedule_draft — 公開予約（ISO 8601 datetime）mcp__substack-mcp__unschedule_draft — 予約解除mcp__substack-mcp__list_drafts — 下書き一覧mcp__substack-mcp__get_draft — 下書き詳細取得mcp__substack-mcp__delete_draft — 下書き削除mcp__substack-mcp__post_note — Notes（X / Threads 風の短文）を即時公開。タイトル・サブタイトルなし。メール配信なし。Substack 全体のフィードに表示ユーザーの要望が 長文記事（Post） か Notes（短文） のどちらを求めているか、最初に判定する。
判定基準：
判定が曖昧なら、ユーザーに確認する：「長文記事ですか？それとも Notes（短文）ですか？」
詳細は templates/notes-workflow.md を参照。要約：
mcp__substack-mcp__post_note(text=...) を呼ぶurl をユーザーに伝えるNotes には下書き API がないので、確認できるのは「公開前のテキストドラフト」までで、公開を実行する前に必ず止まる。
ユーザーの要望を聞いて、以下のステップを順に実行する。Step 2（構成合意）と Step 7（公開許可）で必ず止まること。
判断に迷ったら templates/best-practices.md を参照（ポジショニング・差別化軸・推奨設定・成長ロードマップなど）。
次の情報を引き出す（明示されていなければ質問する）：
send_email フラグに対応）タイトル + 見出し（H2、H3）レベルの構成案を Markdown で提示し、ユーザーに「この構成で書いていい？」と確認する。ここで必ず止まる。
ヒアリング段階で短い記事（〜300字）が指定されていれば、構成案の代わりに完成形の本文ドラフトを直接提示してもよい。
合意した構成に従って Markdown で本文を書く。Substack 互換の記法に注意：
**bold** / 斜体 *italic* / 取消線 ~~strike~~[text](url)- item / * item / 順序付き 1. item> quote```language ... ``` — ローカルパスを書くと python-substack の from_markdown が自動でアップロードする[^1]| col1 | col2 | と |---|---| は Substack の表ブロックに変換されない。本文中にそのまま書くとパイプ記号と区切り線がリテラル文字として残る。比較情報は太字＋箇条書きや見出し＋段落で書く。python-substack の Markdown パーサーが水平線として正しく処理せず、リテラル文字として残ることがある。区切りが必要なら見出しを使うか、空行で対応する。{"content": "..."} だけで type: text を持たない形になるバグが python-substack 0.1.20 にある。src/substack_mcp/client.py の _normalize_prosemirror で正規化済みなので、MCP サーバー経由なら問題ない。直接 python-substack を使う場合は要注意。mcp__substack-mcp__create_draft を呼ぶ。引数：
title：必須、280字以内content_markdown：必須、Markdown 本文subtitle：任意、280字以内audience：everyone / only_paid / founding / only_free（デフォルト everyone）返り値の post_id を必ず保持してユーザーにも明示する。
ユーザーがサムネ生成を希望した場合のみ。OpenAI API キーは不要、Codex のサブスク内で生成する。
設計原則：
詳細は templates/thumbnail-prompt.md を参照。Codex への依頼は以下のように：
mcp__codex__codex({
prompt: <thumbnail-prompt.md の内容を埋めて流す>,
cwd: "<このリポジトリの絶対パス>",
sandbox: "workspace-write",
approval-policy: "never"
})
最終ファイル名は thumbnails/substack_<記事スラッグ>_<UNIX秒>.png 形式で重複回避。返ってきた絶対パスを Step 6 で使う。
upload = mcp__substack-mcp__upload_image(image_path=<Step 5 の絶対パス>)
mcp__substack-mcp__set_cover_image(post_id=<Step 4 の post_id>, image_url=upload.url)
注意：upload_image の戻り値の url を使う。raw.url でも同じ。サブドメイン違いの S3 URL（substack-post-media.s3.amazonaws.com）が返ってくるが、これで正しい。
下書き URL（edit_url）をユーザーに伝え、プレビュー確認を促す。ユーザーの明示的な許可なく公開しない。
ユーザーが「公開して」と言ったら：
mcp__substack-mcp__publish_draft(
post_id=<post_id>,
send_email=<Step 1 で確認した値、デフォルト true>,
share_automatically=<デフォルト false>
)
返り値の public_url をユーザーに伝える。
mcp__substack-mcp__schedule_draft(
post_id=<post_id>,
iso_datetime="2026-05-15T09:00:00+09:00" # JST 例
)
予約解除は unschedule_draft(post_id)。
pycookiecheat がキーチェーンで管理）publish_draft, post_note）を呼ばないpost_id をユーザーに明示するmcp__codex__codex）。Claude から OpenAI API を直接叩かない1456 × 819 で生成（PIL リサイズで保証）send_email）をユーザー確認なしに True にしない（既にメール送信したものは取り消せない）post_note の戻り値の url を必ずユーザーに伝える（公開を確認できるように）templates/notes-workflow.md 参照）Offline 表示 — Substack 側のバグ。MCP 経由のデータには影響なし、無視して OK'NoneType' object is not subscriptable（setup 時） — publication URL が間違っている。chrome_setup.py で API から自動検出するCould not find a Substack session — Chrome で https://substack.com にログインしていない。先にログインして再実行security コマンドのキーチェーンアクセスが拒否された。「常に許可」を選ぶclient.py の _normalize_prosemirror が動いていない可能性。MCP サーバー再起動して試すcookie value looks too short — Cookie がまだ取得できていないか壊れている。Chrome で一度ログアウト → 再ログイン → 再実行Post.from_markdown() を活用しているので、Markdown 入力さえまともなら本文は正しく組み立てられる--browser フラグで残してあるが非推奨）python-substack はリバースエンジニアリングされた内部 API を叩いている。仕様変更で動かなくなる可能性は常にある