fanghongyuanwenshu — 裁判文书网搜索通用技能

> 版本: v10.1 | 更新: 2026-04-04

> 本技能为通用分享版，不含任何个人账号密码信息。

> 首次运行会引导补全账号密码和搜索条件，之后自动记忆。

功能概述

| 功能 | 说明 |

|------|------|

| 搜索方式 | 纯 UI 操作，不拦截不篡改任何请求 |

| 筛选条件 | 案由 / 文书类型 / 地区 / 年份 / 审判程序 |

| 正文提取 | 自动访问文书详情页，提取判决书全文 |

| 正文清洗 | 自动去除网页噪音（导航/版权/平台链接/板块标签） |

| Excel 导出 | 13列，含判决书全文，格式自动换行 |

| 安全机制 | 详情页间隔3秒，每5篇暂停5秒，连续2篇失败自动停 |

| 静默模式 | 默认 headless=True，后台运行不弹浏览器 |

| 账号记忆 | 首次输入后自动记忆，密码仅首次需要 |

搜索关键词建议

运行时会提示输入以下参数，以下为常用示例：

| 参数 | 说明 | 常用示例 |

|------|------|---------|

| 案由 | 纠纷类型（中文全称） | 房屋租赁合同纠纷、民间借贷纠纷、买卖合同纠纷、建设工程合同纠纷、劳动争议、交通事故责任纠纷、离婚纠纷、机动车交通事故责任纠纷 |

| 文书类型 | 判决书/裁定书/调解书 | 判决书（默认）|

| 地区 | 省份名称 | 广东省、北京市、上海市、浙江省、江苏省、四川省、山东省 |

| 年份 | 裁判年份（4位数字） | 2025、2026 |

| 审判程序 | 一审/二审/再审 | 一审,二审（默认，同时搜两种）|

运行方式

# 默认：测试模式，仅抓前10条
python wenshu_search.py

# 测试模式（显式）
python wenshu_search.py --test

# 全量模式（抓全部文书）
python wenshu_search.py --full

> ⚠️ 全量模式建议正式使用时分批运行，避免短时间内大量访问导致账号风控。

首次配置向导

首次运行（无 .wenshu_config.json 时）会显示交互式配置：

============================================================
  裁判文书网搜索 v10 — 首次配置向导
============================================================
  提示：配置只输入一次，之后自动记忆（密码除外）
        按 Enter 使用默认值

📋 裁判文书网账号（手机号）[]：
🔑 裁判文书网密码：
🔍 案由（中文）[默认=房屋租赁合同纠纷]：
📄 裁判文书类型 [判决书 / 裁定书 / 调解书，默认=判决书]：
⚖️  审判程序（一审/二审/再审，可用逗号分隔）[默认=一审,二审]：
🌏 地区（中文省份）[默认=广东省]：
📅 裁判年份（4位数字）[默认=当前年份]：

Excel 输出字段（13列）

序号 / 案件名称 / 案号 / 判决书内容 / 法院名称 / 法院省份 / 法院地市 / 案件类型 / 审判程序 / 案由 / 裁判年份 / 裁判日期 / 当事人

• 判决书全文直接嵌入 Excel 第4列，已清洗网页噪音
• 全文超32000字自动截断并标注
• 所有列启用自动换行，判决书内容列宽60，其余紧凑

合规使用准则

• ✅ 只模拟正常用户操作（登录、点击、翻页）
• ✅ 只读监听，不拦截不篡改任何请求
• ✅ 合理间隔，不高频批量访问
• ❌ 严禁 page.route() 拦截/篡改请求
• ❌ 严禁绕过服务器安全机制
• ⚠️ 账号被封禁风险与访问频率正相关，请勿高频批量抓取

文件结构

fanghongyuanwenshu/
├── SKILL.md              ← 本文件
└── scripts/
    └── wenshu_search.py  ← 主脚本（通用版，已脱敏）

常见案由代码参考

本技能支持以下常见案由（案由代码自动对应）：

房屋租赁合同纠纷    民间借贷纠纷      买卖合同纠纷
建设工程合同纠纷    劳动争议          交通事故责任纠纷
离婚纠纷            机动车交通事故责任纠纷
服务合同纠纷        租赁合同纠纷

如需其他案由，修改脚本中 S14_CODE_SEARCH 和 S14_CODE_FILTER 对应代码即可。

本技能基于裁判文书网公开数据，仅供法律研究与案件参考使用。