聚合解析流媒体平台链接,转换为媒体直链发送
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 博客 - 抖音解析方法