コマンドラインと自動化

MDMは、ウィンドウを表示せずに次の3つの方法で操作できます。

• アプリ独自のコマンドライン。IDMと同じスイッチを使用します。スクリプト、バッチファイル、または別のプログラムから実行中のアプリにダウンロードを渡します。
• misterdownloadmanager-cli。別のコマンドラインツールです。アプリなしで、進行状況を表示しながら、ターミナルでファイル、ビデオ、トレントをダウンロードします。
• 自動化API。他のプログラムが、ローカルのトークン保護されたチャネルを介して、実行中のアプリのダウンロードを（JSONとして）一覧表示し、一時停止、開始、削除、または消去します。AIアシスタントはMDMのMCPサーバーを介してこれを使用します。詳しくはAIアシスタントをご覧ください。

例ではWindowsのパスを使用しています。macOSとLinuxでは、プログラムは.exeなしで同じ名前です。

アプリのコマンドライン

misterdownloadmanager.exe /d URL [/p folder] [/f name] [/a] [/n] [/s]

スイッチは/または-で始まり、大文字小文字は問いません。MDMが実行中の場合、コマンドはMDMに送られます。実行中でない場合、MDMが起動して実行します。例：

misterdownloadmanager.exe /d https://example.com/files/report.pdf /p D:\Reports /n
misterdownloadmanager.exe /d https://example.com/big.iso /a
misterdownloadmanager.exe /s

misterdownloadmanager-cli

MDMのすべてのダウンロードにアプリの隣に付属しています（インストーラーはMDMのフォルダーに入れます）。statusとapiを除いて、アプリが実行されている必要はありません。

misterdownloadmanager-cli help <command>すべてのオプションを表示します。コマンドが失敗した場合（アプリが実行されていない、エラーで応答する、ダウンロードが中断する）は、コード1で終了します。例：

misterdownloadmanager-cli get https://example.com/big.iso -o D:\Downloads -c 16 --checksum sha256:9f86d0…
misterdownloadmanager-cli video-get "https://www.youtube.com/watch?v=aqz-KE-bpKQ" -f "b[height=720]"
misterdownloadmanager-cli torrent-get "magnet:?xt=urn:btih:…" --files 0

スクリプトとプログラムのためのJSON

--json（コマンドの前または後）を使用すると、すべてのコマンドはテキストの代わりにJSONを出力します。スクリプトやAIエージェントが読み取れるように、1行に1つのオブジェクトです。

サイズはバイト（不明な場合はnull）、速度はバイト/秒です。失敗すると{"error": "…"}を出力し、コード1で終了します。例：

misterdownloadmanager-cli --json get https://example.com/big.iso -o D:\Downloads
{"event":"progress","downloaded":4194304,"size":1073741824,"speed":52428800,"connections":8,"segments":8}
…
{"event":"done","path":"D:\\Downloads\\big.iso","size":1073741824,"seconds":20.4}

自動化API

他のプログラムは、実行中のアプリが何をダウンロードしているかを問い合わせたり、ダウンロードを一時停止、開始、削除したりできます。APIはデフォルトでオフです。misterdownloadmanager-cli api onでオンにし（api offでオフにします）。

プログラムがMDMと通信する方法

1. MDMは実行中に127.0.0.1のポート（このコンピューターのみ）でリッスンし、そのデータフォルダー内のipc.jsonにポートと秘密トークンを書き込みます。 - Windows: %APPDATA%\misterdownloadmanager\ipc.json - macOS: ~/Library/Application Support/misterdownloadmanager/ipc.json - Linux: ~/.local/share/misterdownloadmanager/ipc.json - ポータブルコピー: プログラムの隣のdata\ipc.json。

トークンは起動ごとに変更されます。データフォルダーを読み取れるプログラム（あなたのもの）のみが使用できます。 2. そのポートに接続し、JSONの1行を送信します。トークンとコマンドのフィールドです。例：{"token": "<token>", "query": "list"}。 3. MDMは1行で応答します。コマンドの場合はok、質問の場合はJSONオブジェクトです。

理解できること

不明な質問またはアクションは{"error": "…"}と応答されます。APIがオフの場合の質問も同様です（その場合は"code": "api-off"で、プログラムが確認できるようにします。エラーテキストは変更される可能性があります）。間違ったトークンはdeniedと応答されます。

すべてのリクエストと応答は、フィールドごとにJSONスキーマで記述されています。automation-api.schema.json（https://misterdownloadmanager.com/automation-api.schema.jsonにもあります）。これはアプリが応答するコードから作成されているため、正確な状態が保たれます。プログラムは、送信および読み取りするものをこれに対してチェックしたり、これに基づいて型を生成したりできます。

例

PowerShell (Windows):

$ep = Get-Content "$env:APPDATA\misterdownloadmanager\ipc.json" | ConvertFrom-Json
$client = New-Object Net.Sockets.TcpClient("127.0.0.1", $ep.port)
$stream = $client.GetStream()
$writer = New-Object IO.StreamWriter($stream); $reader = New-Object IO.StreamReader($stream)
$writer.WriteLine((@{ token = $ep.token; query = "list" } | ConvertTo-Json -Compress))
$writer.Flush()
$reader.ReadLine() | ConvertFrom-Json | Select-Object -ExpandProperty downloads | Format-Table file, status, downloaded, size
$client.Close()

Python:

import json, os, socket

ipc = os.path.join(os.environ["APPDATA"], "misterdownloadmanager", "ipc.json")  # see above elsewhere
ep = json.load(open(ipc))
with socket.create_connection(("127.0.0.1", ep["port"])) as s:
    s.sendall((json.dumps({"token": ep["token"], "query": "list"}) + "\n").encode())
    answer = json.loads(s.makefile().readline())
for d in answer["downloads"]:
    print(d["file"], d["status"], d["downloaded"], d["size"])

代わりにダウンロードを追加するには、{"token": "…", "url": "https://example.com/a.zip", "silent": true}を送信してください。