# Soclip

> Soclip is a freemium MCP server for web search and scraping. Turn TikTok, Instagram, X and Facebook video URLs into download links and metadata. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://soclip.dev
- **Repository:** https://github.com/huangyunbin/soclip-mcp
- **MCP Registry name:** io.github.huangyunbin/soclip
- **Categories:** web search and scraping
- **Listing updated:** 2026-11-16

## About

Soclip's server takes a social video URL and returns direct media links with metadata. Two tools exist: get_video_media extracts links and details from a TikTok, Instagram, X or Facebook URL at 2 credits per request, and get_balance reports remaining credits. The response is one JSON object with title, author, duration, thumbnail and links sorted by quality.

Platform behaviour per the site: TikTok returns HD and SD MP4 without a watermark plus the soundtrack as audio, Instagram carousels return every image with its own link, X returns MP4 links with tweet text and handle, and Facebook handles public Reels, videos and share links. The same service has an HTTP API and a CLI, and it describes uses such as feeding audio or SD video to speech-to-text, archiving your own content and trend monitoring.

An API key from the dashboard is required in SOCLIP_API_KEY. New accounts get 500 free credits, enough for 250 extractions. Credits cost $0.001 each, never expire, and are sold in one-time packs from $5 for 6,000 credits to $99 for 180,000. The site says it handles IP rotation and anti-scraping measures for you, so check platform terms before use.

## Features

- **Four platforms, one schema:** TikTok, Instagram, X and Facebook return the same JSON shape.
- **Quality-sorted links:** Direct media links ordered by quality with metadata.
- **Watermark-free TikTok:** TikTok video comes without the watermark, plus separate audio.
- **Credit balance tool:** get_balance shows remaining credits.
- **HTTP API and CLI:** Same extraction through an API call or the soclip CLI.
- **Non-expiring credits:** Prepaid credits never expire.

## Good for

- Get an audio file from a post to transcribe
- Back up videos your brand published
- Collect public posts for trend monitoring
- Let an assistant turn a pasted link into a file

## Install

### Claude Code (Terminal)

```sh
claude mcp add soclip --env SOCLIP_API_KEY='<SOCLIP_API_KEY>' -- npx -y soclip-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "soclip": {
      "command": "npx",
      "args": [
        "-y",
        "soclip-mcp"
      ],
      "env": {
        "SOCLIP_API_KEY": "<SOCLIP_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "soclip": {
      "command": "npx",
      "args": [
        "-y",
        "soclip-mcp"
      ],
      "env": {
        "SOCLIP_API_KEY": "<SOCLIP_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "soclip": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "soclip-mcp"
      ],
      "env": {
        "SOCLIP_API_KEY": "<SOCLIP_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "soclip": {
      "command": "npx",
      "args": [
        "-y",
        "soclip-mcp"
      ],
      "env": {
        "SOCLIP_API_KEY": "<SOCLIP_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "soclip": {
      "command": "npx",
      "args": [
        "-y",
        "soclip-mcp"
      ],
      "env": {
        "SOCLIP_API_KEY": "<SOCLIP_API_KEY>"
      }
    }
  }
}
```

## Tools

- `get_video_media`: Extracts direct video links and metadata from a social video URL.
- `get_balance`: Checks the remaining credit balance.

## FAQ

### How much does a request cost?

get_video_media costs 2 credits, or $0.002.

### Do I get free credits?

Yes, 500 free credits on signup, enough for 250 extractions.

### Is an API key needed?

Yes, set SOCLIP_API_KEY from the dashboard.

### Do credits expire?

No, they never expire.

### Is Soclip free?

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

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

Run this command in your terminal: claude mcp add soclip --env SOCLIP_API_KEY='<SOCLIP_API_KEY>' -- npx -y soclip-mcp

### What are the best alternatives to Soclip?

The closest alternatives to Soclip are Scrapling MCP Server, Firecrawl MCP Server, SearXNG Search, NeuralVerge and AI-Powered directory.

## Alternatives

- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [SearXNG Search](https://ai-powered.com/mcp/searxng-search): SearXNG Search is an open-source MCP server for web search and scraping.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [AI-Powered directory](https://ai-powered.com/mcp/ai-powered-directory): AI-Powered directory is a free MCP server for developer tools.
- [Shopify MCP Server (any store)](https://ai-powered.com/mcp/shopify-mcp-server-any-store): Shopify MCP Server (any store) is a paid MCP server for e-commerce.
- [Chanroll: YouTube Channel Video Scraper (Official API)](https://ai-powered.com/mcp/chanroll-youtube-channel-video-scraper-official-api): Chanroll: YouTube Channel Video Scraper (Official API) is a paid MCP server for design and media.
- [Vidvett: YouTube Video Details Scraper (Official API)](https://ai-powered.com/mcp/vidvett-youtube-video-details-scraper-official-api): Vidvett: YouTube Video Details Scraper (Official API) is a paid MCP server for design and media.

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