【substack-mcp】サムネ付き記事投稿CLIを整備する

[nanameru]

課題 / 目的

substack-mcp を使って、Markdown本文とサムネイル画像からSubstack記事を作成し、必要に応じて公開まで進められる導線を整える。今回の実運用対象は「Fable 5（現行の公式表記では Fable リブート）」の記事。

対象範囲

• Markdown記事ファイルから下書きを作成するCLI導線の整備
• ローカル画像またはURLをSubstackへアップロードし、記事カバー画像として設定する導線の整備
• --publish 指定時のみ公開する安全な挙動
• Fable記事本文とサムネイルの作成、可能であれば下書き投稿までの実行

完了条件

• substack-mcp のパッケージ内コマンドで、本文作成、カバー設定、公開オプションを一連で実行できる
• サムネイル付きの記事下書きが作れる
• 公開操作は明示フラグまたはユーザー確認なしに実行されない
• 関連するテスト、lint、またはbuild相当の検証結果を記録する

実装計画

1. 既存の create_article.py / generate_and_publish.py / SubstackClient の責務を確認する
2. パッケージ配下に再利用可能なCLIモジュールを追加し、pyproject.toml にentry pointを追加する
3. cover imageアップロードと set_cover_image を下書き作成フローに統合する
4. dry-runまたはユニットテストで引数処理とクライアント呼び出し順を検証する
5. Fable記事本文とサムネイルを作成し、認証情報が利用可能なら下書き作成まで行う

テスト / CI計画

• python -m compileall src
• 追加したCLIのユニットテストまたはmock実行
• 認証情報がある場合のみSubstack API実行。認証情報がない場合は下書き投稿をブロックとして記録する

ナレッジログ

• 作業開始時点でopen Issueなし
• 既存MCPには create_draft、upload_image、set_cover_image、publish_draft が存在
• 既存の generate_and_publish.py はFAL_KEY依存かつ既存post_id前提なので、今回の「記事本文＋サムネ＋下書き作成」を単発で実行する導線は不足

[nanameru]

ナレッジログ更新

判断

• 既存のMCPツールには create_draft / upload_image / set_cover_image / publish_draft が揃っていたため、クライアント本体ではなくCLI導線を追加した。
• generate_and_publish.py は FAL_KEY と既存 post_id 前提のため、今回の「Markdown本文 + カバー画像 + 下書き作成」を一括実行できる substack-publish-article を追加した。
• 公開は --publish を明示した場合のみ。--send-email と --share-automatically は --publish なしでは拒否する設計にした。

触ったファイル

• .gitignore
• README.md
• pyproject.toml
• src/substack_mcp/article_cli.py
• src/substack_mcp/constants.py
• src/substack_mcp/client.py
• tests/test_article_cli.py
• test-board.yaml
• articles/fable5.md

検証

• .venv/bin/python -m unittest discover -s tests → 成功（2 tests）
• .venv/bin/python -m compileall src → 成功
• test-board once --board test-board.yaml → status=done:1

実運用結果

• substack-publish-article でFable記事の下書き作成、サムネイル画像アップロード、カバー設定まで成功。
• 下書きID: 204559799
• 編集URL: https://taiyoai.substack.com/publish/post/204559799
• カバー画像URL: https://substack-post-media.s3.amazonaws.com/public/images/f36d3f43-0553-48f5-a0a6-5b131cb50464_1456x819.jpeg
• --publish は付けていないため未公開。公開前プレビュー確認待ち。

フォローアップ

• ユーザー確認後、同じCLIに --publish を付けるか、MCPの publish_draft で公開する。

[nanameru]

テストケース

Issue #1 に紐づく test-board ケースです。

• TC-001 [done] サムネ付き記事投稿CLI: Markdown本文とカバー画像からSubstack下書きを作成し、明示指定時だけ公開する
  • test: tests/test_article_cli.py
  • source: src/substack_mcp/article_cli.py

[nanameru]

完了前ログ

• コミット: 699a8c7（サムネ付き記事投稿CLIを追加する Refs #1）
• Draft PR: 【substack-mcp】サムネ付き記事投稿CLIを整備する #2
• push先: issue-1-article-cover-cli
• PRチェック: Amazon Q Developer → pass
• 横断Project: Issue / PR とも追加済み
• ボードView: https://github.com/users/nanameru/projects/3/views/3

公開操作は未実行。下書きプレビュー確認後、ユーザーの明示許可を得て公開する。