Substack Publisher MCP

substack-publisher-mcp

Substack の公式 Publisher API 用 MCP サーバー

注記： これは非公式のコミュニティ開発ツールであり、Substack, Inc. との提携、同社による推奨またはサポートはありません。

Substack の公式 Publisher API 用 MCP サーバーです。Claude、Cursor、または任意の MCP クライアントから、投稿の検索や閲覧、投稿の分析データと購読者数の取得、購読者の検索ができます。すべてのツールは読み取り専用です。

このサーバーを選ぶ理由

前提条件

• Node.js 22 以降。 node --version で確認してください。インストールされていない場合は、nodejs.org からインストールしてください。
• Substack Publisher API キー。 出版物の Substack ダッシュボードから生成してください。Publisher API の項目が表示されない場合は、出版物でまだ有効になっていない可能性があります。利用可能かどうかは Publisher API のドキュメント をご覧ください。

クイックスタート

1. インストール

git clone https://github.com/dkships/substack-publisher-mcp.git
cd substack-publisher-mcp
npm install && npm run build

2. MCP クライアントを設定する

クライアントの MCP 設定ファイルに追加します（ファイルがない場合は作成してください）。

{
  "mcpServers": {
    "substack": {
      "command": "node",
      "args": ["/path/to/substack-publisher-mcp/dist/index.js"],
      "env": {
        "SUBSTACK_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code のユーザーへ： サーバー設定に "type": "stdio" を追加してください。

設定ファイルを編集した後、MCP クライアントを再起動してください。サーバーは起動時に読み込まれます。

3. 使い始める

Claude（または MCP クライアント）に次のように尋ねます。

• 「設定している Substack の出版物はどれですか？」
• 「先月の投稿を表示して」
• 「価格設定についての投稿を探して」
• 「スラッグが my-latest-post の投稿を表示して」
• 「最新の投稿の開封数とクリック数はいくつですか？」
• 「過去 30 日間の購読者数を教えて」
• 「[email protected] の購読者情報を検索して」

AI エージェントやレジストリを通じてインストールしますか？簡潔で機械可読なセットアップガイドについては、llms-install.md をご覧ください。

ツール

複数の出版物を設定している場合、list_publications 以外のすべてのツールで、任意の publication パラメーターを指定できます。

get_post は、デフォルトで投稿本文を Markdown として返します。Substack は本文を JSON エンコードされた ProseMirror ドキュメントとして送信するため、通常は約 2 倍のサイズになります。生のドキュメントを取得するには bodyFormat: "prosemirror" を、メタデータのみを取得するには "none" を指定してください。

日付フィルターには YYYY-MM-DD を指定します。list_posts では endDate は範囲に含まれませんが、get_subscriber_counts では含まれます。

レスポンス例

[
  {
    "date": "2025-01-15",
    "total_email_subscribers": 25000,
    "paid_subscribers": 500,
    "free_trial_subscribers": 10,
    "comp_subscribers": 50,
    "gift_subscribers": 15,
    "lifetime_subscribers": 0,
    "founding_subscribers": 25
  }
]

{
  "clicks": 320,
  "opens": 5400,
  "post_id": 12345678,
  "recipients": 10000,
  "views": 6100,
  "new_free_subscriptions": 80,
  "new_paid_subscriptions": 5,
  "estimated_revenue_increase": 400
}

{
  "posts": [
    {
      "post_id": 12345678,
      "title": "My Latest Post",
      "audience": "only_paid",
      "subtitle": "A deep dive into the topic",
      "postDate": "2025-01-15T12:00:00.000Z",
      "urlSlug": "my-latest-post",
      "coverImage": "https://substackcdn.com/image/..."
    }
  ],
  "next": "abc123cursor"
}

複数の出版物

複数のSubstack出版物を管理している場合は、SUBSTACK_API_KEY_<NAME> の形式でそれぞれに個別のAPIキーを設定します。

{
  "mcpServers": {
    "substack": {
      "command": "node",
      "args": ["/path/to/substack-publisher-mcp/dist/index.js"],
      "env": {
        "SUBSTACK_API_KEY_MAIN": "your-main-blog-key",
        "SUBSTACK_API_KEY_TECH": "your-tech-newsletter-key",
        "SUBSTACK_API_KEY_COMPANY": "your-company-updates-key"
      }
    }
  }
}

次に、クエリ対象の出版物を指定します。

「mainの購読者数を表示して」 「tech出版物の最近の投稿を一覧表示して」

設定済みの出版物名をすべて確認するには、list_publications を使用します。

トラブルシューティング

APIリファレンス

このサーバーはSubstack Publisher APIをラップしています。利用可能なデータやレート制限の詳細については、Substackのドキュメントを参照してください。

コントリビューション

ガイドラインについては、CONTRIBUTING.mdを参照してください。

ライセンス

MIT Licenseです。詳細については、LICENSEを参照してください。

SubstackはSubstack, Inc.の商標です。このプロジェクトはSubstack, Inc.とは提携していません。Substackの名称は説明を目的としてのみ使用しています。