search-anime

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

search-anime skill

search-anime 技能

Search anime and manga by natural-language query using the ani CLI and AniList.
借助ani CLI和AniList,通过自然语言查询搜索动画和漫画。

features

功能特性

  • natural language search — type what you want, it figures out the
    ani
    command
  • trending — what's trending in anime or manga right now
  • streaming links
    info
    shows Crunchyroll, HIDIVE, and other links from AniList
  • recommendations — what AniList users recommend next to any title
  • hidden gems — titles with high scores but low view counts
  • season preview — what's airing this season and what's coming up
  • similarity search — "like Attack on Titan" searches by that show's genres
  • manga — works for manga too, just add
    --manga
  • 自然语言搜索 — 输入你想要的内容,它会自动生成对应的
    ani
    命令
  • 热门趋势 — 当前动画或漫画中的热门作品
  • 流媒体链接
    info
    模式会展示来自AniList的Crunchyroll、HIDIVE等平台链接
  • 推荐内容 — AniList用户针对任意作品推荐的后续作品
  • 冷门佳作 — 评分高但观看量低的作品
  • 季番预览 — 当前播出及即将上线的作品
  • 相似搜索 — 输入“like Attack on Titan”会按该作品的题材进行搜索
  • 漫画支持 — 同样适用于漫画,只需添加
    --manga
    参数

usage

使用方法

/search-anime                                # default: trending digest (anime + manga)
/search-anime trending                       # currently trending anime
/search-anime trending --manga               # currently trending manga
/search-anime popular                        # popular this season
/search-anime popular --season winter --year 2024
/search-anime upcoming                       # season preview: upcoming + current popular
/search-anime top                            # top-rated of all time
/search-anime all-time                       # most-watched of all time
/search-anime search <natural query>         # smart NL search
/search-anime info <title or AniList id>     # full detail card with streaming links
/search-anime digest                         # full weekly briefing
/search-anime gems                           # hidden gems: high score, lower popularity
/search-anime gems --manga                   # hidden gem manga
/search-anime binge                          # completed series worth binging (24+ eps)
natural search examples
/search-anime search action anime from 2023 with score above 85
/search-anime search something like attack on titan
/search-anime search dark psychological thriller finished
/search-anime search slice of life romance with high ratings
/search-anime search isekai comedy
/search-anime search mecha sci-fi from the 90s
/search-anime                                # 默认:热门趋势摘要(动画+漫画)
/search-anime trending                       # 当前热门动画
/search-anime trending --manga               # 当前热门漫画
/search-anime popular                        # 本季流行作品
/search-anime popular --season winter --year 2024
/search-anime upcoming                       # 季番预览:即将上线+当前流行作品
/search-anime top                            # 历史高分排行
/search-anime all-time                       # 历史总播放量排行
/search-anime search <natural query>         # 智能自然语言搜索
/search-anime info <title or AniList id>     # 包含流媒体链接的完整详情卡片
/search-anime digest                         # 完整每周简报
/search-anime gems                           # 冷门佳作:高评分、低人气
/search-anime gems --manga                   # 漫画类冷门佳作
/search-anime binge                          # 值得一口气看完的完结作品(24集以上)
自然语言搜索示例
/search-anime search action anime from 2023 with score above 85
/search-anime search something like attack on titan
/search-anime search dark psychological thriller finished
/search-anime search slice of life romance with high ratings
/search-anime search isekai comedy
/search-anime search mecha sci-fi from the 90s

workflow

工作流程

0. prerequisite check

0. 前置检查

Before any command, verify
ani
is installed:
bash
which ani
If not found, stop and tell the user:
ani
is not installed. Install it from https://github.com/pavelsimo/ani
go install github.com/pavelsimo/ani@latest
or grab a release binary.
在执行任何命令前,先验证
ani
是否已安装:
bash
which ani
如果未找到,停止操作并告知用户:
ani
未安装。请从https://github.com/pavelsimo/ani 安装 — 可执行
go install github.com/pavelsimo/ani@latest
或下载预编译二进制文件。

1. mode detection

1. 模式检测

Parse the first argument:
ArgumentMode
(none) or
digest
digest
trending
trending
popular
popular
upcoming
preview
top
top
all-time
all-time
search <query>
search
info <name-or-id>
info
gems
gems
binge
binge
--manga
flag anywhere → append
--type manga
to all
ani
calls for that invocation.
--lang english
→ append
--lang english
to all calls. Derive the current season from today's month: Jan–Mar = winter, Apr–Jun = spring, Jul–Sep = summer, Oct–Dec = fall.
解析第一个参数:
参数模式
(无) 或
digest
摘要模式
trending
热门趋势模式
popular
流行模式
upcoming
预览模式
top
高分排行模式
all-time
历史总榜模式
search <query>
搜索模式
info <name-or-id>
详情模式
gems
冷门佳作模式
binge
binge模式
--manga
参数可放在任意位置 → 本次调用的所有
ani
命令都会追加
--type manga
--lang english
→ 所有命令都会追加
--lang english
。根据当前月份自动推导当前季度:1-3月=冬季,4-6月=春季,7-9月=夏季,10-12月=秋季。

2. execute selected mode

2. 执行选定模式

After detecting the mode, read reference/output-modes.md for the exact
ani
commands, JSON parsing rules, output templates, and error handling for that mode. Read reference/reference-tables.md when mapping natural-language genres, formats, or score displays.
检测到模式后,查看reference/output-modes.md获取对应
ani
命令的具体内容、JSON解析规则、输出模板以及该模式下的错误处理方式。映射自然语言题材、格式或评分展示时,请参考reference/reference-tables.md

best practices

最佳实践

  • always use
    --json
    — never parse the human-readable table output
  • always show interpreted filters after NL search so the user can correct them
  • deduplicate by
    id
    in digest and preview modes — never show the same title twice
  • cap per-page at 50 — that is the AniList API maximum
  • convert seconds to human time
    timeUntilAiring
    is in seconds; always display as "Xd Yh"
  • derive the current season dynamically from today's month; never hardcode it
  • null-guard recommendations
    mediaRecommendation
    can be null if the entry was deleted; skip silently
  • streaming links are detail-only
    externalLinks
    only comes from
    ani info
    , not from list commands; surface a tip in list modes to run
    /search-anime info <title>
    for streaming links
  • 始终使用
    --json
    参数
    — 切勿解析人类可读的表格输出
  • 自然语言搜索后始终展示解析后的筛选条件 以便用户修正
  • 在摘要和预览模式下按
    id
    去重
    — 切勿重复展示同一作品
  • 每页上限设为50 — 这是AniList API的最大限制
  • 将秒数转换为易读时间格式
    timeUntilAiring
    字段以秒为单位;始终显示为“Xd Yh”格式
  • 根据当前月份动态推导季度 — 切勿硬编码季度信息
  • 处理推荐内容的空值情况 — 若作品条目已删除,
    mediaRecommendation
    可能为空;需静默跳过
  • 流媒体链接仅在详情模式提供
    externalLinks
    仅来自
    ani info
    命令,列表类命令无法获取;在列表模式下需提示用户运行
    /search-anime info <title>
    来查看流媒体链接