孔夫子安康文献检索技能
概述
本技能提供孔夫子二手网（kongfz.com）拍卖栏目的自动化检索功能，专注于发现与陕西安康地区相关的文献、书籍等拍卖物品。当检测到相关物品时，会立即向用户发送提示。
核心功能
0. 固定搜索关键词
每次调用本技能，必须依次搜索以下三个关键词：
- 安康 - 搜索安康地区相关文献和物品
- 来鹿堂 - 搜索安康著名老字号（清代书商、印书局）相关拍品
- 兴安府 - 搜索清代陕南行政区划（辖安康、汉阴、石泉等地）相关文献
执行顺序：安康 → 来鹿堂 → 兴安府
输出格式：汇总三个关键词的搜索结果，按关键词分开展示。
1. 网站检索
使用 xbrowser 技能执行检索（必须，不可直接用 Python requests）。
执行步骤：
- 初始化 xbrowser：
node "C:\Program Files\QClaw\resources\openclaw\config\skills\xbrowser\scripts\xb.cjs" init - 打开拍卖搜索页：
open https://search.kongfz.com/adv.html?type=pm - 等待加载：
wait --load networkidle - 获取元素引用：
snapshot -i（记录 textbox 引用，通常是 e21 为关键词输入框） - 填入关键词：
fill @e21 关键词 - 提交搜索：
press Enter - 等待结果：
wait --load networkidle - 提取结果：
get text body或snapshot -i获取拍品列表
2. 地区识别规则
识别陕西安康相关物品的优先级：
高优先级（立即提示）：
- 物品地区明确标注为"陕西 安康"
- 标题包含"安康文献"、"安康史料"、"安康地方志"等
- 描述中提到"安康县"、"安康地区"、"陕南安康"等
中优先级（关注但不立即提示）：
- 标题包含"安康"但地区不明确
- 相关但非核心的安康文化物品
低优先级（记录但不提示）：
- 仅提及"安康"但实际无关的物品
3. 提示机制
当发现高优先级物品时，使用以下格式提示用户：
📚 发现安康相关拍品！
标题：[物品标题]
地区：[明确地区]
当前价格：[价格] | 剩余时间：[时间]
链接：[物品链接]
执行流程
使用 xbrowser 执行检索
根据 qclaw-rules 系统规则，所有浏览器自动化任务必须委托给 xbrowser 技能执行。
完整 batch 命令模板（一次性执行）：
node "C:\Program Files\QClaw\resources\openclaw\config\skills\xbrowser\scripts\xb.cjs" run --browser cft batch --bail \
"open 'https://search.kongfz.com/adv.html?type=pm'" \
"wait --load networkidle" \
"snapshot -i" \
"fill @e21 安康文字" \
"press Enter" \
"wait --load networkidle" \
"snapshot -i" \
"get text body"
注意：
e21是拍品名称输入框的引用（来自 snapshot），如果页面结构变化需重新获取- 搜索结果页 URL 格式：
https://search.kongfz.com/pm-search-web/pc/auction/search?key=关键词 - 必须用
press Enter提交，点击搜索按钮可能无效
结果解析
从 get text body 的输出中解析：
- 拍品标题（heading 元素）
- 作者、出版社、年代等信息
- 当前价格（
￥开头） - 剩余时间（
X时X分X秒格式） - 拍主昵称和拍品数量
筛选安康相关：
- 搜索结果文本中包含"安康"的拍品
- 检查标题、描述、地区字段
- 按优先级分类后提示用户
脚本说明
scripts/kongfz_search_xbrowser.py
Python 脚本，调用 xbrowser CLI 执行完整搜索流程。
使用方法：
python scripts/kongfz_search_xbrowser.py --keyword "安康文字" --region "安康"
参考文档
references/kongfz_structure.md
孔夫子网站结构说明，包含：
- 主站：
https://www.kongfz.com/ - 拍卖栏目：
https://www.kongfz.cn/（新版独立域名） - 搜索页面：
https://search.kongfz.com/adv.html?type=pm（拍卖区高级搜索） - 搜索结果：
https://search.kongfz.com/pm-search-web/pc/auction/search?key=关键词 - 商品详情：
https://item.kongfz.com/book/{ID}.html - 分类ID参考：34=红色文献, 3=历史, 12=国学古籍, 3003=地方史志
⚠️ 已废弃URL：
https://www.kongfz.com/auction/（404错误）https://search.kongfz.com/product/search?q=...（404错误）
使用示例
用户请求示例：
- "帮我看看孔夫子网上有没有安康的文献拍卖"
- "监控孔夫子拍卖栏目，有安康的书就告诉我"
- "搜索陕西安康的地方志拍卖"
技能响应示例：
🔍 正在检索孔夫子拍卖栏目...
✅ 检索完成，发现 3 件安康相关拍品：
📚 高优先级（立即提示）
1. 《安康地区志》1995年版，地区：陕西 安康，当前价：¥280
2. 安康文史资料选辑（全套），地区：陕西 安康，当前价：¥450
📋 中优先级（已记录）
3. 陕南民俗文化（含安康章节），地区未明确，当前价：¥120