English Français العربية

io.github.huangyunbin/soclip

السجل الرسمي التسويق والمبيعات

Turn TikTok, Instagram, X and Facebook URLs into video download links and metadata.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package soclip-mcp
Claude Code 
claude mcp add soclip -e 'SOCLIP_API_KEY=<your soclip_api_key>' -- npx -y soclip-mcp@0.1.4
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "soclip": {
            "command": "npx",
            "args": [
                "-y",
                "soclip-mcp@0.1.4"
            ],
            "env": {
                "SOCLIP_API_KEY": "<your soclip_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • SOCLIP_API_KEY إلزامي سري soclip API key from https://soclip.dev/dashboard (500 free credits on signup)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. soclip-mcp
  2. Overview
  3. Setup & Configuration
  4. Available Tools
  5. Documentation
  6. License

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

License

MIT License © 2026 soclip

الأسئلة الشائعة

ما هو io.github.huangyunbin/soclip؟

Turn TikTok, Instagram, X and Facebook URLs into video download links and metadata.

كيف أثبّت io.github.huangyunbin/soclip؟

يعمل على جهازك. في Claude Code: claude mcp add soclip -e 'SOCLIP_API_KEY=<your soclip_api_key>' -- npx -y soclip-mcp@0.1.4. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.huangyunbin/soclip إلى مفتاح API؟

نعم. يتطلب SOCLIP_API_KEY، وتضبطها في إعداداته.

هل io.github.huangyunbin/soclip مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.huangyunbin/soclip؟

ينشره huangyunbin. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.