@wan0ge/bangumi-data

本仓库是 bangumi-data/bangumi-data 的 fork，在原版数据基础上新增了 season_id / video_sn 字段，并通过 CI 自动发布至 npm（@wan0ge/bangumi-data）。 本 fork 的所有数据补全工作依赖上游 bangumi-data 的更新，上游维护者人工录入新番剧数据后，本 fork 的自动化脚本才会对新条目补全 season_id / video_sn 字段。感谢上游所有贡献者的持续维护。

与上游的差异

| 特性 | 上游 bangumi-data | 本 fork（@wan0ge） | |---|---|---| | season_id 字段 | 无 | 新增（尽力补全 B 站番剧 season_id） | | video_sn 字段 | 无 | 新增（尽力补全巴哈姆特动画疯 video_sn） | | 自动数据补全 | 手动 bdh update | auto-sync.sh 定时运行（依赖上游有新数据） | | npm 发布 | 手动 | GitHub Actions 自动 npm publish | | 版本号 | 手动 bump | 自动 bump（与上游版本联动） | | 覆盖范围 | 公开站点 | 额外覆盖 B 站港澳台/台湾分区 |

新增字段说明

season_id（B 站番剧）

通过 B 站 API 匹配 bangumi 条目的 media_id → season_id，覆盖 bilibili / bilibili_hk_mo / bilibili_tw / bilibili_hk_mo_tw 等站点。

{
  "sites": [
    {
      "site": "bilibili",
      "id": "123456",
      "season_id": "20123456"
    }
  ]
}

video_sn（巴哈姆特动画疯）

通过巴哈姆特 API 匹配 bangumi 条目 → 获取 video_sn，覆盖 gamer / gamer_hk 站点。

{
  "sites": [
    {
      "site": "gamer",
      "id": "12345",
      "video_sn": "12345-1"
    }
  ]
}

自动化流程

本 fork 通过 auto-sync.sh 定时运行，流程如下：

上游 bangumi-data/bangumi-data 有更新（人工录入新数据）
        │
        ▼
  auto-sync.sh（定时运行）
  1. fetch upstream（合并上游更新）
  2. node fill-missing-ids.js（为新增条目补全 season_id/video_sn）
  3. git commit + push
  4. 推送版本 tag
  5. 钉钉通知
        │
        ▼
  GitHub Actions（auto-publish.yml）
  → npm install → build → npm publish @wan0ge/bangumi-data

自动化补全的前提是上游已录入对应条目。上游数据未覆盖的条目，本 fork 也无法补全。

使用方法

npm install @wan0ge/bangumi-data

const bangumiData = require('@wan0ge/bangumi-data');
// bangumiData.items = [{ id, sites: [{ site, id, season_id, video_sn }] }]

也可通过 CDN 获取最新 v0.3.x 数据：

https://unpkg.com/@wan0ge/[email protected]/dist/data.json

相关仓库

| 仓库 | 说明 | |---|---| | @wan0ge/bangumi-data | 本 fork（数据 + 自动化脚本） | | @wan0ge/helper | 本 fork 的 helper 工具链 | | bangumi-data/bangumi-data | 上游原版（数据来源） | | bangumi-data/helper | 上游 helper |

原版 README

以下内容为上游原版 README，保留供参考。

Bangumi Data

动画番组及其放送、资讯站点数据集合

使用方法

npm install bangumi-data

const bangumiData = require('bangumi-data');

也可通过 CDN https://unpkg.com/[email protected]/dist/data.json 获取 v0.3.x 的最新数据

哪些项目在使用

https://github.com/bangumi-data/awesome

帮助我们改进

见 CONTRIBUTING.md

License

The data in this repo is available for use under a CC BY 4.0 license (http://creativecommons.org/licenses/by/4.0/). For attribution just mention somewhere that the source is bangumi-data. If you have any questions about using the data for your project please contact us.