Fanghongyuanwenshu

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

> **版本**: v10.1 | **更新**: 2026-04-04  
> 本技能为**通用分享版**，不含任何个人账号密码信息。
> 首次运行会引导补全账号密码和搜索条件，之后自动记忆。

---

## 功能概述

| 功能 | 说明 |
|------|------|
| 搜索方式 | 纯 UI 操作，不拦截不篡改任何请求 |
| 筛选条件 | 案由 / 文书类型 / 地区 / 年份 / 审判程序 |
| 正文提取 | 自动访问文书详情页，提取判决书全文 |
| 正文清洗 | 自动去除网页噪音（导航/版权/平台链接/板块标签） |
| Excel 导出 | 13列，含判决书全文，格式自动换行 |
| 安全机制 | 详情页间隔3秒，每5篇暂停5秒，连续2篇失败自动停 |
| 静默模式 | 默认 headless=True，后台运行不弹浏览器 |
| 账号记忆 | 首次输入后自动记忆，密码仅首次需要 |

---

## 搜索关键词建议

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

| 参数 | 说明 | 常用示例 |
|------|------|---------|
| **案由** | 纠纷类型（中文全称） | 房屋租赁合同纠纷、民间借贷纠纷、买卖合同纠纷、建设工程合同纠纷、劳动争议、交通事故责任纠纷、离婚纠纷、机动车交通事故责任纠纷 |
| **文书类型** | 判决书/裁定书/调解书 | 判决书（默认）|
| **地区** | 省份名称 | 广东省、北京市、上海市、浙江省、江苏省、四川省、山东省 |
| **年份** | 裁判年份（4位数字） | 2025、2026 |
| **审判程序** | 一审/二审/再审 | 一审,二审（默认，同时搜两种）|

---

## 运行方式

```bash
# 默认：测试模式，仅抓前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` 对应代码即可。

---

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