mcp-substack-scraper について
mcp-substack-scraperは、Apify Actorを通じてSubstackの刊行物プロフィールや投稿データを取得するMCPサーバーです。研究者やニュースレター分析者向けに、購読者数や投稿情報の確認、キーワード検索を提供します。
主な機能
- 01刊行物プロフィールと購読者数
- 02投稿メタデータと任意の本文
- 03投稿のキーワード検索
- 04期間と件数による投稿絞り込み
活用シーン
- 01購読者数とプラン料金の比較
- 02テーマ別ニュースレターの検索
- 03最近の投稿と公開範囲の確認
MCP 対応
MCPクライアントに `scrape_substack` ツールを公開します。Apify Actorを起動して完了を待ち、データセットの行を返します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
1掲載時のツール一覧 · 1 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| proxy_mode | enum | いいえ | ページの取得方法。デフォルトは auto です。auto | direct |
| since_days | string | いいえ | 任意。指定日数より古い投稿をスキップします。0 または空欄の場合、上限に達するまですべての投稿を保持します。デフォルトは 0 です。 |
| include_body | string | いいえ | true にすると、一覧表示された出版物の各投稿行に本文(最大 20,000 文字)を追加します。有料投稿では無料プレビューを取得します。投稿ごとにページをもう 1 ページ読み込みます。追加料金はかかりません。デフォルトは false です。 |
| publications | array | いいえ | Substack の出版物を 1 行に 1 件、最大 100 件まで指定します。URL(https://www.lennysnewsletter.com)、ドメイン(lenny.substack.com)、プロフィール(substack.com/@lenny)、または Substack 名(lenny)を指定できます。それぞれについて、出版物の行と最新の投稿が返されます。 |
| search_output | enum | いいえ | 検索クエリで返す内容。デフォルトは投稿です。posts | publications |
| max_charge_usd | string | いいえ | 任意。料金がこの金額を超える前に実行を停止します。 |
| search_queries | array | いいえ | Substack の投稿を検索するキーワードを 1 行に 1 件、最大 20 件まで指定します。各クエリは一致する投稿を返します。Search output が publications の場合は、その投稿の掲載元の出版物を返します。 |
| max_search_results | string | いいえ | 検索クエリごとに返す行数。1~1000。デフォルトは 50 です。 |
| include_publication_row | string | いいえ | true の場合、指定した出版物ごとに出版物の行(名前、著者、購読者数、有料プランの価格)を 1 件返し、出版物の行として課金されます。false の場合、投稿の行のみを返します。デフォルトは true です。 |
| max_posts_per_publication | string | いいえ | 出版物ごとに返す最新投稿数。0~1000。0 の場合、出版物の行のみを返します。デフォルトは 20 です。 |
詳細
Substack Scraper MCP サーバー
Apify 上の Mamba Labs Substack Newsletter and Posts Scraper アクター向けの MCP サーバーです。Substack の出版物やキーワードを指定すると、出版物のプロフィールと投稿をフラットな行形式で返します。
内容
できること
- 出版物:名前、著者、タグライン、Substack に表示される購読者数(
subscriber_count_textおよび数値のsubscriber_count_min)、購読者層のテキスト、月額・年額・創設者プランの料金。 - 投稿:タイトル、URL、日付、
audience(無料、有料、または創設者向け)、いいね数、コメント数、再投稿数、単語数、署名、タグ。include_bodyで投稿本文を任意に含められます。 - 検索:Substack の投稿をキーワード検索し、投稿またはその投稿を掲載した出版物として返します。
処理はすべて Apify 上で実行されます。このパッケージは、アクターの実行を開始して完了を待ち、データセットの行を返す軽量なクライアントです。
クイックスタート
Node.js 18 以降と、API トークンを持つ Apify アカウントが必要です。
これを Claude Desktop の設定(claude_desktop_config.json)、Cursor、または任意の MCP クライアントに追加します。
{
"mcpServers": {
"mamba-substack-scraper": {
"command": "npx",
"args": [
"-y",
"@mambalabsdev/mcp-substack-scraper"
],
"env": {
"APIFY_TOKEN": "your-apify-token"
}
}
}
}
クライアントを再起動すると、scrape_substack ツールが表示されます。
前提条件
- Node.js 18 以降。
- console.apify.com/account/integrations から取得した Apify API トークンを
APIFY_TOKENとして設定します。サーバーはトークンがなくてもツールを表示しますが、呼び出しにはトークンが必要です。
プロンプトの例
- 「Lenny's Newsletter の購読者数と、有料プランの料金を教えてください。」
- 「コールドメールについて書いている Substack ニュースレターを探し、それぞれの購読者数を挙げてください。」
- 「過去30日間に notboring.co が公開した記事と、有料購読者限定の記事を教えてください。」
ツール
scrape_substack。ツールは1つです。引数の例:
{
"publications": [
"lenny.substack.com"
],
"search_queries": [
"cold email"
],
"max_posts_per_publication": "5",
"max_search_results": "5"
}
入力
アクターの購入者向け入力はすべてそのままです。省略された入力には、アクター独自のデフォルト値が適用されます。数値とブール値は文字列として送信されます。
| 入力 | 型 | 説明 |
|---|---|---|
publications | array | Substack の publication。1 行につき 1 件、最大 100 件です。URL(https://www.lennysnewsletter.com)、ドメイン(lenny.substack.com)、プロフィール(substack.com/@lenny)、または Substack の名前(lenny)を指定します。それぞれについて、publication の行と最新の投稿が返されます |
search_queries | array | Substack の投稿を横断検索するキーワード。1 行につき 1 件、最大 20 件です。各クエリは一致する投稿を返します。Search の出力が publications の場合は、それらの投稿の publication を返します |
search_output | string | 検索クエリが返す内容。デフォルトは posts です |
max_posts_per_publication | string | publication ごとに返す最新の投稿数。0~1000 を指定します。0 の場合は publication の行のみ返します。デフォルトは 20 です |
max_search_results | string | 検索クエリごとに返す行数。1~1000 を指定します。デフォルトは 50 です |
since_days | string | 任意。指定した日数より前の投稿を除外します。0 または空欄の場合、上限までのすべての投稿が対象です。デフォルトは 0 です |
include_publication_row | string | true の場合、指定した publication ごとに publication の行(名前、作者、購読者数、有料プランの価格)を 1 行返し、publication の行として課金されます。false の場合は投稿の行のみ返します。デフォルトは true です |
include_body | string | true の場合、指定した publication の各投稿の行に投稿本文(最大 20,000 文字)を追加します。有料投稿では無料プレビューが返されます。投稿ごとにページをもう 1 ページ読み込みますが、追加料金はかかりません。デフォルトは false です |
max_charge_usd | string | 任意。指定した金額を超えて課金される前に実行を停止します |
proxy_mode | string | ページの取得方法。デフォルトは auto です |
料金
Apify ではイベントごとに課金され、料金は Apify アカウントに請求されます。価格は USD です。
| イベント | Free プラン | Bronze | Silver | Gold |
|---|---|---|---|---|
post-row、一覧表示された publication または検索から返された Substack の投稿 1 件の行 | $0.00115 | $0.001093 | $0.001035 | $0.000977 |
publication-row、Substack の publication プロフィール 1 件の行(名前、作者、表示されている購読者数、有料プランの価格) | $0.002 | $0.0019 | $0.0018 | $0.0017 |
apify-actor-start、実行開始 1 回あたり | $0.001057 | $0.001057 | $0.001057 | $0.001057 |
no_results と error の行は無料です。拒否された入力によって返される 1 行も無料です。
キーについて
このアクターにキーは不要です。Substack の公開ページと公開 JSON ルートを読み取り、いかなるキーも保持しません。プロキシの通信による追加料金はありません。実行のプラットフォーム費用は Mamba Labs が負担します。
アクターの全ドキュメント
apify.com/mambalabs/substack-scraper
ライセンス
MIT。詳細は LICENSE を参照してください。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。