ssave.cc — TikTok & Instagram Downloader

@ssavecc/mcp-server

Ssave.cc 用の Model Context Protocol（MCP）サーバーです。TikTok／Instagram／YouTube／Douyin のメディアを抽出してダウンロード（ウォーターマークなしの HD 動画、MP3 音声）し、ローカルディスクに直接保存します。

Ssave Open API（/open/v1）を利用し、stdio 経由でローカル実行します。無料プランでは登録不要です。

クイックスタート

npx @ssavecc/mcp-server

次に、MCP クライアントに追加します。

Claude Code

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

または、プロジェクトレベルの .mcp.json を使用します。

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

Cursor

設定 → MCP → 新しい MCP サーバーを追加：

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

Claude Desktop

claude_desktop_config.json を編集します。

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

ツール

ツール	説明
extract_media	TikTok／Instagram／YouTube／Douyin の URL からメタデータと利用可能なフォーマットを抽出します。ssv_ トークン（有効期限は 5～15 分）と、フォーマットごとのダウンロード URL を返します。
download_media	抽出したメディアをローカルディスクにストリーミング保存します（デフォルトは ~/Downloads/ssave/、output_dir で上書き可能）。絶対パスとサイズを返します。
get_thumbnail	メディアのサムネイルをローカルディスクに保存します（プロキシ経由で処理されるため、元の CDN リンクが公開されることはありません）。

一般的な流れ：extract_media(url) → 返された id を取得 → download_media(id, type: "hd" | "watermark" | "mp3")。

環境変数

すべて任意です。

変数	デフォルト	説明
SSAVE_API_BASE_URL	https://api.ssave.cc	ローカル開発用の上書き値です（例：http://localhost:8000）。
SSAVE_API_KEY	—	有料プラン用（フェーズ 3）に予約されています。Authorization: Bearer <key> として送信されます。
SSAVE_OUTPUT_DIR	~/Downloads/ssave/	output_dir が指定されていない場合のデフォルトの出力ディレクトリです。

レート制限（無料プラン）

Ssave Open API と共有され、UTC の 1 日あたり IP ごとに適用されます。

操作	制限
extract	1 日あたり 10 回
download	1 日あたり 50 回

429 rate_limited が発生すると、ツールは UTC でのリセット時刻を通知します。

開発

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/

法的事項

アクセス権のあるコンテンツを個人でアーカイブする目的でご利用ください。各プラットフォームの利用規約を遵守してください。一括ダウンロードは禁止されています。ssave.cc/privacy をご覧ください。

ライセンス

MIT