# SocialCrawl

> SocialCrawl is a freemium MCP server for web search and scraping. One API behind MCP for TikTok, Instagram, YouTube and 18 other social platforms. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Repository:** https://github.com/ridiodevelopment/socialcrawl-mcp
- **MCP Registry name:** io.github.RidioDevelopment/socialcrawl
- **Categories:** [web search and scraping](https://ai-powered.com/categories/web-search-and-scraping), [marketing and SEO](https://ai-powered.com/categories/marketing-and-seo)
- **Listing updated:** 2026-11-15

## About

The server reads 105 endpoints across 21 platforms through one key, so an agent does not need separate authentication for each network. It works by discovery: the agent lists platforms, lists a platform's endpoints with their parameters and credit costs, then makes the call. The README's example fetches a TikTok profile through the user/info endpoint at one credit.

TikTok has the most endpoints (24), followed by Instagram and Facebook (12 each) and YouTube (11); smaller coverage includes Reddit, Threads, Pinterest, Twitch and LinkedIn. Roughly 90% of endpoints cost 1 credit, about 8% cost 5 and about 2% cost 10, and a new account receives 100 free credits.

It runs locally over stdio via npm with a SOCIALCRAWL_API_KEY, or as a hosted streamable-HTTP endpoint.

## Features

- **Endpoint discovery:** Agents list platforms and endpoints dynamically instead of hardcoding them.
- **Unified requests:** socialcrawl_request calls any endpoint with platform, endpoint and params.
- **Credit-based pricing:** Each endpoint's credit cost is visible before the call.
- **Broad platform list:** 21 platforms including TikTok, Instagram, YouTube, Reddit and LinkedIn.
- **Two transports:** Run via npx over stdio or use the hosted HTTP endpoint.

## Good for

- Pull a creator's profile and recent posts
- Search a platform for trending content
- Collect comments on a post for sentiment review
- Compare follower counts across networks

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http socialcrawl https://mcp.socialcrawl.dev/mcp
```

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

```sh
https://mcp.socialcrawl.dev/mcp
```

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

```json
{
  "mcpServers": {
    "socialcrawl": {
      "url": "https://mcp.socialcrawl.dev/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "socialcrawl": {
      "type": "http",
      "url": "https://mcp.socialcrawl.dev/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "socialcrawl": {
      "serverUrl": "https://mcp.socialcrawl.dev/mcp"
    }
  }
}
```

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

```sh
https://mcp.socialcrawl.dev/mcp
```

Enter a Name (for example "SocialCrawl"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

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

```json
{
  "mcpServers": {
    "socialcrawl": {
      "type": "http",
      "url": "https://mcp.socialcrawl.dev/mcp"
    }
  }
}
```

## Tools

- `socialcrawl_list_platforms`: List the 21 supported platforms with slugs and endpoint counts
- `socialcrawl_list_endpoints`: Endpoints, required parameters and credit costs for a platform
- `socialcrawl_request`: Make any SocialCrawl API call
- `socialcrawl_get_docs`: API documentation for a platform or endpoint

## FAQ

### What does it cost?

New accounts get 100 free credits; most endpoints cost 1 credit, some 5 or 10. Paid plans are mentioned but not detailed.

### How many platforms are covered?

21 platforms and 105 endpoints.

### Do I authenticate with each platform?

No, the README says no per-platform authentication is required.

### What licence is the MCP package under?

MIT.

### Is SocialCrawl free?

SocialCrawl has a free plan, with paid plans for more usage or features.

### How do I add SocialCrawl to Claude Code?

Run this command in your terminal: claude mcp add --transport http socialcrawl https://mcp.socialcrawl.dev/mcp

### What are the best alternatives to SocialCrawl?

The closest alternatives to SocialCrawl are ScrapeIO, Socialscrape, InsightSocial, TrueScrape and SocialToAI.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [ScrapeIO](https://ai-powered.com/mcp/scrapeio): ScrapeIO is a paid MCP server for web search and scraping.
- [Socialscrape](https://ai-powered.com/mcp/socialscrape): Socialscrape is a freemium MCP server for web search and scraping.
- [InsightSocial](https://ai-powered.com/mcp/insightsocial): InsightSocial is a freemium MCP server for analytics and data.
- [TrueScrape](https://ai-powered.com/mcp/truescrape): TrueScrape is a freemium MCP server for web search and scraping.
- [SocialToAI](https://ai-powered.com/mcp/socialtoai): SocialToAI is a paid MCP server for web search and scraping.
- [Scrape Everything](https://ai-powered.com/mcp/scrape-everything): Scrape Everything is a freemium MCP server for web search and scraping.
- [socially.run](https://ai-powered.com/mcp/socially-run): socially.run is a paid MCP server for web search and scraping.
- [TikTok Scraper](https://ai-powered.com/mcp/tiktok-scraper-2): TikTok Scraper is an open-source MCP server for web search and scraping.

---
Source: https://ai-powered.com/mcp/socialcrawl
