\r \r

孔夫子安康文献检索技能\r

\r

概述\r

\r 本技能提供孔夫子二手网（kongfz.com）拍卖栏目的自动化检索功能，专注于发现与陕西安康地区相关的文献、书籍等拍卖物品。当检测到相关物品时，会立即向用户发送提示。\r \r

核心功能\r

\r

0. 固定搜索关键词\r

\r 每次调用本技能，必须依次搜索以下三个关键词：\r \r

1. 安康 - 搜索安康地区相关文献和物品\r
2. 来鹿堂 - 搜索安康著名老字号（清代书商、印书局）相关拍品\r
3. 兴安府 - 搜索清代陕南行政区划（辖安康、汉阴、石泉等地）相关文献\r \r 执行顺序：安康 → 来鹿堂 → 兴安府\r \r 输出格式：汇总三个关键词的搜索结果，按关键词分开展示。\r \r ---\r \r

1. 网站检索\r

\r 使用 xbrowser 技能执行检索（必须，不可直接用 Python requests）。\r \r 执行步骤：\r \r

1. 初始化 xbrowser：node "C:\Program Files\QClaw\resources\openclaw\config\skills\xbrowser\scripts\xb.cjs" init\r
2. 打开拍卖搜索页：open https://search.kongfz.com/adv.html?type=pm\r
3. 等待加载：wait --load networkidle\r
4. 获取元素引用：snapshot -i（记录 textbox 引用，通常是 e21 为关键词输入框）\r
5. 填入关键词：fill @e21 关键词\r
6. 提交搜索：press Enter\r
7. 等待结果：wait --load networkidle\r
8. 提取结果：get text body 或 snapshot -i 获取拍品列表\r \r

2. 地区识别规则\r

\r 识别陕西安康相关物品的优先级：\r \r 高优先级（立即提示）：\r

• 物品地区明确标注为"陕西 安康"\r
• 标题包含"安康文献"、"安康史料"、"安康地方志"等\r
• 描述中提到"安康县"、"安康地区"、"陕南安康"等\r \r 中优先级（关注但不立即提示）：\r
• 标题包含"安康"但地区不明确\r
• 相关但非核心的安康文化物品\r \r 低优先级（记录但不提示）：\r
• 仅提及"安康"但实际无关的物品\r \r

3. 提示机制\r

\r 当发现高优先级物品时，使用以下格式提示用户：\r \r

📚 发现安康相关拍品！\r
标题：[物品标题]\r
地区：[明确地区]\r
当前价格：[价格] | 剩余时间：[时间]\r
链接：[物品链接]\r
```\r
\r
## 执行流程\r
\r
### 使用 xbrowser 执行检索\r
\r
根据 qclaw-rules 系统规则，所有浏览器自动化任务必须委托给 **xbrowser** 技能执行。\r
\r
**完整 batch 命令模板**（一次性执行）：\r
\r
```bash\r
node "C:\Program Files\QClaw\resources\openclaw\config\skills\xbrowser\scripts\xb.cjs" run --browser cft batch --bail \\r
  "open 'https://search.kongfz.com/adv.html?type=pm'" \\r
  "wait --load networkidle" \\r
  "snapshot -i" \\r
  "fill @e21 安康文字" \\r
  "press Enter" \\r
  "wait --load networkidle" \\r
  "snapshot -i" \\r
  "get text body"\r
```\r
\r
**注意**：\r
- `e21` 是拍品名称输入框的引用（来自 snapshot），如果页面结构变化需重新获取\r
- 搜索结果页 URL 格式：`https://search.kongfz.com/pm-search-web/pc/auction/search?key=关键词`\r
- 必须用 `press Enter` 提交，点击搜索按钮可能无效\r
\r
### 结果解析\r
\r
从 `get text body` 的输出中解析：\r
- 拍品标题（heading 元素）\r
- 作者、出版社、年代等信息\r
- 当前价格（`￥` 开头）\r
- 剩余时间（`X时X分X秒` 格式）\r
- 拍主昵称和拍品数量\r
\r
**筛选安康相关**：\r
1. 搜索结果文本中包含"安康"的拍品\r
2. 检查标题、描述、地区字段\r
3. 按优先级分类后提示用户\r
\r
## 脚本说明\r
\r
### scripts/kongfz_search_xbrowser.py\r
\r
Python 脚本，调用 xbrowser CLI 执行完整搜索流程。\r
\r
**使用方法**：\r
```bash\r
python scripts/kongfz_search_xbrowser.py --keyword "安康文字" --region "安康"\r
```\r
\r
## 参考文档\r
\r
### references/kongfz_structure.md\r
\r
孔夫子网站结构说明，包含：\r
- 主站：`https://www.kongfz.com/`\r
- 拍卖栏目：`https://www.kongfz.cn/`（新版独立域名）\r
- 搜索页面：`https://search.kongfz.com/adv.html?type=pm`（拍卖区高级搜索）\r
- 搜索结果：`https://search.kongfz.com/pm-search-web/pc/auction/search?key=关键词`\r
- 商品详情：`https://item.kongfz.com/book/{ID}.html`\r
- 分类ID参考：34=红色文献, 3=历史, 12=国学古籍, 3003=地方史志\r
\r
**⚠️ 已废弃URL**：\r
- `https://www.kongfz.com/auction/`（404错误）\r
- `https://search.kongfz.com/product/search?q=...`（404错误）\r
\r
## 使用示例\r
\r
**用户请求示例**：\r
1. "帮我看看孔夫子网上有没有安康的文献拍卖"\r
2. "监控孔夫子拍卖栏目，有安康的书就告诉我"\r
3. "搜索陕西安康的地方志拍卖"\r
\r
**技能响应示例**：\r
```\r
🔍 正在检索孔夫子拍卖栏目...\r
✅ 检索完成，发现 3 件安康相关拍品：\r
\r
📚 高优先级（立即提示）\r
1. 《安康地区志》1995年版，地区：陕西 安康，当前价：¥280\r
2. 安康文史资料选辑（全套），地区：陕西 安康，当前价：¥450\r
\r
📋 中优先级（已记录）\r
3. 陕南民俗文化（含安康章节），地区未明确，当前价：¥120\r
```\r