前言¶
做网文选题或竞品调研时，往往需要反复打开番茄小说各品类的新书榜、阅读榜，手工抄书名、在读数和排名变化。页面还有字体混淆，直接扒 HTML 容易得到乱码。下面介绍 SkillHub 上的「番茄小说榜单分析」Skill：把榜单查询、字段解码和导出分析写进 SKILL.md 与脚本，让 Agent 按固定参数调用官方榜单 API，而不是每次从零摸索抓取方式。
这是什么¶
「番茄小说榜单分析」（包内标识 fanqie-novel-rank，当前社区版本 1.0.1）是托管在 SkillHub 的 data-analysis 类 Agent Skill。它面向 fanqienovel.com 排行榜：通过番茄 /api/rank/category/list 拉取数据，内置自定义字体解码，输出排名、书名、作者、字数、在读热度、排名变化等字段，供表格对比或导出后做统计。
Skill 由社区发布者 @indiv-zeyl 维护；社区索引中的简介为：番茄小说榜单抓取与分析，支持阅读榜/新书榜、男频/女频，以及 19 个男频与 18 个女频细分品类。SkillHub 侧可见评分约 99646、下载约 563 次（以社区页面展示为准）。官方入口：https://api.skillhub.cn/user_7079a474/fanqie-novel-rank
核心功能¶
以下能力均来自 Skill 包内 SKILL.md 与 references/api.md 的说明。
榜单查询¶
- 按性别、榜种、品类拉取 Top N：男频/女频（
-c 1或2）、阅读榜/新书榜（-t 0或1）、品类 ID 或中文名模糊匹配（-g）。 - 全站总榜：
-g 0时在多个子品类结果上去重，再按热度聚合排序。 - 关键词过滤：
--filter在已抓取结果的书名、作者、简介中匹配。
数据字段¶
脚本返回字段包括：bookId、bookName、author、abstract、thumbUri、wordNumber、read_count（热度）、creationStatus（完结/连载）、lastChapterTitle、lastChapterUpdateTime、currentPos、rankPosDiff（排名升降）。
输出与运行时¶
- 输出格式：
table（默认）、json、csv，可用-O写入文件。 - 详细模式
-v：附带简介预览、最新章节与更新时间。 - 本地缓存默认 5 分钟 TTL；
--no-cache强制实时请求。 - 提供 Python 3（
scripts/fetch_rank.py）与 Node.js 14+（scripts/fetch_rank.js）两套实现，共享scripts/shared/dit_data.json字体解码表；依赖均为标准库。
分析场景（导出后）¶
Skill 文档中归纳了可做的二次分析方向，例如：多品类平均 read_count 对比、简介关键词统计、作者上榜频次、连载与完结占比、字数分档、更新活跃度、新书榜 rankPosDiff 爬升速度、同品类阅读榜与新书榜对照等。这些依赖你把 CSV/JSON 导入 Excel 或自有脚本，Skill 本身不内置图表。
明确不支持的能力¶
API 只提供当前快照，不能查历史时间序列、章节正文、读者评论或评分、作者主页。--filter 仅过滤本次已拉取的结果，不是全站搜索。
安装与启用¶
经 skillhub search 核对，安装命令为：
skillhub install fanqie-novel-rank --namespace indiv-zeyl
默认会安装到当前目录下的 ./skills；如需指定目录，增加 --dir，例如：
skillhub install fanqie-novel-rank --namespace indiv-zeyl --dir ~/.cursor/skills
安装完成后，Agent 会读取包内 SKILL.md 中的参数说明与示例命令。本文未在官方资料中看到 Cursor、Codex CLI、Claude Code 的差异化安装步骤；若你使用其他客户端，一般以「把 Skill 目录放到该客户端识别的 skills 根目录」为准，具体以 SkillHub 页面说明为准。
典型用法¶
下列命令摘自 Skill 包内 Quick Start；路径相对于 Skill 根目录。
查看指定品类 Top 榜：
python3 scripts/fetch_rank.py -c 1 -t 0 -g 1140 -l 10
node scripts/fetch_rank.js -c 2 -t 1 -g 248 -l 20
含义：前者为男频阅读榜·东方仙侠 Top10；后者为女频新书榜·玄幻言情 Top20。-g 也可写中文模糊名，如 -g "都市"。
全站总榜与搜书：
python3 scripts/fetch_rank.py -c 1 -t 0 -g 0 -l 30
python3 scripts/fetch_rank.py -c 1 -t 0 -g 0 --filter "系统" -l 30
导出与刷新：
python3 scripts/fetch_rank.py -c 1 -t 0 -g 0 -l 50 -f csv -O 男频总榜.csv
node scripts/fetch_rank.js -c 2 -t 1 -g 0 -l 30 -f json -O 女频新书.json
python3 scripts/fetch_rank.py -c 1 -t 0 -g 1140 -l 10 --no-cache
在对话里，也可直接用 Skill 描述的触发意图：例如「抓取番茄男频新书榜」「对比各品类在读热度」「看都市修真阅读榜 Top20」。Agent 应按 SKILL.md 选择脚本与参数。
参数对照表（与官方文档一致）：
| 参数 | 取值 | 说明 |
|---|---|---|
-c |
1, 2 | 男频 / 女频 |
-t |
0, 1 | 阅读榜 / 新书榜 |
-g |
ID 或名称 | 品类；0 表示全品类聚合 |
-l |
数字 | 条数，默认 20 |
-f |
table, json, csv | 输出格式 |
-v |
标志 | 输出简介与更新信息 |
--filter |
字符串 | 结果内关键词过滤 |
--no-cache |
标志 | 跳过缓存 |
完整品类 ID 见包内 references/categories.md。
适用场景与注意¶
适合谁： 网文作者、编辑或运营，需要快速扫榜、比品类热度、跟新书爬升；数据分析师把榜单导出为 CSV 再做透视；在 Agent 工作流里把「拉榜」变成可重复命令的人。
使用注意：
- 数据来自番茄公开榜单 API，请遵守站点使用规范，控制请求频率；Skill 说明全品类模式会并发子请求（最多 4 路）并带随机延迟，仍有被限流风险。
rank_version需从榜单页状态解析，脚本会缓存；异常时可能返回空列表，可稍后重试或--no-cache。- 需要历史趋势时，需自行定时抓取落库；Skill 仅提供当前快照。
- 社区安装命名空间为
indiv-zeyl；若官方页面 URL 与 CLI 命名空间不一致，以skillhub search fanqie-novel-rank当前输出为准。
结尾¶
「番茄小说榜单分析」把番茄排行榜 API、字体解码和导出参数封装成 Agent Skill，减少手工抄榜和乱码问题，并把分析字段写清楚，便于后续在表格或脚本里继续算。安装与详情见 SkillHub：https://api.skillhub.cn/user_7079a474/fanqie-novel-rank
