Yukisbox (yukiapi.site) 📦

Yukisbox (https://yukiapi.site) is the modern, privacy-first anonymous file hosting platform, pastebin, and public Telegram link converter with Zero IP Logs, 2GB File Limit, and 100% Ad-Free Cloud Delivery.

🌐 Quick Links & Resources

• 🏠 Web Interface: https://yukiapi.site
• 🚀 Interactive Install Guide: https://yukiapi.site/install
• 📰 Product News & Changelogs: https://yukiapi.site/news
• 📚 REST API Documentation: https://yukiapi.site/docs
• 🤖 Model Context Protocol (MCP) Server: https://yukiapi.site/mcp
• 🧠 AI Agent Documentation (llms.txt): https://yukiapi.site/llms.txt
• 🐍 PyPI Package Index: https://pypi.org/project/yukisbox/
• 🟢 NPM Package Index: https://www.npmjs.com/package/yukisbox

⚡ Installation & CLI Tool

Yukisbox provides official, zero-dependency CLI tools and SDKs for Node.js (NPM & NPX), Python (PyPI), and direct 1-line installers.

1. Install via Node.js (NPM & NPX)

# Option A: Install globally via npm
npm install -g yukisbox

# Option B: Run instantly without installing via npx
npx yukisbox stats

2. Install via Python (PyPI)

pip install --upgrade yukisbox

3. Automated 1-Line Bash Script (Linux, macOS, Termux)

curl -sSL https://yukiapi.site/install.sh | bash

4. Direct Server Node Installation

# Python Wheel direct from Yukisbox node
pip install https://yukiapi.site/dist/yukisbox-1.0.0-py3-none-any.whl

# Node.js Tarball direct from Yukisbox node
npm install -g https://yukiapi.site/dist/yukisbox.tgz

💻 CLI Commands & Usage

# 1. Check Live Server Health & Operational Uptime
yukisbox stats

# 2. Upload Local File (Up to 2GB) with Custom Slug and Password
yukisbox upload video.mp4 --slug my-video --password 1234

# 3. Convert Public Telegram Channel Post Media to Direct Link
yukisbox telegram https://t.me/channel_name/123

# 4. Mirror & Host Remote URL File
yukisbox url https://example.com/data.tar.gz

# 5. Create Instant Code Snippet / Pastebin
yukisbox paste script.js --filename main.js

# 6. Inspect File Metadata (Size, MIME, Downloads)
yukisbox info abc123xy

🛠 Programmatic SDK Examples

🟢 Node.js / JavaScript SDK

const { uploadFile, uploadTelegram, createPaste, getStats } = require('yukisbox');

async function run() {
    // 1. Upload File
    const fileRes = await uploadFile('photo.jpg', { slug: 'my-photo' });
    console.log('File URL:', fileRes.url);

    // 2. Convert Telegram Link
    const tgRes = await uploadTelegram('https://t.me/channel/123');
    console.log('Telegram Direct Link:', tgRes.url);

    // 3. Create Paste
    const pasteRes = await createPaste('console.log("Hello Yukisbox");', { filename: 'app.js' });
    console.log('Paste Raw URL:', pasteRes.raw_url);
}

run();

🐍 Python SDK / REST API

import requests

# 1. Upload File (up to 2GB)
with open("video.mp4", "rb") as f:
    resp = requests.post("https://yukiapi.site/v1/upload", files={"file": f}, data={"custom_slug": "my-video"})
print("File URL:", resp.json()["url"])

# 2. Convert Telegram Post Media
resp = requests.post("https://yukiapi.site/v1/upload-telegram", data={"url": "https://t.me/channel/123"})
print("Direct Link:", resp.json()["url"])

# 3. Create Pastebin Snippet
resp = requests.post("https://yukiapi.site/v1/upload-text", data={"text": "print('hello')", "filename": "main.py"})
print("Raw URL:", resp.json()["raw_url"])

🐚 cURL (Terminal / Bash)

# Upload File
curl -X POST -F "file=@archive.zip" https://yukiapi.site/v1/upload

# Convert Telegram Media
curl -X POST -F "url=https://t.me/channel/123" https://yukiapi.site/v1/upload-telegram

🤖 Model Context Protocol (MCP) Server for AI Agents

Yukisbox comes equipped with native Streamable HTTP and JSON-RPC 2.0 Model Context Protocol (MCP) support for autonomous AI assistants (Claude Desktop, Cursor, Copilot, LangChain).

Add to Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "yukisbox": {
      "command": "npx",
      "args": ["-y", "yukisbox", "stats"],
      "env": {}
    }
  }
}

Or connect directly via HTTP SSE:

• SSE Endpoint: https://yukiapi.site/mcp/sse
• JSON-RPC Endpoint: POST https://yukiapi.site/mcp
• Manifest: https://yukiapi.site/.well-known/mcp.json

🔥 Key Platform Features

• 🛡️ Zero IP Logs: Absolute privacy. We do not store, index, or sell client IP addresses.
• ⚡ 2GB File Limit: Generous file hosting limit with high-speed video range seeking (206 Partial Content).
• 🕒 Dynamic Operational Telemetry: Real-time server uptime calculation.
• 🔒 Optional Password Encryption & Self-Destruct: Burn-after-reading protection (max_downloads=1).
• 💬 Rich Discord & Telegram Embeds: Instant inline video and image playback.
• 🧩 Pastebin & Raw Endpoints: Raw text endpoints (/raw/{uid}) with CORS enabled.

📜 License & Author

• Author: SUDEEPBOTS (@Z0iiw)
• License: MIT License
• Support & Inquiries: hello@yukiapi.site