Skip to content
 
 

Repository files navigation

聚合解析流媒体平台链接,转换为媒体直链发送

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/...
视频、图片

🚀 快速开始

安装

  1. 依赖库:打开 AstrBot WebUI → 控制台 → 安装 Pip 库,输入 aiohttp 并安装
  2. 插件:打开 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 格式再发送
  • 其他:插件会跳过包含 "原始链接:" 字段的消息,防止重复解析

🙏 鸣谢

About

适配 AstrBot 的插件,聚合解析流媒体平台链接,转换为媒体直链发送

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages