网文情报站数据更新日 2026-10-06
搜书登录

NOVELCATCH / MCP

让自己的 AI 查询本站数据

用你自己账号的个人 token,让 AI 帮你找书、比较与跟进收藏,不用在网页里反复筛选。

接入客户端:Codex、WorkBuddy、豆包工作、ZCode、Qoder CN。

01生成 token

token 生成即将开放,上线后会在更新日志里通知。

02配置客户端

连接地址:https://novelcatch.com/api/mcp

Codex CLI · 从终端启动

在自己的终端设置本会话环境变量,再添加服务。变量的值就是你创建的 token,不要加 Bearer 前缀。

本会话环境变量
export NOVELCATCH_MCP_TOKEN='<你的token>'

Codex CLI 命令
codex mcp add novelcatch --url https://novelcatch.com/api/mcp --bearer-token-env-var NOVELCATCH_MCP_TOKEN

等价 TOML 配置
环境变量 TOML
[mcp_servers.novelcatch]
url = "https://novelcatch.com/api/mcp"
bearer_token_env_var = "NOVELCATCH_MCP_TOKEN"

CLI 可用 /mcp 查看连接状态。只通过连接配置提供 token,不要贴到 AI 对话或提交到 git;也别把含真实 token 的命令留在共享终端历史里。

Codex desktop · 从桌面启动

与同一台电脑上的 CLI 共用 ~/.codex/config.toml,修改后重启客户端。通过 Finder 启动时,不保证继承终端的 export。

桌面端也可以把 token 直接写进本地配置,替换下方的占位文字。它会把 token 明文保存在你的本地配置文件里,请妥善保管该文件,不上传或共享。与上面的环境变量方案二选一,已有 NovelCatch 配置时替换对应段,不重复添加。

桌面端本地 TOML
[mcp_servers.novelcatch]
url = "https://novelcatch.com/api/mcp"
http_headers = { Authorization = "Bearer <你的token>" }

Codex 官方 MCP 文档与安装入口

03试一句需求

  • “找几本我关注分类近期表现较好的书,并说明数据日期”
  • “看看我收藏的书今天有什么变化”
  • “先确认本站指标定义,再比较这两本书”

让 AI 保留数据日期与口径;陈旧数据、缺测都不等于 0,推断也不代表官方结论。

可查询什么

首批支持 7 个工具,即将支持更多。

find_books
按分类、题材与近期表现找书,缩小对标范围。
get_books
比较指定书籍;单次最多 20 本,可选 summary 摘要或 full 详情。
get_rank
查看官方榜单前 30 名,判断当前分类表现。
get_debut_books
查看首秀书籍与表现,需具备网站对应授权;首秀与相关结论为推断。
get_my_books
查看自己的收藏与常用视图,跟进关注的书。
get_topic_overview
了解题材概况,辅助开题与选题比较。
get_glossary
确认指标定义,理解数据口径。

遇到问题

  • 401 / token 失效:重新生成,并更新客户端配置。
  • 403 / 授权不足:确认账号是否具备网站对应权限。
  • 429:当天额度用尽时,按网站规则等待重置;若是请求太频繁,降低频率并稍后重试。
  • busy / 503:按返回的重试等待时间(retry_after)稍后再试。
  • 工具不可见:检查 server 是否启用、是否已给当前 assistant 选择 NovelCatch,以及模型是否支持 tool calls。
  • 数据不新或没有值:先看数据日期与缺测说明,不把缺测当作 0。