PickACG:開源 Bangumi 標籤搜尋,評分與季節篩出下一部動畫

PickACG 是一個把 Bangumi 條目資料包成多條件搜尋介面的開源工具,支援多標籤組合、評分區間與播映季節篩選,預設打開就是當下熱門榜,不登入就能完整搜尋一般內容。本篇整理它的搜尋機制、查詢會經過站方伺服器的資料邊界、登入實際解鎖的內容,以及自架前該知道的授權義務與開發現況。

用 AI 摘要這篇文章:

想在 Bangumi 找「評分八分以上、2023 年春夏之間、帶某個題材標籤」的動畫,你會發現站內搜尋幫不上這個忙:它就是一個關鍵字輸入框加類型下拉選單。PickACG 是一個把這類組合查詢補上的開源搜尋工具,資料全部來自 Bangumi 的公開 API,打開首頁直接呈現當下的熱門作品,輸入關鍵字之後再用標籤、評分、播映年份一層層縮小範圍。

我實際在它的官方網站操作過搜尋與篩選,也把 GitHub 上的原始碼完整讀過一輪,包含送出的每個 API 請求長什麼樣子。這篇講的是它做到的事、查詢經過誰的手,以及登入或自架之前該知道的邊界;我沒有登入 Bangumi 帳號,也沒有自己架一份,涉及這兩塊的段落會以程式碼與官方文件為準。

先講結論:如果你本來就用 Bangumi 管理追番清單,這個工具直接打開就能用,不用註冊、不用安裝;如果你在意搜尋關鍵字外流,或想改造成自己想要的樣子,它可以自架,但有一條授權義務要遵守。它做的事說起來就一件:把 Bangumi 累積多年的社群標籤,變成可以組合的搜尋條件。

Bangumi 搜尋本來做不到的組合查詢,它補上了

Bangumi(bgm.tv)在中文圈的定位,大概等同於豆瓣之於書影,是一個由社群共同維護的 ACG 條目資料庫,動畫、書籍、遊戲、音樂甚至三次元作品都有編號、評分與收藏紀錄。它的條目品質靠人群長年累積,搜尋介面卻停留在關鍵字加類型:它的搜尋頁能選的只有全部、動畫、書籍、遊戲、音樂、三次元與人物。想知道「評分高又帶某個題材」的作品,你只能一頁頁翻,或靠自己記住一堆片單。

PickACG 對這個缺口的回答很直接:搜尋列下方攤開一排標籤與篩選器,標籤可以複選疊加,評分能拉出區間,播映日期可以選年份加季度或指定日期範圍,排序有匹配度、熱度、排名三種,類型切換涵蓋動畫到三次元五類。滑到底會自動載入下一頁,往下滑就是往後翻。這些條件全部反映在網址參數上,把自己調好的搜尋存成書籤,下次打開還是同一組條件。

三種排序各有用意,而且程式會替你自動切換:沒有關鍵字時預設用熱度,直接呈現當下的熱門榜;一旦輸入關鍵字送出,排序會自動跳到匹配度,確保最相關的結果排最前面;想看公認的經典,再手動切到排名,這個模式會自動排除沒有排名的條目,等於直接給你一份篩過的榜單。我實測搜「物語」,整個系列的作品連同外傳一次列出來,卡片上直接標好每部的排名與評分,不用再逐部點進 Bangumi 查。

在 PickACG 搜尋物語系列後的結果頁,排序自動切換為匹配度,卡片列出系列各作品的排名與評分,搜尋列下方攤開推薦標籤Pin
搜尋「物語」後的結果與推薦標籤列(圖片來源:pickacg.ezer.top 官網截圖,2026 年 8 月)

不輸入任何關鍵字直接打開首頁,它給你的也不會是空白:預設排序是熱度,畫面上直接排出當下最多人關注的動畫,每張卡片上有排名徽章、評分與評分人數、首播日期、集數,還有一排主要角色的頭像。我測試的當下它載出了四十張卡片,從經典長青作品到當季新番都混在一起,光看卡片資訊就足夠判斷要不要點進去。

PickACG 官方網站首頁的預設視圖,以熱度排序列出當下熱門動畫,每張卡片帶有排名徽章、評分、首播日期、集數與主要角色頭像Pin
PickACG 首頁預設的熱門榜視圖(圖片來源:pickacg.ezer.top 官網截圖,2026 年 8 月)

季節篩選的真相:它其實是一個社群標籤

這個工具最有意思的設計藏在原始碼裡。你在介面上選「2023 年春季」,它並沒有去查什麼獨立的季度資料庫,而是把你的選擇直接翻譯成一個「2023年4月」標籤,連同其他篩選條件一起送給 Bangumi 的搜尋 API。換句話說,季節篩選搭乘的是 Bangumi 條目上由使用者打出來的民間標籤系統,這套標籤累積了十幾年,幾乎每部作品都帶有年份月份標記。

這個做法聰明也脆弱。聰明的地方在於它不用維護自己的資料庫,直接借用整個社群已經整理好的分類;脆弱的地方在於標籤是人打的,新上架或冷門作品如果還沒有人補上「2026年7月」這種標記,季節篩選就會漏掉它。你用標籤篩選時看到的推薦標籤,也是從目前搜尋結果動態聚合出來的,點一個就收緊一層,等於讓結果集自己告訴你還能怎麼縮小。

卡片上那些排名、集數、角色頭像,是第二層查詢補出來的。搜尋結果回來之後,它會再對 Bangumi 的 GraphQL 端點發一次批次請求,把每部作品的放送日期、集數或卷數、主要角色(含簡體中文名)一次補齊,並順帶查詢系列關聯,用來過濾單行本以外的書籍,角色頭像最多排七位,點了會直接連回 Bangumi 的角色頁。每張卡右上角還有一個往外的按鈕,會用作品名稱直接搜尋 bilibili,從找片到看片的動線被串在一起;如果你也用 bilibili,可以順手看看我們之前介紹過的 bilibili 頁面清理擴充功能,把觀看體驗再整理乾淨一點。

介面本身是英文的,標籤與作品名稱則跟著 Bangumi 的簡體中文語料走,用繁體名稱搜尋時建議也試試簡體關鍵字,匹配度排序對中文詞的敏感度取決於 Bangumi 端的索引方式。

你的搜尋關鍵字會先經過它的伺服器

從瀏覽器的角度看,這個網站只連兩個地方:它自己的網域,以及 Bangumi 的圖片主機。我把實際操作時的全部請求記錄下來,幾百筆流量裡沒有第三方廣告或追蹤網域,封面圖與角色頭像都直接來自 Bangumi 的圖片快取,網站本身還掛著 Vercel 的流量統計腳本。

但要留意搜尋的路徑:你的關鍵字並沒有直接從瀏覽器送到 Bangumi,而是先送到 PickACG 自己的伺服器,由伺服器代為轉送。這是 Next.js 的伺服器端設計,好處是瀏覽器不用處理跨網域與授權細節,站方也可以在轉送時附上符合 Bangumi API 禮儀的識別名稱;代價是理論上,站長端的伺服器看得到你搜了什麼。程式碼裡沒有任何儲存查詢紀錄的邏輯,不過這種事本來就只能靠信任與自架解決,閉源黑箱我們無從談起,開源至少讓你看得一清二楚。

不登入的話,這些考慮其實很輕:一般內容的搜尋完全不需要帳號,網站也沒有廣告與付費牆,整個服務免費。真正需要想清楚的,是下一件事。

登入解鎖的是成人條目,代價是交出 Bangumi 授權

官方 README 的說法是「登入後解鎖更多內容」,沒有細講解鎖的是什麼。對照 Bangumi 官方 API 文件可以拼出答案:文件明確寫著成人內容只對授權使用者可見,未授權的請求會直接收到 404。PickACG 在你登入後會把你的存取權杖附加到每個搜尋請求上,所以合理推論,所謂更多內容主要就是這批平時被過濾掉的成人條目。

登入本身走 Bangumi 的 OAuth 2.0 授權,請求的權限範圍是空的,也就是基本帳號識別,而且要特別注意它要求的是離線存取類型,權杖過期後可以自動換新。授權之後,你的權杖會存進站方的雲端資料庫(程式使用 Neon 的無伺服器 PostgreSQL),登入後選單裡那排七日活躍小圓點,也是拿你的帳號識別去拉你在 Bangumi 上的近七天收藏動態畫出來的。這些都是個人專案的正常做法,但意味著你把一份可持續用於 Bangumi API 的憑證交給了一個陌生站長。我的建議:查片、篩選、看排名,這些不用登入就全部做得到;除非你真的需要搜成人內容,帳號留在 Bangumi 自己的網站上就好。

自架之前:授權義務與七個月的安靜

整個專案以 AGPL 3.0 授權發布,原始碼在 GitHub 上有 161 顆星。自架有兩條路:照 README 用 pnpm 裝依賴跑起來,或按文件裡的 Deploy to Vercel 按鈕一鍵部署。登入功能是選配的:授權與資料庫環境變數沒設好時,伺服器端就不會啟用 Bangumi 登入管道,自己架一份純搜尋版本完全可行,只要把指向 Bangumi API 的位址參數設起來。要記得 AGPL 的義務:如果你改了程式碼又對外提供服務,必須向使用者公開你修改後的原始碼。

開發現況值得看一眼。這個專案在 2025 年 12 月底做過一次大改版,從原本的 Pick Anime Cool 舊版重寫成現在的 Next.js 應用,連名字都從原本的 Pick Anime Cool 改成 PickACG,舊倉庫現在只剩一頁轉址說明。改版節奏很快,兩個月內塞進了六十幾個提交,然後在 2026 年 1 月中旬之後就安靜下來,到 2026 年 8 月已經約七個月沒有新的提交。以個人 side project 的標準看它已經完整可用,功能沒有殘缺,只是別期待它每個月都有新東西。

誰該直接用,誰該自架,誰其實不需要它

在 Bangumi 上有收藏習慣、常覺得「想找某種感覺的作品卻不知道從何問起」的人,直接打開網頁用就好,不登入、不加任何東西,它就是一個更好用的搜尋前端。找到之後想順手整理自己的收藏庫,可以看看我們之前寫過的 Koma 漫畫收藏管理器,一個同樣開源的本機收藏管理工具。

在意查詢隱私、或想按自己的口味改造介面的人,自架是合理選擇,把程式部署到自己的 Vercel 帳號或伺服器上,關鍵字就只經過你自己的服務,代價是扛下 AGPL 的公開義務與偶爾的相依套件更新。習慣把豆瓣當書影資料庫的人,也可以參考我們介紹過的 豆瓣書單卡片產生器,同一種「把社群資料庫變成好用手工具」的思路,在書影圈有另一個樣貌。

還有一種人可以省下這次點閱:如果你從不用 Bangumi,這個工具對你沒有意義。它沒有任何自有內容,五種類型、每張卡片、每個評分都來自 Bangumi 的公開資料,它把這些資料包裝成一個能組合條件的搜尋介面,如此而已。也正因為如此,它輕、快、乾淨,值得每個 Bangumi 使用者放進書籤欄。

費用、帳號與手機體驗的快速問答

PickACG 免費嗎?免費,沒有廣告也沒有付費牆。它是開源專案,沒有商業模式,站方自己吸收託管與資料庫成本,頁面上唯一的統計元件是 Vercel 的流量分析腳本。

一定要有 Bangumi 帳號嗎?不用。一般內容的搜尋、篩選、排序全部匿名可用,帳號只在兩種時刻有差別:想搜成人條目,或想在選單裡看到自己的活躍紀錄。

手機上能用嗎?能。介面是響應式設計,卡片與篩選器會依螢幕寬度重排,角色頭像列與部分徽章在小螢幕上會自動收起。截圖以桌面版為準。

它會動到我在 Bangumi 上的資料嗎?不會。整個程式對 Bangumi 只做讀取:搜尋、熱門榜、條目補強與(登入時的)個人動態查詢,沒有任何寫入收藏或評分的程式路徑。

Sliven 褚崇名
Sliven 褚崇名

每日分享科技新知、免費資源以及 WordPress、虛擬主機相關主題,任何問題歡迎在科技月球下方留言,或是發送 Email 至 [email protected] 與我聯繫。

文章: 996

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *


Share to...