{"_id":"@chaojisizhu/koishi-plugin-video-parser-all","name":"@chaojisizhu/koishi-plugin-video-parser-all","dist-tags":{"latest":"1.3.0"},"versions":{"1.3.0":{"name":"@chaojisizhu/koishi-plugin-video-parser-all","description":"Koishi 全平台视频解析插件，支持抖音/快手/B站/微博/小红书/剪映/YouTube/TikTok等20+平台","version":"1.3.0","main":"lib/index.js","typings":"lib/index.d.ts","license":"MIT","scripts":{"build":"tsc","dev":"tsc -w","clean":"rimraf lib"},"keywords":["chatbot","koishi","plugin","video","parser","image","card","miniprogram","bilibili","douyin","kuaishou","weibo","toutiao","pipigx","pipixia","xigua","zuiyou","xiaohongshu","jianying","acfun","zhihu","weishi","huya","youtube","tiktok","haokan","meipai","quanmin","twitter","instagram","doubao","jimeng","debug","unified-api","视频解析"],"devDependencies":{"@koishijs/client":"^5.30.4","@koishijs/scripts":"^4.6.2","rimraf":"^5.0.5","typescript":"^5.3.3"},"dependencies":{"axios":"^1.16.1","fast-xml-parser":"^4.5.6","stream":"^0.0.3"},"peerDependencies":{"@koishijs/plugin-console":"^5.30.4","koishi":"^4.18.7"},"repository":{"type":"git","url":"git+https://github.com/chaojisizhu/koishi-plugin-video-parser-all.git"},"bugs":{"url":"https://github.com/chaojisizhu/koishi-plugin-video-parser-all/issues"},"homepage":"https://github.com/chaojisizhu/koishi-plugin-video-parser-all#readme","engines":{"node":">=16.0.0"},"gitHead":"9a3fb8233ef9793e45cf21c4c65603a855dd22a5","_id":"@chaojisizhu/koishi-plugin-video-parser-all@1.3.0","_nodeVersion":"24.18.1","_npmVersion":"12.0.2","dist":{"integrity":"sha512-5YwvPSErR26bF/dAbLEeH8IWV3knPShD3fTcFt0VeDd/ONPDVO+ab/cnqHIqPxql1onFEHmzZVuc79J/wnyyFQ==","shasum":"57ea08d38d40485253b4a9f46f0aad3006d0cf35","tarball":"https://registry.npmjs.org/@chaojisizhu/koishi-plugin-video-parser-all/-/koishi-plugin-video-parser-all-1.3.0.tgz","fileCount":4,"unpackedSize":79402,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIEi76CcGdenkOyVDqkmFk//boA0bSZOlX3em9Jdc5JMdAiBbRtWHBhPjq7KOhd+FLB6f8kCVz3b+ZHF2/uUWxfVJDQ=="}]},"_npmUser":{"name":"chaojisizhu","email":"ailixiya59@gmail.com"},"directories":{},"maintainers":[{"name":"chaojisizhu","email":"ailixiya59@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/koishi-plugin-video-parser-all_1.3.0_1787492134969_0.30149265972861494"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-23T13:35:34.809Z","1.3.0":"2026-08-23T13:35:35.124Z","modified":"2026-08-23T13:35:35.310Z"},"maintainers":[{"name":"chaojisizhu","email":"ailixiya59@gmail.com"}],"description":"Koishi 全平台视频解析插件，支持抖音/快手/B站/微博/小红书/剪映/YouTube/TikTok等20+平台","homepage":"https://github.com/chaojisizhu/koishi-plugin-video-parser-all#readme","keywords":["chatbot","koishi","plugin","video","parser","image","card","miniprogram","bilibili","douyin","kuaishou","weibo","toutiao","pipigx","pipixia","xigua","zuiyou","xiaohongshu","jianying","acfun","zhihu","weishi","huya","youtube","tiktok","haokan","meipai","quanmin","twitter","instagram","doubao","jimeng","debug","unified-api","视频解析"],"repository":{"type":"git","url":"git+https://github.com/chaojisizhu/koishi-plugin-video-parser-all.git"},"bugs":{"url":"https://github.com/chaojisizhu/koishi-plugin-video-parser-all/issues"},"license":"MIT","readme":"# koishi-plugin-video-parser-all\n\n## 项目介绍 (Project Introduction)\n\n### 中文\n这是一个为 Koishi 机器人框架开发的**全平台视频/图集解析插件**，使用统一API接口，支持自动识别并解析抖音、快手、B站、小红书、微博、YouTube、TikTok、剪映、AcFun、知乎、虎牙等20+主流平台的短视频/图集/实况链接。\n\n### English\nThis is a **multi-platform video/image parsing plugin** developed for the Koishi bot framework, using a unified API interface to automatically recognize and parse short video/image/live photo links from 20+ mainstream platforms such as Douyin, Kuaishou, Bilibili, Xiaohongshu, Weibo, YouTube, TikTok, Jianying, AcFun, Zhihu, Huya and more. \n\n## 项目仓库 (Repository)\n- GitHub: `https://github.com/Minecraft-1314/koishi-plugin-video-parser-all`\n- Issues: `https://github.com/Minecraft-1314/koishi-plugin-video-parser-all/issues`\n\n## 核心指令 (Core Commands)\n\n| 指令 (Command) | 说明 (Description) | 示例 (Example) |\n|----------------|--------------------|----------------|\n| `parse <url>` | 手动解析指定的视频/图集链接 | `parse https://v.douyin.com/xxxx/` |\n\n## 配置项说明 (Configuration)\n\n### 基础设置\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `enable` | boolean | true | 是否启用视频解析插件 |\n| `botName` | string | 视频解析机器人 | 合并转发消息中显示的机器人名称 |\n| `showWaitingTip` | boolean | true | 解析时是否显示等待提示 |\n| `debug` | boolean | false | 是否开启 Debug 模式，在控制台输出详细日志 |\n\n### 平台独立开关设置\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `platformEnable` | object | 各平台均为 `true` | 各平台独立解析开关：关闭后将忽略对应平台的链接（不触发等待提示与解析）。支持的键：`bilibili`（哔哩哔哩）、`douyin`（抖音）、`kuaishou`（快手）、`xiaohongshu`（小红书）、`weibo`（微博）、`xigua`（西瓜视频）、`toutiao`（今日头条）、`youtube`（YouTube）、`tiktok`（TikTok）、`acfun`（AcFun）、`zhihu`（知乎）、`weishi`（微视）、`huya`（虎牙）、`haokan`（好看视频）、`meipai`（美拍）、`twitter`（Twitter/X）、`instagram`（Instagram）、`doubao`（豆包）、`pipigx`（皮皮搞笑）、`pipixia`（皮皮虾）、`zuiyou`（最右）、`jimeng`（即梦/剪映） |\n\n### 统一消息格式\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `unifiedMessageFormat` | string | `标题：${标题}\\n作者：${作者}\\n简介：${简介}\\n点赞：${点赞数}\\n收藏：${收藏数}\\n转发：${转发数}\\n播放：${播放数}\\n评论：${评论数}\\n图片数量：${图片数量}` | 自定义解析结果的输出格式，支持变量替换。某行所有变量为空（或为\"0\"）时自动隐藏该行 |\n\n### 内容显示设置\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `showImageText` | boolean | true | 是否发送解析后的文字内容 |\n| `showCover` | boolean | true | 是否发送视频封面图 |\n| `showVideoFile` | boolean | true | 是否发送视频文件（关闭则只发送视频链接） |\n| `maxDescLength` | number | 200 | 简介内容最大长度（字符），超出自动截断 |\n| `videoDownloadTimeout` | number | 120000 | 视频下载超时（毫秒） |\n| `tempDir` | string | `./temp_videos` | 临时视频存储目录 |\n| `maxVideoSize` | number | 0 | 最大下载视频大小（MB），0 为不限制大小 |\n| `forceDownloadVideo` | boolean | false | 强制下载视频后发送 |\n\n### 网络与 API 设置\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `timeout` | number | 180000 | API 请求超时时间（毫秒） |\n| `videoSendTimeout` | number | 60000 | 视频消息发送超时时间（毫秒，0 为不限制） |\n| `userAgent` | string | `Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/125.0.0.0 Safari/537.36` | API 请求使用的 User-Agent |\n\n### API 选择与回退设置\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `primaryApiUrl` | string | `https://api.bugpk.com/api/short_videos` | 主 API 地址，解析时优先使用 |\n| `backupApiUrl` | string | `https://api.bugpk.com/api/svparse` | 备用主 API 地址，仅支持抖音、小红书、Instagram、即梦平台解析 |\n| `isteroToken` | string | 空 | 全局起零数据 (Istero) API Token。若自定义平台未单独设置 Token 则自动复用 |\n| `isteroAppSecret` | string | 空 | 全局起零数据开发者密钥 AppSecret。用于 SHA256 动态签名防护 |\n| `isteroSignEnabled` | boolean | false | 全局起零数据是否默认开启动态签名防护 |\n| `platformDedicatedFirst` | object | 各平台均为 `false` | 各平台独立开关：是否优先使用平台专属 API。对象键为平台标识（英文），值为布尔值。支持的键：`bilibili`（哔哩哔哩）、`douyin`（抖音）、`kuaishou`（快手）、`xiaohongshu`（小红书）、`weibo`（微博）、`xigua`（西瓜视频）、`youtube`（YouTube）、`tiktok`（TikTok）、`acfun`（AcFun）、`zhihu`（知乎）、`weishi`（微视）、`huya`（虎牙）、`haokan`（好看视频）、`meipai`（美拍）、`twitter`（Twitter/X）、`instagram`（Instagram）、`doubao`（豆包） |\n| `customApis` | array | [] | 自定义平台专属 API 列表。每项包含：`platform`（平台类型）、`provider`（接口协议，可选 `bugpk` / `istero` / `custom`）、`apiUrl`（API 地址）、`token`（专属 Token）、`appSecret`（专属开发者密钥）、`enableSign`（是否开启动态签名）。可覆盖内置默认专属 API |\n\n#### 起零数据 (Istero) 接入示例\n以针对抖音单独接入起零数据为例，在 `customApis` 中添加：\n```json\n{\n  \"platform\": \"douyin\",\n  \"provider\": \"istero\",\n  \"apiUrl\": \"https://api.istero.com/resource/v2/video/analysis\",\n  \"token\": \"YOUR_ISTERO_API_TOKEN\",\n  \"appSecret\": \"YOUR_APP_SECRET\"\n}\n```\n并在 `platformDedicatedFirst` 中将 `douyin` 设为 `true` 即可优先调用起零接口。插件会自动构造 `Authorization: Bearer <token>` 及 `X-Signature`（SHA256 动态签名）、`X-Timestamp`、`X-Nonce` 等 Header。\n\n### 错误与重试设置\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `ignoreSendError` | boolean | true | 是否忽略消息发送失败，避免插件崩溃 |\n| `retryTimes` | number | 3 | API 请求及消息发送失败时的重试次数 |\n| `retryInterval` | number | 1000 | API 请求及消息发送重试的间隔时间（毫秒） |\n\n### 发送方式设置\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `enableForward` | boolean | false | 是否启用合并转发（仅 OneBot 平台），启用后视频与图文将整合进同一条合并消息 |\n\n### 去重设置\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `deduplicationInterval` | number | 180 | 禁止重复解析时间间隔（秒），0 为不限制。同一个链接在间隔内不会重复解析。 |\n\n### 界面文字设置\n| 配置项 | 类型 | 默认值 | 说明 |\n|--------|------|--------|------|\n| `waitingTipText` | string | 正在解析视频，请稍候... | 解析等待提示文字 |\n| `unsupportedPlatformText` | string | 不支持该平台链接 | 不支持的平台提示 |\n| `invalidLinkText` | string | 无效的视频链接 | 无效链接提示（parse 指令） |\n| `parseErrorPrefix` | string | ❌ 解析失败： | 解析失败消息前缀 |\n| `parseErrorItemFormat` | string | `【${url}】: ${msg}` | 每条解析失败的展示格式，可用 ${url}（链接）和 ${msg}（错误信息） |\n\n## 支持的变量 (Supported Variables)\n在 `unifiedMessageFormat` 中可使用以下变量进行自定义格式化，某行所有变量均为空（或为\"0\"）时该行不显示：\n\n| 变量名 | 说明 | 适用平台 |\n|--------|------|----------|\n| `${标题}` | 视频/图集标题 | 所有平台 |\n| `${作者}` | 作者/发布者名称 | 所有平台 |\n| `${简介}` | 内容简介/描述 | 所有平台 |\n| `${视频时长}` | 视频时长（时:分:秒） | 视频 |\n| `${点赞数}` | 点赞数量 | 所有平台 |\n| `${收藏数}` | 收藏数量 | 所有平台 |\n| `${转发数}` | 转发/分享数量 | 所有平台 |\n| `${播放数}` | 播放量 | 部分平台 |\n| `${评论数}` | 评论数量 | 所有平台 |\n| `${发布时间}` | 发布时间（格式化） | 所有平台 |\n| `${图片数量}` | 图集/实况图片数量 | 图集/实况 |\n| `${作者ID}` | 作者唯一标识ID | 部分平台 |\n| `${封面}` | 封面图片地址 | 所有平台 |\n| `${视频链接}` | 视频原始链接 | 视频 |\n\n> 注：部分变量可能因平台API返回数据不同而显示为空，某行所有变量为空（或为\"0\"）时该行会自动隐藏。\n\n## 支持的平台 (Supported Platforms)\n| 平台名称 | 关键词识别 | 解析能力 |\n|----------|------------|----------|\n| 哔哩哔哩 (B站) | bilibili, b23.tv, bilibili.com | 视频（不含番剧/直播/图文） |\n| 抖音 | douyin, v.douyin.com | 短视频、图集、实况 |\n| 快手 | kuaishou, v.kuaishou.com | 短视频、图集 |\n| 小红书 | xiaohongshu, xhslink.com | 图文、视频 |\n| 微博 | weibo, video.weibo.com | 视频、图集 |\n| 剪映 / 即梦 | jianying, jimeng.jianying.com | 视频模板 |\n| 今日头条 / 西瓜视频 | toutiao, ixigua.com | 短视频 |\n| AcFun (A站) | acfun, acfun.cn | 视频 |\n| 知乎 | zhihu, zhihu.com | 视频、回答 |\n| 微视 | weishi, weishi.qq.com | 短视频 |\n| 虎牙 | huya, huya.com | 直播、视频 |\n| YouTube (油管) | youtube, youtu.be | 视频 |\n| TikTok (国际版抖音) | tiktok, tiktok.com | 短视频 |\n| 好看视频 | haokan, haokan.baidu.com | 短视频 |\n| 梨视频 | video.li | 短视频 |\n| 美拍 | meipai, meipai.com | 短视频 |\n| 全民直播 | quanmin (quanmin.tv) | 直播 |\n| Twitter / X | twitter, x.com | 视频、图文 |\n| Instagram | instagram, instagram.com | 图文、Reels |\n| 豆包 | doubao (doubao.com) | 视频 |\n| 皮皮搞笑 | pipigx, h5.pipigx.com | 短视频 |\n| 皮皮虾 | pipixia, h5.pipix.com | 短视频 |\n| 最右 | zuiyou, xiaochuankeji.cn | 短视频 |\n\n> 注：部分平台解析能力可能因API限制有所差异，具体以实际解析结果为准。\n\n## 项目贡献者 (Contributors)\n\n| 贡献者 (Contributor) | 贡献内容 (Contribution) |\n|----------------------|-------------------------|\n| Minecraft-1314 | 插件完整开发 (Complete plugin development) |\n| JH-Ahua | BugPk-Api 支持 |\n| shangxue | 灵感来源 |\n\n（欢迎通过 Issues 或 PR 加入贡献者列表）\n\n## 许可协议 (License)\n\n本项目采用 MIT 许可证，详情参见 [LICENSE](LICENSE) 文件。\n\nThis project is licensed under the MIT License, see the [LICENSE](LICENSE) file for details.\n\n## 支持我们 (Support Us)\n\n如果这个项目对您有帮助，欢迎点亮右上角的 Star ⭐ 支持我们，这将是对所有贡献者最大的鼓励！\n\nIf this project is helpful to you, please feel free to star it in the upper right corner ⭐ to support us, which will be the greatest encouragement to all contributors!","readmeFilename":"readme.md","_rev":"1-22c2f1d719fc36058225eb8800ed0202"}