核心用法
MAL Lookup 是一套命令行工具,通过调用 MyAnimeList.net 内部 load.json 与 prefix.json 端点实现数据抓取。支持三大功能模块:
1. 标题搜索:mal search anime|manga <关键词> 快速匹配作品;
2. 高级筛选:mal advanced <genre> [最低评分] 按类型与评分区间检索,涵盖 Action、Psychological、Slice of Life 等 15+ genre;
3. 用户与榜单:mal list <type> <用户名> [状态] 抓取个人追番列表,mal top / mal season <年> <季> 查看热门与季度排行。
显著优点
- 零配置成本:无需 MAL API Key,绕过 Jikan 第三方服务的不稳定性;
- 响应快:直接请求官方内部端点,延迟低;
- 轻量依赖:仅依赖 curl、jq、grep、awk 等标准 Unix 工具;
- 场景覆盖全:从即时搜索到深度筛选,再到社交化的用户榜单,满足追番、补番、研究等多场景。
潜在缺点与局限性
- 非官方接口风险:使用未公开的
load.json端点,MAL 随时可能变更或封禁; - 数据完整度受限:内部端点返回字段少于官方 API,部分元数据(如详细制作人员、完整声优表)可能缺失;
- 无身份验证:无法访问私密列表或执行评分、更新状态等写操作;
- 速率限制不明:缺乏官方文档说明,高频调用存在临时封 IP 的可能;
- 解析脆弱性:依赖 HTML/JSON 结构稳定性,页面改版会导致脚本失效。
适合人群
- 动漫/漫画爱好者需要快速查作品、追更新、补旧番;
- 不想申请 API Key 的轻度开发者或脚本用户;
- 需要集成 MAL 数据到个人工作流(如终端、笔记软件)的极客用户。
常规风险
- 服务中断:非官方端点被封锁或限流后功能失效;
- 数据时效性:缓存或延迟导致榜单、评分与网页版不一致;
- 合规灰色地带:虽仅读取公开数据,但违反 MAL ToS 潜在条款;
- 依赖链风险:jq、curl 等工具版本差异可能导致解析失败。
---
版本 1.3.0 | 依赖:curl, jq, grep, awk