聚合解析流媒体平台链接，转换为媒体直链发送
AstrBot 插件，支持自动解析流媒体平台链接，获取媒体元数据转换为直链发送
📺 支持的流媒体平台
| 平台 | 支持的链接类型 | 可解析的媒体类型 |
|---|---|---|
| B站 | 短链（b23.tv/...）视频av号（ www.bilibili.com/video/av...）视频BV号（ www.bilibili.com/video/BV...）动态长链（ www.bilibili.com/opus/...）动态短链（ t.bilibili.com/...）小程序卡片（ message.meta.detail_1.qqdocurl） |
视频、图片 |
| 抖音 | 短链（v.douyin.com/...）视频长链（ www.douyin.com/video/...）图集长链（ www.douyin.com/note/...） |
视频、图片 |
| 快手 | 短链（v.kuaishou.com/...）视频长链（ www.kuaishou.com/short-video/...） |
视频、图片 |
| 微博 | 桌面端博客链接（weibo.com/...）移动端博客链接（ m.weibo.cn/detail/...）移动端视频分享链接（ video.weibo.com/show?fid=...）视频分享链接重定向（ weibo.com/tv/show/...）小程序卡片（ message.meta.detail_1.qqdocurl） |
视频、图片 |
| 小红书 | 短链（xhslink.com/...）笔记长链（ www.xiaohongshu.com/explore/...）笔记长链（ www.xiaohongshu.com/discovery/item/...）小程序卡片（ message.meta.news.jumpUrl） |
视频、图片 |
| 小黑盒 | Web链接（www.xiaoheihe.cn/app/topic/game/...）App分享链接（ api.xiaoheihe.cn/game/share_game_detail?...）小程序卡片（ message.meta.news.jumpUrl） |
游戏页详情 |
| 推特 | twitter 链接（twitter.com/.../status/...）x 链接（ x.com/.../status/...） |
视频、图片 |
🚀 快速开始
安装
- 依赖库：打开 AstrBot WebUI → 控制台 → 安装 Pip 库，输入
aiohttp并安装 - 插件：打开 AstrBot WebUI → 插件市场搜索
astrbot_plugin_media_parser并安装
特性
- ✅ 无需配置任何 cookie
- ✅ 自动识别并解析链接
⚙️ 优化体验
配置 缓存目录 和打开 预下载模式 可显著提升解析成功率和发送体验。
原因：消息平台使用直链发送媒体时无法指定 header、referer、cookie 等参数，部分风控严格的平台会返回 403 Forbidden。
建议：同时配置缓存目录和开启预下载模式。
各平台特殊情况
硬性要求（必须预下载）
- 微博：所有视频必须正确携带 referer 参数才能下载
- 小黑盒：M3U8 格式必须将音视频分片下载到本地再合并
概率风控（建议预下载）
- 小红书：部分媒体使用 URL 发送有概率风控
提高性能（可选）
- B站、Twitter/X：支持 Range 请求，配置缓存目录后可并发下载提升速度
💡 Range 下载仅为性能优化，未配置缓存目录时会自动退化为单文件下载模式
📝 注意事项
- B站：转发动态会使用
"转发动态数据（原始动态数据）"组织文本格式解析结果 - 小红书：链接有身份验证和时效性，分享链接解析结果有水印
- 小黑盒：不携带 token 只能解析游戏页详情，游戏预览视频下载速度不佳时请启用代理
- 推特：解析 api 使用 fxtwitter 服务可直连，图片 cdn 大多被墙建议开启代理，视频 cdn
可直连近期大多被墙建议开启代理 - 图片处理 格式除
.jpg,.jpeg,.png外的所有图片会先转换为.png格式再发送 - 其他：插件会跳过包含
"原始链接："字段的消息，防止重复解析
🙏 鸣谢
- bilibili-API-collect - B站解析端点
- FxEmbed - 推特解析服务
- tianger-mckz - QQ小程序卡片链接提取方法
- CSDN 博客 - 抖音解析方法