# MediaGo Downloads

Downloads videos from m3u8 streams, Bilibili and direct URLs with MediaGo.

- Repository: https://github.com/mediago-dev/mediago (9345 stars)
- Category: Media
- License: MIT
- Last updated: 2026-10-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add mediago-dev/mediago --skill mediago -g -a claude-code -y`
Codex: `npx skills add mediago-dev/mediago --skill mediago -g -a codex -y`
Cursor: `npx skills add mediago-dev/mediago --skill mediago -g -a cursor -y`
Gemini CLI: `npx skills add mediago-dev/mediago --skill mediago -g -a gemini-cli -y`

## Description

Download videos from m3u8/HLS streams, Bilibili, and direct URLs using MediaGo. 下载视频、m3u8直播流、B站视频。 Triggers on: download video, 下载视频, 下载这个链接, 帮我下载, m3u8 download, 设置mediago地址, configure mediago, mediago api key. Requires a running MediaGo instance (desktop app or Docker).

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# MediaGo Video Downloader

Download videos from m3u8/HLS streams, Bilibili, and direct URLs via a running MediaGo instance.

## Configuration

Config file: `~/.mediago-skill.json`

```json
{
  "url": "http://localhost:8899",
  "apiKey": ""
}
```

### First-time Setup / 首次配置

If `~/.mediago-skill.json` does not exist, show the following message (respond in the user's language):

> EN: "MediaGo is not configured yet. To use this skill:
>
> **1. Install MediaGo** (if you haven't already):
>
> - Desktop app: Download from https://github.com/caorushizi/mediago/releases
> - Docker: `docker run -d --name mediago -p 8899:8899 -v /path/to/mediago:/app/mediago ghcr.io/caorushizi/mediago:latest`
>
> **2. Initialize**, tell me your MediaGo address, for example:
>
> - Docker: `设置 mediago 地址为 http://localhost:8899`
> - Desktop app: `设置 mediago 地址为 http://192.168.x.x:39719`"
>
> CN: "MediaGo 还没有配置。要使用此功能：
>
> **1. 安装 MediaGo**（如果还没装）：
>
> - 桌面客户端：从 https://github.com/caorushizi/mediago/releases 下载安装
> - Docker 部署：`docker run -d --name mediago -p 8899:8899 -v /path/to/mediago:/app/mediago ghcr.io/caorushizi/mediago:latest`
>
> **2. 初始化配置**, 告诉我你的 MediaGo 地址，例如：
>
> - Docker：`设置 mediago 地址为 http://localhost:8899`
> - 桌面客户端：`设置 mediago 地址为 http://192.168.x.x:39719`"

When the user provides the URL (and optionally an API key), write it to `~/.mediago-skill.json`.

### Updating Config / 更新配置

Trigger on phrases like:

- EN: "set mediago url to ...", "mediago api key is ...", "my mediago is at ..."
- CN: "设置 mediago 地址为 ...", "mediago api key 是 ...", "我的 mediago 跑在 ..."

Read the existing config, update the relevant field, and write it back.

## API Reference

All API calls use `curl`. Read `url` and `apiKey` from `~/.mediago-skill.json` before each call.

If `apiKey` is set, add header: `-H "X-API-Key: API_KEY"`

### Health Check

```
curl -s BASE_URL/healthy
```

Returns `{"success":true,...}` if service is running.

### Create & Start Download

The rest: https://github.com/mediago-dev/mediago/blob/HEAD/skills/mediago/SKILL.md