npm 包需 Node.js 24+ 或提供标准 Fetch API 的浏览器环境;MCP 与 API 均依赖在线服务 api.animes.garden,需联网;本地开发需按 CONTRIBUTING.md 另行配置环境
npm i @animegarden/clientREADME 未说明,项目为在线服务与 npm 客户端,无需本地 GPU 或显存
動漫花園第三方镜像站与动画 BT 资源聚合站,提供开放 API 供开发者检索动画资源
动画 BT 资源聚合站与動漫花園镜像,提供开放接口,方便按番剧检索和订阅动画资源。
核心能力
- 提供开放 API 接口,支持分页拉取资源列表
- 支持按字幕组、发布者、关键词、时间范围组合筛选
- 可生成自定义 RSS 订阅链接与搜索条件收藏夹
- 提供 MCP 服务端点,可接入 Claude Code 等客户端
- 提供 @animegarden/client 的 JS/TS 客户端封装
容易踩的坑
- v0.5.5最新正式版2026-10-24 · 2026-10-24 19:51 UTC
🚨 Breaking Changes
- Migrate to bgmx online data - by @yjl9903 (77fbc)
- Migrate to bgmx online data - by @yjl9903 (8510b)
- server:
- Change return size to bytes - by @yjl9903 (c8612)
- web:
🚀 Features
- Enable node pointer compression - by @yjl9903 (56c41)
- Add subject audit skills - by @yjl9903 (9d6b3)
- Deploy app will auto purge web cdn cache - by @yjl9903 (ff92f)
- client:
- Add client error wrapper - by @yjl9903 (6c02a)
- plugins:
- scraper:
- Mikan transform image path - by @yjl9903 (6f08c)
- server:
- Send tg card - by @yjl9903 (9019e)
- Push telegram channel message, resolve #2219 - by @yjl9903 in https://github.com/yjl9903/AnimeGarden/issues/2219 (312ff)
- Force re-push messages and unpin forward channel message - by @yjl9903 (7f2bf)
- Redis fallback to non-blocking deps - by @yjl9903 (21c91)
- Decrease prefetch count - by @yjl9903 (fa167)
- Add indexed_at db field - by @yjl9903 (3b7f2)
- Manage subject id and force refresh resource detail - by @yjl9903 (f07c9)
- Subject schema align with bgmx - by @yjl9903 (b699b)
- Merge fansub and publisher, resolve #2156 - by @yjl9903 in https://github.com/yjl9903/AnimeGarden/issues/2156 (df46b)
- Remove users and teams group by initialize - by @yjl9903 (6aa39)
- Put ensure latest used at side async - by @yjl9903 (4ab09)
- Add api robots.txt - by @yjl9903 (ad90b)
- Add x-robots-tag=noindex - by @yjl9903 (0811d)
- Add extension data to rss, resolve #2724 - by @yjl9903 in https://github.com/yjl9903/AnimeGarden/issues/2724 (b848e)
- Redis 超时降级 - by @
- v0.5.42026-05-04 · 2026-05-04 15:39 UTC
这个版本没有写更新说明。
- v0.5.32026-03-26 · 2026-03-26 11:46 UTC
查看更新说明
🚨 Breaking Changes
🚀 Features
- Split page and filter options - by @yjl9903 (f1828)
- Add health check - by @yjl9903 (20913)
- Update title and description - by @yjl9903 (294a6)
- Update title and description - by @yjl9903 (ae910)
- Add skill - by @yjl9903 (3d6b8)
- cli:
- Wip - by @yjl9903 (7c05b)
- Add space and collection and subject - by @yjl9903 (07460)
- Add database - by @yjl9903 (68e62)
- Add storage command - by @yjl9903 (4af15)
- Add debug, add get subjects, and so on - by @yjl9903 (06499)
- Add source extracting - by @yjl9903 (51e4c)
- All push and pull logic - by @yjl9903 (5a466)
- server:
- Pre-defined filter preset - by @yjl9903 in https://github.com/yjl9903/AnimeGarden/issues/1894 (22421)
- Query detail by infohash - by @yjl9903 (b0083)
- Normalize bith to hex or base32 - by @yjl9903 (3a1e0)
- Add base mcp server, resolve 2034 - by @yjl9903 (a2304)
- Add more things to mcp - by @yjl9903 (8f4d6)
- Add mcp log - by @yjl9903 (856ba)
- Add redis cache and server timeout - by @yjl9903 (2b3ee)
- Add connection statement_timeout - by @yjl9903 (268a8)
- Add slow db connection - by @yjl9903 (fdccd)
- skills:
- web:
- Decrease default page size - by @yjl9903 (c430e)
- Default page size to 30 - by @yjl9903 (5b2b1)
- Migrate to single fetch - by @yjl9903 (a4455)
- Auto reload when resources error - by @yjl9903 [(9efaa)](https://github.com/yjl99
- v0.5.22025-05-26 · 2025-05-26 16:20 UTC
查看更新说明
🚨 Breaking Changes
- Remove legacy astro app - by @yjl9903 (04f07)
🚀 Features
- Upload heapsnapshot file - by @yjl9903 (d7f06)
- anipar:
- Add wav - by @yjl9903 (f2136)
- client:
- database:
- manager:
- Start script - by @yjl9903 (47607)
- scraper:
- Moe avatar - by @yjl9903 (3ad93)
- web:
- worker:
🐞 Bug Fixes
- Fly deploy ci switch - by @yjl9903 (8021f)
- client:
- Use globalThis.fetch - by @yjl9903 (aada6)
- Limit collection size - by @yjl9903 (ecc4e)
- Stringify search url - by @yjl9903 [(12cad)](https://github.com/yjl9903/AnimeGarden/
- v0.5.12025-04-18 · 2025-04-18 19:50 UTC
查看更新说明
🚀 Features
- server:
- Cache with gc - by @yjl9903 (f1d8f)
- web:
🐞 Bug Fixes
- anipar:
- Ani parser test - by @yjl9903 (b196c)
- client:
- Unify api - by @yjl9903 (4c63a)
- database:
- deps:
- Update dependency swagger-ui-react to ^5.21.0 - in https://github.com/yjl9903/AnimeGarden/issues/1664 (a1bae)
- Update dependency jotai to ^2.12.3 - in https://github.com/yjl9903/AnimeGarden/issues/1665 (d3288)
- Update astro monorepo - in https://github.com/yjl9903/AnimeGarden/issues/1668 (9bda5)
- Update dependency hono to ^4.7.7 - in https://github.com/yjl9903/AnimeGarden/issues/1669 (42cf3)
- Update dependency astro to ^5.7.3 - in https://github.com/yjl9903/AnimeGarden/issues/1672 (04ae4)
- Update dependency zod to ^3.24.3 - in https://github.com/yjl9903/AnimeGarden/issues/1673 (b15e3)
- Update dependency astro to ^5.7.4 - in https://github.com/yjl9903/AnimeGarden/issues/1677 (bc3f9)
- Update dependency webtorrent to ^2.6.2 - in https://github.com/yjl9903/AnimeGarden/issues/1678 (ee925)
- Update drizzle - in https://github.com/yjl9903/AnimeGarden/issues/1671 (af4d0)
- Update react monorepo to v19 (major) - in https://github.com/yjl9903/AnimeGarden/issues/1645 (9e3d6)
- Update radix-ui - in https://github.com/yjl9903/AnimeGarden/issues/1679 (793d6)
- Update dependency lucide-react to ^0.501.0 - in https://github.com/yjl9903/AnimeGarden/issues/1680 (fecdb)
- Update radix-ui - in https://github.com/yjl9903/AnimeGarden/issues/1681 (75654)
- manager:
- Clear setTim
- server:
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
🌸 Anime Garden
動漫花園 第三方 镜像站 以及 动画 BT 资源聚合站.
- ☁️ 为开发者准备的开放 API 接口
- 📺 查看 动画放送时间表 来找到你喜欢的动画
- 🔖 支持丰富的高级搜索, 例如:
上伊那牡丹 +简日 字幕组:喵萌奶茶屋 类型:动画 - 📙 自定义 RSS 订阅链接, 例如: 上伊那牡丹
- ⭐ 搜索条件收藏夹和生成聚合的 RSS 订阅链接
- 👷♂️ 支持与 AutoBangumi 和 AnimeSpace 集成
讨论群: Telegram @animegarden_dev
推送频道: Telegram @animegarden_channel
项目文档: 由 DeepWiki 生成
使用插件
选择你使用的 Agent 客户端安装插件.
DeepSeek Harness
把下面这句发给你的 DeepSeek Harness:
从 npm 安装最新版 dsh-plugin-animegarden 到当前运行的 DeepSeek Harness
Codex
codex plugin marketplace add yjl9903/AnimeGarden
codex plugin add animegarden@animegarden
Claude Code
claude plugin marketplace add yjl9903/AnimeGarden
claude plugin install animegarden@animegarden
安装后打开新会话,直接输入:
使用 AnimeGarden 查找上伊那牡丹第一话资源
使用 Skills
Anime Garden skill: 用于从 Anime Garden 上检索动画资源.
使用 Vercel skills CLI 添加 Anime Garden skill.
npx skills add https://github.com/yjl9903/AnimeGarden --skill animegarden
使用 MCP
Anime Garden MCP 服务端点: https://api.animes.garden/mcp.
例如,在 Claude Code 的 MCP 配置中添加:
{
"mcpServers": {
"animegarden": {
"type": "http",
"url": "https://api.animes.garden/mcp"
}
}
}
使用开放 API
curl "https://api.animes.garden/resources?page=1&pageSize=10"
你可以在这里找到交互式的 Open API 文档, 以及在本仓库的 examples/api.http 文件内查看到更多 API 用例.
你也可以直接使用网站, 在资源列表页 (例如 上伊那牡丹 最新资源) 直接复制生成的 cURL、JavaScript 和 Python 的 API 请求代码.
如果你正在使用 JavaScript 和 TypeScript 进行开发, 那么你可以直接使用 npm 包 @animegarden/client, 它是对这些 API 请求的上层封装.
使用 npm 包
支持 Node.js 24+ 或提供标准 Fetch API 的浏览器环境.
它是 AnimeGarden 的 JavaScript / TypeScript 的 API 客户端封装.
npm i @animegarden/client
示例:
import { fetchResources } from '@animegarden/client';
// Fetch the first page of resources
const result = await fetchResources();
if (!result.ok) {
throw result.error;
}
console.log(result.resources);
// Fetch matching resources across pages
const botan = await fetchResources({
count: -1,
subject: 543360,
fansub: '喵萌奶茶屋',
keywords: ['简日']
});
if (!botan.ok) {
throw botan.error;
}
console.log(botan.resources);
更多程序示例见 ./examples/.
常用筛选条件(取交集):
| 字段 | 筛选逻辑 |
|---|---|
subjects | 按 Bangumi 条目 ID 筛选,多个 ID 匹配任意一个. |
fansubs / publishers | 分别按字幕组或发布者名称筛选,匹配任意一个;同时设置时满足任一条件即可. |
search | 按番剧名或关键词搜索标题;设置后忽略 include. |
include | 标题包含任意一个指定词,可用于按番剧名搜索. |
keywords | 标题包含全部指定词,例如 ['1080p', '简日']. |
exclude | 排除标题包含任意一个指定词的资源. |
after / before | 限定发布时间范围,包含边界时间. |
fetchResources() 成功返回时,包含以下字段:
| 字段 | 含义 |
|---|---|
ok | true 表示请求成功. |
resources | 匹配的资源数组,去重后按发布时间从新到旧排序. |
pagination | 最后取得的页码 page、每页条数 pageSize;complete: true 表示没有下一页. |
filter | 服务端解析后实际使用的筛选条件. |
timestamp | 首次成功响应的时间. |
使用内嵌代码
你可以从资源搜索页复制出网页嵌入代码,放到你的博客等各种页面中.
<iframe src="https://animes.garden/iframe?subject=543360" width="100%" height="600" frameborder="0"></iframe>
本地开发
参考 CONTRIBUTING.md 中的描述配置环境和开始开发.
相关项目
- AnimeSpace: Keep following your favourite anime
- anipar: Parse structure metadata from resource's title.
- bgmx: Bangumi Data / API Clients
鸣谢
开源协议
AGPL-3.0 License © 2023 XLor

