{"_id":"@aronnaxlin/bgm-cli","_rev":"3-086b0ea79dc07a1c1e7c379b01a1a7fb","name":"@aronnaxlin/bgm-cli","dist-tags":{"latest":"1.1.2"},"versions":{"1.0.0":{"name":"@aronnaxlin/bgm-cli","version":"1.0.0","keywords":["bangumi","bgm","cli"],"author":{"name":"aronnaxlin"},"license":"AGPL-3.0-only","_id":"@aronnaxlin/bgm-cli@1.0.0","maintainers":[{"name":"aronnaxlin","email":"lilinhan917@gmail.com"}],"homepage":"https://github.com/aronnaxlin/bgm-cli#readme","bugs":{"url":"https://github.com/aronnaxlin/bgm-cli/issues"},"bin":{"bgm":"src/cli.js"},"dist":{"shasum":"50c443e36f380eb0070514dcb658c9458b99ece0","tarball":"https://registry.npmjs.org/@aronnaxlin/bgm-cli/-/bgm-cli-1.0.0.tgz","fileCount":46,"integrity":"sha512-psk1EPwY5PkTHsAkc//xVovZqrzo93q9Ejd9to/HsPm/Lst+y+SIQzVLEQyp0u06hsgzpw8QRzGqZqDnZwwY6Q==","signatures":[{"sig":"MEUCIAPU28AiFqJ7m1PGRT82pcMx39HgmjWbbaqmBJWExklTAiEA5e7yn+LLis9aufkGXxwIwXA8s4Bif/q5fqJOoC2G1yE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":565501},"type":"module","engines":{"node":">=20"},"gitHead":"8becd18ac10398c9ce474859a280f5e4fafdd5b2","scripts":{"help":"node src/cli.js --help","test":"node --test","start":"node src/cli.js"},"_npmUser":{"name":"aronnaxlin","email":"lilinhan917@gmail.com"},"repository":{"url":"git+https://github.com/aronnaxlin/bgm-cli.git","type":"git"},"_npmVersion":"11.6.2","description":"Command-line client for Bangumi.","directories":{},"_nodeVersion":"25.2.1","dependencies":{"undici":"^6.26.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/bgm-cli_1.0.0_1780481969184_0.07645581173586469","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@aronnaxlin/bgm-cli","version":"1.1.0","keywords":["bangumi","bgm","cli"],"author":{"name":"aronnaxlin"},"license":"AGPL-3.0-only","_id":"@aronnaxlin/bgm-cli@1.1.0","maintainers":[{"name":"aronnaxlin","email":"lilinhan917@gmail.com"}],"homepage":"https://github.com/aronnaxlin/bgm-cli#readme","bugs":{"url":"https://github.com/aronnaxlin/bgm-cli/issues"},"bin":{"bgm":"src/cli.js"},"dist":{"shasum":"6432c995ac06ccb4793cdf086bcbd03fb166fd0e","tarball":"https://registry.npmjs.org/@aronnaxlin/bgm-cli/-/bgm-cli-1.1.0.tgz","fileCount":52,"integrity":"sha512-WRUryLNDEkzDY8mbXDhdu84HQGfMLLnZGRVukoX5nQ+ysFIO3zM76q2d5KMWj2xdS81j9eVq57/4DCN18s0t9w==","signatures":[{"sig":"MEYCIQCsc3rrjsYUWYHL3Q+VL6sgMD3FibpUC92GP77wTBXtRwIhAI6hsIBWtiC4OIM32ebVsv9xWgRpjN7FlBylzkmseovs","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":650695},"type":"module","engines":{"node":">=20"},"gitHead":"e1c278119c611d958a1fd275cad471fe5505d34c","scripts":{"help":"node src/cli.js --help","test":"node --test","start":"node src/cli.js"},"_npmUser":{"name":"aronnaxlin","email":"lilinhan917@gmail.com"},"repository":{"url":"git+https://github.com/aronnaxlin/bgm-cli.git","type":"git"},"_npmVersion":"11.19.0","description":"Command-line client for Bangumi.","directories":{},"_nodeVersion":"24.20.0","dependencies":{"undici":"^6.26.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/bgm-cli_1.1.0_1788534682398_0.010198403016857371","host":"s3://npm-registry-packages-npm-production"}},"1.1.2":{"name":"@aronnaxlin/bgm-cli","version":"1.1.2","description":"Command-line client for Bangumi.","license":"AGPL-3.0-only","author":{"name":"aronnaxlin"},"homepage":"https://github.com/aronnaxlin/bgm-cli#readme","repository":{"type":"git","url":"git+https://github.com/aronnaxlin/bgm-cli.git"},"bugs":{"url":"https://github.com/aronnaxlin/bgm-cli/issues"},"keywords":["bangumi","bgm","cli"],"type":"module","bin":{"bgm":"src/cli.js"},"publishConfig":{"access":"public"},"scripts":{"start":"node src/cli.js","help":"node src/cli.js --help","test":"node --test"},"engines":{"node":">=20"},"dependencies":{"undici":"^6.26.0"},"gitHead":"7e27f3e3d7e1bca58b7ea2f05bdbc046a86b84a2","_id":"@aronnaxlin/bgm-cli@1.1.2","_nodeVersion":"22.23.2","_npmVersion":"12.0.2","dist":{"integrity":"sha512-nDul3/XJzTaSYS9NDXYZk838/nrndimkciXlqn8Wai60uJ0pV4SntszvOpIYjuaRXEK5Nzo+eDSoQRTmh0FCUA==","shasum":"1a805bb3d9692b94b2051ebb84158f6fc09dd8f3","tarball":"https://registry.npmjs.org/@aronnaxlin/bgm-cli/-/bgm-cli-1.1.2.tgz","fileCount":52,"unpackedSize":646950,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@aronnaxlin%2fbgm-cli@1.1.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIAkjI6DTJxcuUM/qqD38GzQ/EUwJR7nwJb+gqhkIXmnTAiAQepgvs93WtDya4erohn7LV2M4RqtisN20h9mpNsIU9g=="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:084e39d3-70af-4c08-a05a-8d6d334cffdf"}},"directories":{},"maintainers":[{"name":"aronnaxlin","email":"lilinhan917@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/bgm-cli_1.1.2_1788661525807_0.7681662292167826"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-03T10:19:29.009Z","modified":"2026-09-06T02:25:26.264Z","1.0.0":"2026-06-03T10:19:29.337Z","1.1.0":"2026-09-04T15:11:22.554Z","1.1.2":"2026-09-06T02:25:25.944Z"},"bugs":{"url":"https://github.com/aronnaxlin/bgm-cli/issues"},"author":{"name":"aronnaxlin"},"license":"AGPL-3.0-only","homepage":"https://github.com/aronnaxlin/bgm-cli#readme","keywords":["bangumi","bgm","cli"],"repository":{"type":"git","url":"git+https://github.com/aronnaxlin/bgm-cli.git"},"description":"Command-line client for Bangumi.","maintainers":[{"name":"aronnaxlin","email":"lilinhan917@gmail.com"}],"readme":"# bgm-cli\n\n[简体中文](./README.md) | [繁體中文（台灣）](./README.zh-TW.md) | [English](./README.en.md)\n\n`bgm-cli` 是一個面向 Bangumi 的命令列工具，目標是讓使用者能快速在終端機中完成常見查詢、讀取與部分寫入操作。\n\n## 快速開始\n\n### 執行需求\n\n- Node.js `>= 20`\n\n### 安裝\n\nnpm / npx：\n\n```bash\nnpx @aronnaxlin/bgm-cli --help\nnpm install -g @aronnaxlin/bgm-cli\n```\n\nmacOS / Linux：\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/aronnaxlin/bgm-cli/main/scripts/install-remote.sh | sh\n```\n\nWindows PowerShell：\n\n```powershell\nirm https://raw.githubusercontent.com/aronnaxlin/bgm-cli/main/scripts/install-remote.ps1 | iex\n```\n\n如果你已經在本地 clone 倉庫，也可以直接執行：\n\n```bash\n./bgm --help\n```\n\n### 認證\n\n建議路徑是使用官方 Bangumi 登入：\n\n```bash\nbgm --init\n```\n\n`bgm --init` 會優先提供官方登入，也保留 Access Token 作為第二種渠道。如果你已經有 Token，也可以直接保存：\n\n```bash\nbgm auth set-token YOUR_ACCESS_TOKEN\nbgm auth token-status\n```\n\n### 代理\n\n如果你所在網路存取 Bangumi API 不穩定，可以為所有 CLI 請求設定 HTTP/HTTPS 代理：\n\n```bash\nbgm proxy set http://127.0.0.1:7890\nbgm proxy show\n```\n\n也可以只對單次命令使用環境變數：\n\n```bash\nBGM_PROXY=http://127.0.0.1:7890 bgm subject get 8\n```\n\n代理優先級為：`bgm proxy set` 持久化設定 > `BGM_PROXY` > `HTTPS_PROXY` / `HTTP_PROXY`。\n\n### 常用命令\n\n```bash\nbgm user me\nbgm subject search \"Heike Monogatari\" --type anime --limit 5\nbgm subject get 348335\nbgm subject comments 348335 --limit 5\nbgm character search \"明日香\" --limit 3\nbgm person search \"庵野\" --limit 3\nbgm collection get 348335\nbgm collection indexes --user sai --limit 5\nbgm book get 3510\nbgm book ep 3510 10\nbgm group list --sort members --limit 10\nbgm group user sai --limit 5\nbgm index user sai --limit 5\nbgm search subject \"海賊王\" --limit 5\nbgm trending subjects --type anime --limit 5\nbgm --json user me\n```\n\n## 文件索引\n\n- 本專案同時提供可安裝的 Skills，適合讓 AI / Agent 直接安裝並操作 `bgm-cli`。\n- 可以透過 `npx skills add aronnaxlin/bgm-cli` 添加本專案的 Skills。\n- [`docs/README.md`](./docs/README.md)：文件總入口\n- [`docs/guide.zh-CN.md`](./docs/guide.zh-CN.md)：主體導覽、推薦使用路線、安裝與常見使用方式\n- [`docs/features.zh-CN.md`](./docs/features.zh-CN.md)：完整功能列表與命令索引\n- [`docs/implementation.zh-CN.md`](./docs/implementation.zh-CN.md)：設定模型、輸出模型、收藏語義、倉庫結構與開發說明\n- [`docs/experimental.zh-CN.md`](./docs/experimental.zh-CN.md)：實驗性功能，以及 OAuth、Turnstile、private session、hosted backend 說明\n- [`oauth-backend/README.md`](./oauth-backend/README.md)：可選自託管 OAuth backend 的部署說明\n- [`SKILLS.md`](./SKILLS.md)：給 AI / Agent 的倉庫與操作入口\n\n拆分後的詳細文件目前統一以簡體中文維護於 `docs/` 之下。\n\n## 核心風險與邊界\n\n- 本專案不是 Bangumi 官方產品，與 Bangumi 官方沒有隸屬關係。\n- 一般使用者應優先使用 `bgm --init` 裡的官方登入；Access Token 保留給相容與腳本場景，OAuth / hosted backend 不應視為預設主路徑。\n- 一部分社群寫入操作依賴 Turnstile；本輪機器驗證已跳過這類人機驗證步驟，相關寫入操作仍需要人工複測，且部分實驗性寫入目前仍可能遇到 Bangumi 伺服器端失敗。\n- 若要做腳本整合，建議優先使用 `--json`，不要依賴人類可讀輸出的文字格式。\n- Bangumi 建議客戶端使用可識別開發者與應用程式身分的自訂 `User-Agent`。\n\n## 致謝與承認\n\n- 感謝 [`bgm.tv`](https://bgm.tv/) 提供 Bangumi 主站與社群生態。\n- 感謝 [`bangumi/server-private`](https://github.com/bangumi/server-private) 提供 private API 相關實作參考。\n- 感謝 [`bangumi/api`](https://github.com/bangumi/api) 提供公開 API 相關實作與文件基礎。\n- 感謝 [`SearchEncore`](https://bgmdb.ry.mk/v1/docs)（`bgmdb.ry.mk`）提供社群維護的 Bangumi 增強搜尋能力；該服務作者為 [`wataame`](https://bangumi.tv/user/wataame)。SearchEncore 是社群成員自發維護的搜尋服務，資料來自社群聚合，與 bangumi.tv 官方介面互補。\n- 感謝 [`bgm-status.ry.mk`](https://bgm-status.ry.mk/) 提供社群維護的 Bangumi 可用性狀態觀測能力；該服務作者同樣為 [`wataame`](https://bangumi.tv/user/wataame)。\n- 本倉庫會盡量反映目前可驗證的 Bangumi 行為限制，但不承諾覆蓋網站上的全部功能。\n\n## 授權\n\n本倉庫使用 `AGPL-3.0-only` 授權。詳見 [LICENSE](./LICENSE)。\n","readmeFilename":"README.zh-TW.md"}