yungle

npm install -g yungle-cli
yungle login                  # opens your browser, once
yungle send ./render.mov      # uploads resumably, prints the link

Yungle からリンクをメールで送信したい場合は、API キーでサインインし（yungle login --key）、 --to [email protected] を追加してください。ブラウザーでのサインインではリンクを作成できますが、メールは送信されません。そのため、フィッシングでサインインコードを盗まれても、見知らぬ相手にメールを送信することはできません。

内容

	インストール	用途
CLI	npm i -g yungle-cli brew install heindewilde/yungle/yungle	ターミナルや CI からファイルを送信、受信、同期します。双方向に対応し、フォルダー構成を維持してチェックサムを検証します。接続が切れたり、ノートパソコンのふたを閉じたりしても再開できます
MCP サーバー	Claude のディレクトリ https://yungle.co/mcp	1 回のサインインで Claude、Cursor、その他の MCP クライアントに接続できます。届いたファイルの確認、大容量ファイルの共有（Yungle が URL から取得できます）、受け取ったファイルのダウンロードができ、送信ごとに承認を求めます
TypeScript SDK	npm i yungle-client	依存関係なしで API 全体を型付きで利用できます。任意の Blob からの再開可能なアップロードにも対応します。Node、Bun、Deno、エッジランタイムで動作します
Python SDK	pip install yungle	Python から API を利用できます。アップロードを処理する、1 回の呼び出しで使える send() を備えています
GitHub Action	uses: heindewilde/yungle-send-action@v1	CI からクライアントにビルド成果物を送信し、リンクを出力として受け取ります
例		GitHub Actions、夜間レポートなどについては、docs.yungle.co/guides/send-from-ciをご覧ください

すべてのツールは同じ公開 REST API （OpenAPI 3.1）を利用しており、変更のたびに CI でこれらのクライアントを検証しています。

CLI

人にとって使いやすく、スクリプトにとって予測しやすいように作られています。ターミナルでは見やすく、パイプで渡すとリンクのみを出力し、--json では JSON を出力します。

yungle send ~/Shoot --to [email protected] --message "Final selects"   # send a folder
yungle send dist/ --json | jq -r .url                               # in a script
yungle get https://yungle.co/t/emerald-palm-a5mt                    # download, no account needed
yungle send --from-url "https://bucket.s3.eu-central-1.amazonaws.com/render.mov?…"   # Yungle fetches it
yungle pull --collection 01J8Z3M9Q0W4                               # your collection, to disk
yungle status                                                       # who downloaded what
yungle watch ~/Renders --collection 01J8Z3M9Q0W4                    # upload new files as they land
yungle webhooks listen --forward-to http://localhost:8080/hooks     # test webhooks locally

• 再開可能な大容量アップロード。 yungle send を中断して再実行すると、最初からやり直すのではなく、最後にコミットされたパートから続行します。
• 指定が抜けている場合は案内します。 yungle send だけを実行すると、何を誰に送るかを尋ねます。CI では尋ねず、--json または --yes を指定した場合も尋ねません。スクリプトが質問で止まることはありません。
• エラーには解決方法が表示されます。 失敗時には、問題を解決するコマンドが最後に表示されます。入力ミスには もしかして の候補を示します。
• zsh、bash、fish のタブ補完： yungle completion zsh。

詳しいリファレンス：apps/cli · docs.yungle.co/cli

AI アシスタントを接続する

Claude の場合： Claude のコネクターディレクトリから Yungle を追加し、サインインします。

それ以外の環境（Cursor、VS Code、任意の MCP クライアント）：Yungle をリモート MCP サーバーとして追加し、一度サインインします。コピーするキーはありません。

https://yungle.co/mcp

その後、「Anna は最終版のセットをダウンロードしましたか？」、「今週、有効期限が切れるファイルはどれですか？」、「この 3 つのファイルをクライアントと共有して。」、「S3 バケットにあるレンダリングをクライアントに送って。」、*「Anna が送ってくれたリンクには何が入っていますか？」*といった質問をします。チャットでは 40 GB のファイルを送れないため、アシスタントはファイルを送信しません。Yungle がファイルのある場所から取得するか、アシスタントがシェルでファイル 1 つを送る npx yungle-cli put コマンドを実行します。アシスタントが準備し、メールが送信される前に毎回、あなたが送信を承認します。削除、取り消し、招待を行うツールはありません。また、ファイル名にプロンプトインジェクションが含まれる可能性があるため、サーバーが返すすべての内容には信頼できないデータというラベルが付けられます。

API キーを使うローカルサーバーをお求めですか？yungle mcp install を実行すると、Claude Desktop、Claude Code、Cursor、Windsurf の設定が書き込まれます。詳細はpackages/mcp-serverをご覧ください。

SDK

import { YungleClient } from 'yungle-client';

const yungle = new YungleClient({ apiKey: process.env.YUNGLE_API_KEY! });
for await (const t of yungle.allTransfers()) console.log(t.title, t.downloadCount);

from yungle import Yungle

sent = Yungle().send(["render.mov"], to=["[email protected]"], message="Final cut")
print(sent["url"])

どちらの SDK も、安全に再試行できる処理を再試行し、すべての POST に Idempotency-Key を付与するため、再試行してもコピーが二重に作成されることはありません。また、カーソルページネーションを自動で処理し、Webhook の署名を検証します。

Webhook

ポーリングする代わりに、通知を受け取れます。transfer.ready、transfer.downloaded、transfer.expiring、transfer.expired、有料プランでは collection.file_uploaded が通知されます。各通知には HMAC-SHA256 の署名が付けられ、バックオフを伴って再試行されます。公開 URL がない場合は、設定せずにイベントを取得できます。

import { verifyWebhook } from 'yungle-client';
const ok = await verifyWebhook(rawBody, req.headers['yungle-signature'], process.env.YUNGLE_WEBHOOK_SECRET!);

プランと制限

すべてのアカウントで API、CLI、MCP サーバーを利用できます。無料プランも対象です。最大 10 GB のファイル転送、連絡先、Webhook、あらゆるリンクからのダウンロードを利用できます。コレクションと、有効期限のないファイルは有料プランで利用できます。毎月最初の 10 GB の API アップロードは無料で、それ以降はプリペイドクレジットから 1 GB あたり €0.02 が差し引かれます。料金

Yungle を選ぶ理由

• ヨーロッパにあり、ヨーロッパの企業が運営しています。 ファイルは EU のインフラストラクチャに保存され、配信されます。
• 常に暗号化されています。 ファイルごとに個別のキーが付与され、必要に応じてブラウザーで転送をエンドツーエンド暗号化できます。
• 持続可能です。 PUE 1.13 のデータセンターで、再生可能な水力発電を利用しています。 これが意味すること、意味しないこと。

ここからはアクセスできません： あなたの保管庫とエンドツーエンド暗号化された転送です。これらのキーはブラウザー内で導出され、Yungle に送信されないため、API から読み取ることはできません。API でできないことをご覧ください。

コントリビュート

pnpm install
pnpm typecheck && pnpm lint && pnpm test && pnpm build
pnpm contract   # check the clients (operations and types) against the live OpenAPI spec

このリポジトリではクライアントを開発しています。Yungle サービス自体はオープンソースではありません。Issue とプルリクエストを歓迎します。CONTRIBUTING.mdをご覧ください。セキュリティに関する報告はsecurity.txtからお送りください。

MIT