English Français العربية

ssave.cc — TikTok & Instagram Downloader

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

Extract & download TikTok, Instagram, YouTube, Douyin media — HD, no watermark, MP3 export

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

التثبيت

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

NPM package @ssavecc/mcp-server
Claude Code 
claude mcp add ssave-cc-tiktok-instagram-downloader -e 'YOUR_API_KEY=<your your_api_key>' -- npx -y @ssavecc/mcp-server@0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "ssave-cc-tiktok-instagram-downloader": {
            "command": "npx",
            "args": [
                "-y",
                "@ssavecc/mcp-server@0.1.1"
            ],
            "env": {
                "YOUR_API_KEY": "<your your_api_key>"
            }
        }
    }
}

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

  • YOUR_API_KEY إلزامي سري Your API key for the service

التوثيق

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

المحتويات
  1. @ssavecc/mcp-server
  2. Quick Start
  3. Tools
  4. Environment Variables
  5. Rate Limits (free tier)
  6. Development
  7. Legal
  8. License

@ssavecc/mcp-server

Model Context Protocol (MCP) server for Ssave.cc — extract and download TikTok / Instagram / YouTube / Douyin media (HD video without watermark, MP3 audio) directly to your local disk.

Runs locally via stdio, backed by the Ssave Open API (/open/v1). No registration required on the free tier.

Quick Start

npx @ssavecc/mcp-server

Then add it to your MCP client:

Claude Code
claude mcp add ssave -- npx @ssavecc/mcp-server

Or project-level .mcp.json:

{
  "mcpServers": {
    "ssave": { "command": "npx", "args": ["@ssavecc/mcp-server"] }
  }
}
Cursor

Settings → MCP → Add new MCP server:

{
  "mcpServers": {
    "ssave": {
      "command": "npx",
      "args": ["@ssavecc/mcp-server"]
    }
  }
}
Claude Desktop

Edit claude_desktop_config.json:

{
  "mcpServers": {
    "ssave": {
      "command": "npx",
      "args": ["@ssavecc/mcp-server"]
    }
  }
}

Tools

ToolDescription
extract_mediaExtract metadata and available formats from a TikTok / Instagram / YouTube / Douyin URL. Returns an ssv_ token (expires in 5–15 min) plus per-format download URLs.
download_mediaStream the extracted media to local disk (default ~/Downloads/ssave/, override with output_dir). Returns the absolute path and size.
get_thumbnailSave the media thumbnail to local disk (proxied — never exposes the source CDN link).

Typical flow: extract_media(url) → take the returned id → download_media(id, type: "hd" | "watermark" | "mp3").

Environment Variables

All optional:

VariableDefaultDescription
SSAVE_API_BASE_URLhttps://api.ssave.ccOverride for local development (e.g. http://localhost:8000).
SSAVE_API_KEY—Reserved for paid tier (Phase 3): sent as Authorization: Bearer <key>.
SSAVE_OUTPUT_DIR~/Downloads/ssave/Default output directory when output_dir is not passed.

Rate Limits (free tier)

Shared with the Ssave Open API, per IP per UTC day:

OperationLimit
extract10 / day
download50 / day

On 429 rate_limited the tool reports the UTC reset time.

Development

npm install
npm run dev        # run server on stdio (connect with MCP Inspector: npx @modelcontextprotocol/inspector)
npm test           # unit tests (mock fetch)
npm run build      # compile to dist/

For personal archiving of content you have access to. Respect platform Terms of Service. No bulk downloading. See ssave.cc/privacy.

License

MIT

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

ما هو ssave.cc — TikTok & Instagram Downloader؟

Extract & download TikTok, Instagram, YouTube, Douyin media — HD, no watermark, MP3 export

كيف أثبّت ssave.cc — TikTok & Instagram Downloader؟

يعمل على جهازك. في Claude Code: claude mcp add ssave-cc-tiktok-instagram-downloader -e 'YOUR_API_KEY=<your your_api_key>' -- npx -y @ssavecc/mcp-server@0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج ssave.cc — TikTok & Instagram Downloader إلى مفتاح API؟

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

هل ssave.cc — TikTok & Instagram Downloader مفتوح المصدر؟

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

من يصون ssave.cc — TikTok & Instagram Downloader؟

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

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