# Substack Scraper

> Substack Scraper is a paid MCP server for web search and scraping. Scrapes posts, engagement counts and full text from any Substack newsletter via MCP. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** Web, API, CLI, Self-hosted
- **Website:** https://apify.com/sumitr_mardy/substack-scraper
- **MCP Registry name:** io.github.sumitrmardy/substack-scraper
- **Categories:** [web search and scraping](https://ai-powered.com/categories/web-search-and-scraping), [news and media](https://ai-powered.com/categories/news-and-media)
- **Listing updated:** 2026-11-20

## About

The Substack Scraper is an Apify actor that pulls the post archive of a Substack newsletter, including custom-domain publications, and returns each post with its date, author, likes, comments, restacks, word count and paid flag. The archive can be sorted newest first or by most liked, and can be cut off at a chosen date so repeat runs only fetch new posts.

For each post, the actor can also return the body as clean text and HTML. Paid posts only expose the free preview Substack shows to non-subscribers, and comment text is not included, only the comment count. No login or Substack account is needed, and the actor is billed per post returned.

It suits newsletter writers comparing competing publications, marketers following a niche, researchers, and developers feeding newsletter text into AI pipelines. The product page also lists it as callable from AI agents over MCP, through a hosted endpoint on Apify's MCP server.

## Features

- **Full post metadata:** Returns title, date, author, likes, comments, restacks, word count and paid status for each post.
- **Optional full text:** Adds the post body as text and HTML when enabled, at one extra request per post.
- **Sorting and date cut-off:** Lists posts newest first or most liked, with an option to include only posts after a given date.
- **Custom domain support:** Accepts a subdomain, a newsletter URL or any post URL, including newsletters on their own domains.
- **Export formats:** Results can be downloaded as JSON, CSV, Excel or HTML, or retrieved through the API and automation tools.

## Good for

- Export a competitor newsletter's full archive to a spreadsheet
- Find the most liked posts of a newsletter in a given niche
- Feed newsletter text into an LLM or a reading archive
- Keep a running archive of a newsletter by scheduling runs with a date cut-off

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http substack-scraper 'https://mcp.apify.com/?tools=sumitr_mardy/substack-scraper'
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.apify.com/?tools=sumitr_mardy/substack-scraper
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "substack-scraper": {
      "url": "https://mcp.apify.com/?tools=sumitr_mardy/substack-scraper"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "substack-scraper": {
      "type": "http",
      "url": "https://mcp.apify.com/?tools=sumitr_mardy/substack-scraper"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "substack-scraper": {
      "serverUrl": "https://mcp.apify.com/?tools=sumitr_mardy/substack-scraper"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://mcp.apify.com/?tools=sumitr_mardy/substack-scraper
```

Enter a Name (for example "Substack Scraper"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin. When we checked, this server asked for a bearer token. Add it under HTTP headers as Authorization: Bearer <your token>.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "substack-scraper": {
      "type": "http",
      "url": "https://mcp.apify.com/?tools=sumitr_mardy/substack-scraper"
    }
  }
}
```

## FAQ

### Do custom domains work?

Yes. The actor accepts the newsletter's own address, such as a custom domain URL.

### Can Substack Scraper return the full text of paid posts?

No. For paid posts it only returns the free preview Substack shows to non-subscribers, and the isPaid field marks them.

### Does Substack Scraper return comment text?

Not in this version. It returns the comment count only.

### Does Substack Scraper need a Substack login?

No. The actor reads public data and does not log in or require a Substack account.

### How do I add Substack Scraper to Claude Code?

Run this command in your terminal: claude mcp add --transport http substack-scraper 'https://mcp.apify.com/?tools=sumitr_mardy/substack-scraper'

### What are the best alternatives to Substack Scraper?

The closest alternatives to Substack Scraper are Reddit Scraper, Articles, Newsletters & AI Models, Inkpluck: Article Extractor — URL to Text, Markdown & Metadata, Reddit Scraper (Apify) – posts, comments, search, users, subreddits and Reddit Scraper.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Status: checked automatically by AIPoweredBot on 21 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Reddit Scraper](https://ai-powered.com/mcp/reddit-scraper-3): Reddit Scraper is a paid MCP server for web search and scraping.
- [Articles, Newsletters & AI Models](https://ai-powered.com/mcp/articles-newsletters-and-ai-models): Articles, Newsletters & AI Models is a freemium MCP server for web search and scraping.
- [Inkpluck: Article Extractor — URL to Text, Markdown & Metadata](https://ai-powered.com/mcp/inkpluck-article-extractor-url-to-text-markdown-and-metadata-2): Inkpluck: Article Extractor — URL to Text, Markdown & Metadata is a paid MCP server for files and documents.
- [Reddit Scraper (Apify) – posts, comments, search, users, subreddits](https://ai-powered.com/mcp/reddit-scraper-apify-posts-comments-search-users-subreddits): Reddit Scraper (Apify) – posts, comments, search, users, subreddits is a freemium MCP server for web search and scraping.
- [Reddit Scraper](https://ai-powered.com/mcp/reddit-scraper): Reddit Scraper is a paid MCP server for web search and scraping.
- [Lemon8 Scraper](https://ai-powered.com/mcp/lemon8-scraper): Lemon8 Scraper is a paid MCP server for web search and scraping.
- [Reddit Subreddit, Comments & Buyer-Intent OSINT MCP](https://ai-powered.com/mcp/reddit-subreddit-comments-and-buyer-intent-osint-mcp): Reddit Subreddit, Comments & Buyer-Intent OSINT MCP is a freemium MCP server for web search and scraping.
- [LowlandData Social](https://ai-powered.com/mcp/lowlanddata-social): LowlandData Social is a freemium MCP server for web search and scraping.

---
Source: https://ai-powered.com/mcp/substack-scraper
