# SocialCrawl

> Access 21+ social media platforms through one unified API. Profiles, posts, search.

- **Type:** MCP server
- **Install:** `agentstack add mcp-ridiodevelopment-socialcrawl-mcp`
- **Verified:** Pending review
- **Seller:** [RidioDevelopment](https://agentstack.voostack.com/s/ridiodevelopment)
- **Installs:** 0
- **Latest version:** 1.0.1
- **License:** MIT
- **Upstream author:** [RidioDevelopment](https://github.com/RidioDevelopment)
- **Source:** https://github.com/RidioDevelopment/socialcrawl-mcp

## Install

```sh
agentstack add mcp-ridiodevelopment-socialcrawl-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# socialcrawl-mcp

[](https://www.npmjs.com/package/socialcrawl-mcp)
[](https://opensource.org/licenses/MIT)

MCP server for SocialCrawl — access 21+ social media platforms through one unified API.

## What it does

SocialCrawl MCP gives AI agents instant access to 21 social media platforms and 105 endpoints through a single, unified API. Retrieve profiles, posts, comments, search results, trending content, and analytics from TikTok, Instagram, YouTube, Twitter/X, LinkedIn, Reddit, and more — no per-platform authentication required. Agents discover available endpoints dynamically, so they always work with the latest capabilities without any hardcoded platform logic.

## Quick Setup

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):

```json
{
  "mcpServers": {
    "socialcrawl": {
      "command": "npx",
      "args": ["-y", "socialcrawl-mcp"],
      "env": {
        "SOCIALCRAWL_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

### Cursor

Add to `.cursor/mcp.json` in your project root or `~/.cursor/mcp.json` globally:

```json
{
  "mcpServers": {
    "socialcrawl": {
      "command": "npx",
      "args": ["-y", "socialcrawl-mcp"],
      "env": {
        "SOCIALCRAWL_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

### VS Code (Claude Code)

Add to `.vscode/mcp.json` in your project or your user settings:

```json
{
  "servers": {
    "socialcrawl": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "socialcrawl-mcp"],
      "env": {
        "SOCIALCRAWL_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

## Get Your API Key

1. Sign up at [socialcrawl.com](https://socialcrawl.com) — no credit card required
2. Receive 100 free credits instantly upon registration
3. Copy your API key from the dashboard and paste it into your config

## Available Tools

| Tool | Description |
|------|-------------|
| `socialcrawl_list_platforms` | Discover all 21 supported platforms with their slugs and endpoint counts |
| `socialcrawl_list_endpoints` | See all endpoints, required parameters, and credit costs for a specific platform |
| `socialcrawl_request` | Make any SocialCrawl API call — fetch profiles, posts, comments, search results, and more |
| `socialcrawl_get_docs` | Access detailed API documentation for a platform or specific endpoint |

## Example

**User prompt:** "Get the TikTok profile for charlidamelio"

**Agent flow:**

1. Calls `socialcrawl_list_endpoints` with `platform: "tiktok"` to discover available endpoints
2. Finds `user/info` endpoint — takes a `username` parameter, costs 1 credit
3. Calls `socialcrawl_request` with `platform: "tiktok"`, `endpoint: "user/info"`, `params: { username: "charlidamelio" }`
4. Returns profile data: follower count, bio, video count, verification status, and more

## Supported Platforms

| Platform | Endpoints |
|----------|-----------|
| TikTok | 24 |
| Instagram | 12 |
| YouTube | 11 |
| Facebook | 12 |
| X (Twitter) | 6 |
| LinkedIn | 6 |
| Reddit | 7 |
| Threads | 5 |
| Pinterest | 4 |
| Google | 4 |
| Truth Social | 3 |
| Twitch | 2 |
| Snapchat | 1 |
| Kick | 1 |
| Amazon | 1 |
| Linktree | 1 |
| Linkbio | 1 |
| Linkme | 1 |
| Komi | 1 |
| Pillar | 1 |
| Utility | 1 |

**Total: 105 endpoints across 21 platforms**

## Credit System

| Tier | Cost | Share of Endpoints |
|------|------|--------------------|
| Standard | 1 credit | ~90% |
| Advanced | 5 credits | ~8% |
| Premium | 10 credits | ~2% |

New accounts receive 100 free credits — enough to make 100 standard requests or explore multiple platforms before committing to a paid plan.

## License

MIT — see [LICENSE](LICENSE) for details.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [RidioDevelopment](https://github.com/RidioDevelopment)
- **Source:** [RidioDevelopment/socialcrawl-mcp](https://github.com/RidioDevelopment/socialcrawl-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Versions

- **1.0.1** — security scan: pending review — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-ridiodevelopment-socialcrawl-mcp
- Seller: https://agentstack.voostack.com/s/ridiodevelopment
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.