qidian-reader

# 起点好书推荐 Qidian Reader 通过 openclaw 的浏览器自动化能力访问起点中文网榜单页，等待页面真实渲染完成后提取书单数据，再结合用户偏好做推荐。 不要把 `curl` 作为主路径。起点存在反爬和动态渲染，默认必须使用 openclaw 浏览器自动化；如果仍然被风控，就要明确降级，而不是假装拿到了实时榜单。 榜单 URL 完整列表 → `references/urls.md` 分类与标签说明 → `references/categories.md` ## 触发时机 - "帮我找几本好看的玄幻小说" - "起点现在什么书最火" - "推荐几本完结的都市爽文" - "我喜欢《诡秘之主》这种风格，有类似的吗" - "最近有什么新书值得看" - "帮我找几本适合睡前看的轻松小说" --- ## Step 1：理解用户需求 从用户描述中提取以下维度： ```text 题材偏好：玄幻/仙侠/都市/历史/科幻/悬疑/军事/游戏/轻小说 → 未指定则抓全部分类榜单 完结状态：连载中 / 已完结 / 不限 → 完结优先抓完本榜，连载抓主榜单 参考作品：用户提到的喜欢的书 → 提取该书的核心标签，作为推荐依据 字数偏好：短篇(<100万字) / 中篇(100-300万) / 长篇(>300万) → 从抓取数据的字数字段筛选 其他要求：免费/VIP、男频/女频、新书/老书 ``` --- ## Step 2：选择榜单并通过 openclaw 浏览器自动化抓取 根据用户需求选择对应榜单，见 `references/urls.md`。 ### 抓取原则 ```text 1. 必须调用 openclaw 的真实浏览器上下文，不要只请求静态 HTML。 2. 等待榜单列表、书名、作者等关键节点渲染完成后再提取。 3. 优先执行页面内 DOM 提取，不要依赖整页 HTML 正则。 4. 单次任务控制访问频率，避免连续高频打开多个榜单页。 5. 如果页面出现验证、跳转或空白榜单，明确告知用户“实时榜单暂时不可稳定获取”，并降级为基于用户口味和已知热门书的推荐。 ``` ### 推荐执行方式 优先使用 openclaw 提供的浏览器自动化能力。推荐流程： ```text 打开目标榜单 URL → 等待 networkidle 或榜单主容器出现 → 检查是否进入反爬/验证页 → 在页面上下文内 querySelectorAll 提取书名、作者、分类、字数、简介、链接 → 结果去重、清洗、结构化 → 进入推荐逻辑 必要时： → 放慢节奏 → 只抓 1-2 个榜单 → 保留截图或页面标题用于诊断 ``` ### 自动化抓取失败处理 ```text 页面标题、DOM、截图显示验证页/风控页 → 不要继续硬刷 → 终止本轮抓取 → 告知用户当前实时数据不可稳定获取 → 切换到“基于用户口味 + 经典热门书 + 已知榜单记忆”的降级推荐 页面打开成功但内容为空或节点缺失 → 等待3-5秒后重试一次 → 仍失败则只保留当前已成功抓到的榜单结果 浏览器环境不可用 → 明确说明该 skill 依赖浏览器自动化 → 不要伪装成实时抓取成功 ``` --- ## Step 3：解析提取书目信息 从浏览器已渲染的 DOM 中提取以下字段： ```text 书名 → <h2> 或 class 含 "book-name" 的元素 作者 → class 含 "author" 的元素 分类 → class 含 "tag" 或 "type" 的元素 字数 → 含 "万字" 的文本节点 连载状态 → "连载" / "完本" 简介 → class 含 "intro" 或 "desc" 的元素 月票数 → 榜单排名旁的数字（月票榜专有） 链接 → 书籍详情页 URL ``` 提取后转为结构化列表，每本书保留：书名、作者、分类、字数、状态、简介摘要、链接。 --- ## Step 4：智能筛选与推荐 基于抓取数据 + 用户需求，进行以下处理： **按用户偏好筛选：** ```text 字数筛选：用户要短篇 → 过滤掉 >150万字的书 完结筛选：用户要完结 → 只保留"完本"标记的书 分类筛选：已在抓取时通过 chn 参数处理 ``` **参考书匹配推荐：** ```text 用户说"类似《诡秘之主》"： → 《诡秘之主》标签：西方奇幻、克苏鲁、悬疑、硬核世界观 → 在抓取结果中优先推荐：奇幻分类 + 悬疑元素 + 大字数 → 同时补充大模型知识：风格相近的经典作品 ``` **多榜单交叉验证：** ```text 同一本书在月票榜 + 畅销榜 + 阅读榜都排名靠前 → 标记为"多榜推荐"，权重最高 ``` **抓取降级时的推荐策略：** ```text 如果实时榜单抓取失败： → 明确标注“以下推荐不代表当前实时榜单，仅基于已知热门作品和你的口味偏好” → 优先给出高确定性的经典作品、完本精品、同风格代表作 ``` --- ## Step 5：格式化输出 ```text 📚 起点好书推荐 ━━━━━━━━━━━━━━━━━━━━ 数据来源：起点中文网榜单页 / 降级推荐 采集方式：openclaw 浏览器自动化渲染后提取 筛选条件：玄幻 · 连载中 · 不限字数 🏆 强烈推荐（多榜上榜） 1. 《书名》— 作者名 📖 玄幻 | 🔄 连载中 | 📝 320万字 💡 简介摘要（50字以内） ⭐ 月票榜 #2 · 畅销榜 #1 2. 《书名》— 作者名 ... ✨ 也值得看 3-5. ...（次推荐，上了一个榜单） 🎯 根据你的口味特别推荐 （结合用户提到的参考书，补充1-2本风格相近的经典完结作品， 来自模型知识或稳定书库，标注"经典推荐"以区分实时榜单数据） ━━━━━━━━━━━━━━━━━━━━ 🔗 查看完整榜单：https://www.qidian.com/rank/ ``` 如果用了降级结果，必须明确标注： ```text 本次未能稳定获取实时榜单，以下为基于你的口味偏好和已知热门作品给出的替代推荐。 ``` --- ## 多轮对话支持 用户对推荐结果有进一步要求时： ```text "有没有完结的" → 优先抓完本榜；抓不到则推荐已知完本精品 "字数少一点的" → 筛选 <150万字 "有没有免费的" → 优先抓免费榜 "第一本讲什么的" → 展开该书的详细简介 "还有其他类似的吗" → 扩展同分类推荐 ``` --- ## 注意事项 - 该 skill 的实时数据获取默认依赖 openclaw 浏览器自动化，不依赖裸 `curl` - 若触发反爬或验证页，应立即降级，不要伪造实时榜单结果 - 起点榜单数据每天更新，抓取成功时结果反映当前实时排名 - 部分内容为 VIP 付费章节，免费读者只能看前几章 - 女频内容在女生网（nvsheng.qidian.com），与主站榜单分开 - 如抓取失败，可引导用户直接访问 https://www.qidian.com/rank/