io.github.huangyunbin/soclip
Turn TikTok, Instagram, X and Facebook URLs into video download links and metadata.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
soclip-mcpclaude mcp add soclip -e 'SOCLIP_API_KEY=<your soclip_api_key>' -- npx -y soclip-mcp@0.1.4
{
"mcpServers": {
"soclip": {
"command": "npx",
"args": [
"-y",
"soclip-mcp@0.1.4"
],
"env": {
"SOCLIP_API_KEY": "<your soclip_api_key>"
}
}
}
}
Variables d'environnement
SOCLIP_API_KEYobligatoire secret soclip API key from https://soclip.dev/dashboard (500 free credits on signup)
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
soclip-mcp
Model Context Protocol (MCP) server for soclip.dev - allow AI assistants like Claude Desktop and Cursor to extract social video media direct links and metadata.
Overview
soclip-mcp connects LLMs with the Soclip API to analyze and retrieve direct video download URLs and metadata from TikTok, Instagram, X/Twitter and Facebook.
Get your API key at https://soclip.dev.
Docs for
soclip-mcp@0.1.4— last updated 2026-10-07. Plain-text docs for AI agents: https://soclip.dev/llms.txt
Setup & Configuration
Claude Desktop
Add soclip to your claude_desktop_config.json (located at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows):
{
"mcpServers": {
"soclip": {
"command": "npx",
"args": ["-y", "soclip-mcp"],
"env": {
"SOCLIP_API_KEY": "your-api-key-here"
}
}
}
}
Cursor
Add to your Cursor MCP settings (.cursor/mcp.json or Cursor Settings -> Features -> MCP Servers):
{
"mcpServers": {
"soclip": {
"command": "npx",
"args": ["-y", "soclip-mcp"],
"env": {
"SOCLIP_API_KEY": "your-api-key-here"
}
}
}
}
Note: If you have already set up your key using the CLI (soclip config set-key <key>), soclip-mcp will automatically read ~/.soclip/config.json if SOCLIP_API_KEY is not present in env.
Available Tools
1. get_video_media
Extract direct video download URLs and detailed metadata from a social media video URL. Costs 2 credits ($0.002) per request.
- Parameters:
url(string, required): The video link (TikTok, Instagram, X/Twitter or Facebook).
2. get_balance
Check your current account remaining credit balance.
- Parameters: None.
Documentation
- Full docs: https://soclip.dev/docs
- Plain-text docs for AI agents: https://soclip.dev/llms.txt
- Terminal CLI:
soclip-cli
License
MIT License © 2026 soclip
Questions fréquentes
Qu'est-ce que io.github.huangyunbin/soclip ?
Turn TikTok, Instagram, X and Facebook URLs into video download links and metadata.
Comment installer io.github.huangyunbin/soclip ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add soclip -e 'SOCLIP_API_KEY=<your soclip_api_key>' -- npx -y soclip-mcp@0.1.4. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.huangyunbin/soclip ?
Oui. Il attend SOCLIP_API_KEY, à renseigner dans sa configuration.
io.github.huangyunbin/soclip est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.huangyunbin/soclip ?
Il est publié par huangyunbin. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.