# X Media Parser

> 解析 X/Twitter 帖子，获取图片和视频的下载直链。使用 vxtwitter API，无需登录。

- Skill: `dvcrn/x-media-parser` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add dvcrn/x-media-parser`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/x-media-parser/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/x-media-parser

---


# X Media Parser

解析 X/Twitter 帖子，获取图片和视频的下载直链。

## 功能

- ✅ 解析 X/Twitter 帖子
- ✅ 获取图片直链（支持多图）
- ✅ 获取视频直链（支持多视频）
- ✅ 无需登录/X API Key
- ✅ 支持 GIF
- ✅ 返回媒体元信息（分辨率、时长等）

## 使用方法

### 命令行

```bash
x-media-parser "https://x.com/user/status/1234567890"
```

### 返回格式

```json
{
  "success": true,
  "media": {
    "type": "video",
    "title": "用户名: 贴文内容",
    "directUrl": "https://video.twimg.com/...",
    "videoUrls": ["..."],
    "imageUrls": null,
    "thumbnail": "https://pbs.twimg.com/...",
    "duration": 120,
    "resolution": "1920x1080"
  }
}
```

### 媒体类型

- `video` - 单视频
- `videos` - 多视频
- `image` - 单图片
- `images` - 多图片
- `mixed` - 混合（视频+图片）

## 底层实现

使用 vxtwitter API: `https://api.vxtwitter.com/Twitter/status/{tweetId}`

## 依赖

- curl
- python3

## 配合 Aria2 使用

```bash
# 解析帖子
JSON=$(x-media-parser "https://x.com/user/status/123")

# 提取直链
URL=$(echo "$JSON" | python3 -c "import sys,json; print(json.load(sys.stdin)['media']['directUrl'])")

# 发送到 Aria2 下载
aria2-download "$URL"
```

## 一键下载脚本

同目录下提供 `x-aria-download.sh`，可一键解析并下载：

```bash
x-aria-download "https://x.com/user/status/123"
```

文件名格式：`昵称_贴文前10字_编号.扩展名`