mal-lookup

🎌 动漫番剧极速搜索追踪

直连MyAnimeList官方端点的二次元查询工具,支持番剧搜索、用户列表及排行榜,为动漫迷提供快速准确的追番数据服务。

收藏
2.5k
安装
502
版本
v1.3.1
CLS 安全性认证2026-05-20
点击查看完整报告 >

使用说明

核心用法

该技能通过调用MyAnimeList.net的内部端点,提供了一系列动漫与漫画数据查询功能。主要支持四种操作模式:基础搜索mal search)允许按标题查找动漫或漫画;高级筛选mal advanced)支持按类型(如action、psychological等)和最低评分进行精准查找;用户列表查询mal list)可获取指定用户的观看/阅读列表及状态;排行榜浏览mal topmal season)提供当前热播排行及特定季度的番剧榜单。所有操作均通过标准系统工具(curl、jq等)直接请求MAL服务器完成。

显著优点

最突出的优势在于绕过第三方API限制。不同于依赖Jikan等第三方API的方案,该工具直接对接MAL内部端点,避免了API速率限制、数据延迟或服务中断问题。其次,功能覆盖全面,从基础搜索到高级筛选再到用户列表同步,形成了完整的动漫数据查询闭环。命令设计直观易懂,采用自然语言式的指令结构,降低了使用门槛。此外,纯文档型架构确保了零代码执行风险,仅依赖系统标准工具即可完成所有操作,安全性极高。

潜在缺点与局限性

作为T3来源的个人开发者作品,长期维护稳定性存在不确定性。由于直接调用MAL内部端点,存在MAL网站结构变更导致接口失效的风险,且这种非官方API的使用方式可能随时被MAL方面限制。功能上目前仅支持查询操作,无法修改用户列表或执行评分等互动操作。网络依赖性强,必须确保能访问myanimelist.net,在部分网络受限环境下可能无法使用。此外,高级搜索的类别支持虽广但仍有边界,某些细分标签可能无法覆盖,且缺乏官方API的详细文档支持。

适合的目标群体

该技能特别适合重度动漫与漫画爱好者追番管理用户,尤其是需要快速查询作品信息、跟踪朋友观看进度或浏览季度新番的观众。对于内容创作者(如漫评博主、二次元资讯编辑)也是高效的数据查询工具。同时适合需要集成动漫数据到工作流的技术用户,因其命令行接口便于脚本化调用和自动化处理。

使用风险

主要风险在于外部依赖的单点故障:若MyAnimeList.net服务宕机或更改内部接口,该技能将立即失效。T3来源意味着代码审核和更新频率依赖个人开发者,可能存在响应延迟或弃坑风险。虽然当前为纯文档型无代码执行风险,但未来若添加脚本实现需注意输入验证和错误处理。网络请求方面,仅查询公开数据不涉敏感信息泄露,但用户需确保网络环境可访问MAL(部分地区可能需要特殊网络配置)。依赖工具(特别是jq)在某些精简系统可能未预装,需手动配置环境才能正常使用。

安全解读

核心用法

mal-lookup 是一款面向动漫爱好者的命令行数据查询工具,通过直接调用 MyAnimeList 官方内部端点(load.json / prefix.json),绕开 Jikan 等第三方 API 的稳定性问题。核心功能涵盖四大场景:

1. 基础搜索mal search <anime|manga> "query" 按标题检索作品
2. 进阶筛选mal advanced <genre> [min_score] 按类型与最低评分筛选,如 mal advanced psychological 0 获取心理类高分作品

3. 用户列表mal list <type> <username> [status] 抓取任意用户的观看/阅读清单,支持状态过滤(watching/completed 等)

4. 榜单数据mal top 获取当前热播前十,mal season <year> <season> 查询特定季度番剧

内置 15+ 种类型标签(action、psychological、slice_of_life 等),满足细分检索需求。

显著优点

  • 直连官方数据源:相比 Jikan 等社区 API,MAL 原生端点响应更快、数据更完整,避免第三方服务宕机导致的不可用
  • 零依赖轻量化:仅需系统预装的 curl/jq/grep/awk,无 Python/Node 等运行时负担,适配各类终端环境
  • 隐私友好:无需用户登录或 API Key,查询匿名进行,不触及个人账号数据
  • 社区驱动:开源在 openclaw/skills 仓库,功能迭代响应动漫社区实际需求

潜在局限

  • 无持久化缓存:每次查询均实时拉取,高频使用可能触发 MAL 速率限制
  • 功能边界清晰:仅支持公开数据检索,无法修改用户列表或访问隐私设置
  • 文档型工具:实际执行依赖外部 curl 命令, Skill 本身不含可执行代码,需用户环境正确配置
  • 版权合规盲区:未明确标注 MAL 服务条款约束,商业场景使用存在灰色地带

适合人群

  • 追番/补番需要快速查评分、类型、播出信息的动漫观众
  • 管理大量观看记录、需批量导出他人清单的数据整理者
  • 构建动漫推荐系统、需稳定数据源的开源开发者
  • 终端重度用户,偏好命令行交互而非网页浏览

常规风险

  • 速率限制:频繁查询可能导致 IP 被 MAL 临时封禁,建议控制调用频率
  • 接口变更:官方内部端点无版本承诺,存在未来失效的可能性
  • 数据准确性:依赖 MAL 社区评分,主观性强,不适合作为唯一决策依据

mal-lookup 内容

手动下载zip · 1.1 kB
SKILL.mdtext/markdown
请选择文件