https://github.com/dyphire/komgabangumi
Komga 漫画服务器元数据刮削器，使用 Bangumi API
https://github.com/dyphire/komgabangumi
bangumi komga metadata
Last synced: 5 months ago
JSON representation
Komga 漫画服务器元数据刮削器，使用 Bangumi API
- Host: GitHub
- URL: https://github.com/dyphire/komgabangumi
- Owner: dyphire
- License: mit
- Created: 2025-05-18T04:09:47.000Z (6 months ago)
- Default Branch: master
- Last Pushed: 2025-07-04T07:11:54.000Z (5 months ago)
- Last Synced: 2025-07-04T08:25:24.845Z (5 months ago)
- Topics: bangumi, komga, metadata
- Language: JavaScript
- Homepage:
- Size: 57.6 KB
- Stars: 42
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: Changelog.md
- License: LICENSE
Awesome Lists containing this project
README
# KomgaBangumi
Komga 漫画服务器元数据刮削器，使用 Bangumi API，并支持自定义 Access Token
用于自建 Komga 服务刮削漫画元数据，生成 Metadata 和封面
## 功能
* 从 Bangumi API 获取系列和卷的元数据及封面
* 支持 bookof.moe 作为备用数据源 (刮削)
* 在 Komga 界面添加刮削按钮
* 批量精确匹配库中的系列
* 失败的系列自动添加到 "手动匹配" 收藏夹
* 允许用户通过油猴菜单配置 Bangumi Access Token
* 当 Access Token 失效 (API 返回 401) 时提示用户更新
## 安装
1. 确保你已经安装了浏览器扩展 [Tampermonkey](https://www.tampermonkey.net/) (Chrome, Firefox, Edge, Safari 等均支持) 或兼容的用户脚本管理器
2. 点击以下链接安装脚本：
[](https://raw.githubusercontent.com/dyphire/KomgaBangumi/master/KomgaBangumi.user.js)
## 说明
刮削按钮在每本书封面处下方，会生成两个圆形按钮，按钮是默认隐藏的，只有移动到书籍封面上才会显示，包括书库和书籍详情页都会生成
左侧按钮用于只刮削 Metadata 信息，右侧按钮用于刮削 Metadata 信息和所有封面
## 使用方法
* 配置 Komga 服务域名或 `ip:port`地址用于脚本识别
1. 打开油猴 Tampermonkey 的管理面板（Dashboard）
2. 找到 KomgaBangumi 脚本，点击编辑按钮（铅笔图标）
3. 切换到 "设置" (Settings) 标签页
4. 找到 "包括/排除 (Includes/Excludes) " 部分
5. 在 "用户包括 (User includes) " 或 "用户匹配 (User matches) " 中添加您的 Komga 服务域名匹配规则，例如 `https://komga.org/*`
6. 保存设置
* 配置 Bangumi Access Token **(可选，用于搜索 NSFW 条目)**
1. 在浏览器中访问你的 Komga 服务网址
2. 点击浏览器工具栏中的 Tampermonkey 图标
3. 找到 KomgaBangumi 脚本
4. 选择 "设置 Bangumi Access Token"
5. 在弹出的对话框中输入您的 Token。留空则清除
* 在库视图的顶部工具栏会添加 "全库精配" 按钮
* 脚本会在 Komga 的系列卡片和系列详情页面的封面上添加 "仅更新元数据" 和 "更新元数据和封面" 按钮
## 具体操作
1. 点击刮削按钮
2. 选择刮削源
3. 选择要刮削的书名
4. 点击对应的书籍，则开始刮削，刮削完不需要刷新，Komga 会自动更新
> [!NOTE]
> 如果某些书籍无法正确获取本地书籍名，或者使用搜索无法正确检索到，可以手动到网站检索到正确书籍后，复制其 URL，编辑漫画的链接一栏添加对应的项即可
>
> 比如 `'Btv': 'https://xxxx'`，保存后再更新漫画选择该源即可
>
> 也可以直接修改 Komga 上的标题为正确标题后再次执行手动搜索
> [!NOTE]
> 库视图的顶部工具栏会有一个 "全库精配" 按钮，可以用于执行当前库的批量精确匹配
## 更新日志
[Changelog](Changelog.md)
## 许可证
[MIT](LICENSE)