CN Law Hub — 中国法条检索 / PRC Statute & Regulation Search for AI Agents

面向 Claude Code、Codex、Kimi 等 AI Agent 的中国大陆法条与法律法规检索 Skill，直接检索全国人大、国务院、司法部、最高人民法院等 10 个官方来源，支持具体条文检索、跨法规正文搜索、现行有效筛选与官方原文下载。

Chinese legal research Agent Skill for retrieving and verifying Chinese laws from official sources.

覆盖 10 个官方数据源：

1. 国家法律法规数据库（NPC） — flk.npc.gov.cn
2. 国家规章库（Gov Rules） — gov.cn/zhengce/xxgk/gjgzk/
3. 外交条约库（Treaty） — treaty.mfa.gov.cn
4. 国务院政策文件库 — sousuo.www.gov.cn
5. 司法部行政法规库 — xzfg.moj.gov.cn
6. 党内法规库 — www.12371.cn/special/dnfg/
7. 国防部法规文库 — www.mod.gov.cn/gfbw/fgwx/
8. 税务法规库 — fgk.chinatax.gov.cn
9. 生态环境部法规规章 — mee.gov.cn/ywgz/fgbz/
10. 最高人民法院发布栏目 — court.gov.cn/fabu/

| Official sources | Article-level search | Cross-law search | |---|---|---| | Validity filtering | Chinese local & national regulations | Claude Code & Codex |

---

什么时候使用这个 Skill

当你需要查询、核验、下载或引用中国官方法律法规、规章、条约和具体法条时，可以直接让 agent 使用本 skill。多数情况下，你不需要手动运行脚本，只需要用自然语言说明任务，agent 会根据 SKILL.md 自动选择合适的数据源、脚本和参数。

如果你希望确保在当前工作中使用本 skill，也可以在请求中直接使用 /cn-law-hub 指令（尤其在你没有使用能力较强的模型时）。

典型场景包括：查法规全文、核验现行有效状态、查询某法第几条、按关键词检索具体法条、为法律咨询/案例分析/合规审查提供官方法条依据、批量下载法规文件或导出法规目录。

例如：

帮我查《劳动合同法》第三十八条，并引用现行有效版本。
找一下关于物业管理的现行有效地方性法规。
帮我检索包含“违约金”的具体法条，并按法规名称列出来。
这个劳动争议案例可能涉及哪些现行有效法律依据？

<details> <summary>更多可触发本 skill 的中文表达</summary>

你可以使用类似表达：

• 查法律、查法规、查条例、查规章、查条约、查法条
• 查第几条、查询某法第几条、找某条法律依据
• 找法律依据、引用法律依据、引用法条、展开法条分析
• 核验现行有效、判断是否废止、是否已修改、是否尚未生效
• 下载法规全文、批量下载法规文件、导出法规目录
• 按关键词检索具体法条、跨法规查找相关条文
• 查询地方性法规、按地区/制定机关分类
• 在法律咨询、案例分析、合规审查、合同审查、劳动争议、行政法分析、公司合规、数据合规、政策研究中，需要调用中国现行有效法律法规原文作为依据
• 当问题中出现“依法”“依规”“依照法律规定”“根据现行规定”等表达，并且需要核验具体法律依据时，也适合调用本 skill

如果只是一般法律概念解释、普通写作润色，且不需要核验官方法律法规原文，则不一定需要调用本 skill。

</details>

---

功能概览

• 多数据源支持：NPC 国家法律法规数据库、国家规章库、外交条约库、国务院政策文件库、司法部行政法规库、党内法规库、国防部法规文库、税务法规库、生态环境部法规规章、最高人民法院发布栏目
• 标题/正文检索：支持标题关键词、正文关键词两种搜索范围
• 精确/模糊策略：已知标题用 --exact 精确匹配，主题/关键词用模糊匹配
• 现行有效状态筛选：--status 3 仅返回现行有效法规
• 单篇下载：DOCX（WPS 版）/ PDF（公报原版）
• 单条法条查询：--preview 查看结构，--article 按条号或关键词查条文
• 跨法规法条级搜索：scripts/article_search.py 在多部法规正文中定位具体法条
• 批量采集：支持一次性采集 200–300 条法规的完整工作流
• 智能限速：根据任务大小自动选择 OFF / FIXED / ADAPTIVE 模式，避免 429
• 本地缓存：搜索结果、元数据、DOCX 文件默认缓存，复访提速
• URL 导出：云端 agent 可只导出签名下载 URL，供本地下载使用
• 地域/制定机关分类：内置省市映射，自动识别国家级、省级、设区市级
• 多环境支持：Kimi Agent、Claude Code via kimi-webbridge、Codex；其中 Kimi Agent 与 Claude Code via kimi-webbridge 共用同一套 browser adapter，因为两者的浏览器操作语义一致

---

安装

建议使用 Python 3.10+。

pip install -r requirements.txt

部分旧法规可能使用 .doc 格式，需要安装可选系统工具：

# macOS
brew install antiword catdoc

# Debian/Ubuntu
apt-get install antiword catdoc

如需通过 MCP 接入（可选，见下文）：

pip install "mcp>=2.0.0"

---

一键安装

两种接入方式二选一，代码相同，只是接入形态不同：

| | Skill 版（推荐，主路径） | MCP 版（可选） | |---|---|---| | 形态 | 注册为 agent 的 Skill，自然语言或 /cn-law-hub 调用 | 一个 stdio server，暴露 5 个 MCP 工具 | | 适用 | Claude Code / Codex / Kimi 等支持 skill 的 agent | 任意 MCP 兼容 agent（Claude Code / Cline / Cursor / Kimi / Codex） | | 依赖 | 仅 requirements.txt | 额外 pip install "mcp>=2.0.0" | | 配置 | agent 注册 skill | 见 references/mcp_setup.md；Claude Code 自动读 .mcp.json |

发布版请从 Releases 下载 Source code 压缩包。

方式 A：Skill 版（用 Agent 自动配置）

直接把仓库链接丢给 agent，让它自己完成下载、安装依赖和注册 skill。复制以下提示词即可：

请安装并配置这个 Skill：https://github.com/ZongziForu/cn-law-hub/releases/tag/v2.0.2

从上述 release 下载 Source code 压缩包，或 clone 仓库。先阅读仓库中的 SKILL.md 和 references/setup.md，并识别当前平台正确的 skills 目录。不要直接把整个仓库复制到最终安装目录；请先下载到临时目录，再仅安装以下运行时文件：

• SKILL.md
• scripts/
• references/
• requirements.txt
• LICENSE
• LICENSE-APACHE
• NOTICE

不要拷贝 tests/、pytest.ini、CHANGELOG.md、requirements-dev.txt、.mcp.json、*.pyc、__pycache__。

安装依赖：pip install -r requirements.txt（Python 3.10+）。注册完成后，用"帮我查《劳动合同法》第三十八条"验证。

方式 B：MCP 版

pip install "mcp>=2.0.0"
python3 scripts/mcp_server.py        # 启动 stdio server（等待 MCP 客户端连接）

Claude Code 打开仓库即自动读取根目录 .mcp.json 接入；其他 agent 的配置方法见 references/mcp_setup.md。

---

快速开始

多数情况下，你不需要手动执行下面的命令。只要用自然语言向 agent 描述任务，agent 会根据 SKILL.md 自动选择合适的数据源、脚本和参数。

下面的命令主要用于本地手动运行、调试、复现结果，或帮助你理解本 skill 的核心能力。

国家法律法规数据库（NPC）

# 精确搜索已知法规名，并优先返回现行有效版本
python scripts/download.py --search "物业管理条例" --exact --status 3 --size 20

# 按主题/关键词模糊搜索
python scripts/download.py --search "出租车" --status 3 --size 50

# 下载单部法规
python scripts/download.py --download <bbbs_id> --format docx output.doc

# 查看法规结构并查询具体法条
python scripts/download.py --preview <bbbs_id>
python scripts/download.py --article <bbbs_id> "第三十八条"

# 跨法规检索具体法条
python scripts/article_search.py "违约金" --range content --max-laws 5 --context 1

国家规章库与外交条约库

# 国家规章库
python scripts/gov_rules_crawler.py --search "管理办法" --categories 部门规章 --size 20

# 外交条约库
python scripts/treaty_crawler.py --collections 双边 --search "上海合作组织" --size 20

更多参数见 SKILL.md 和 references/。

---

常见工作流

查询单条/多条法条

当你只需要核对某一条或搜索某部法规内的关键词时，不必把整部法规塞进 agent 上下文。

# 预览法规结构
python scripts/download.py --preview <bbbs_id>

# 按条号查询（自动识别中文/阿拉伯数字）
python scripts/download.py --article <bbbs_id> "第三十八条"
python scripts/download.py --article <bbbs_id> "第38条"
python scripts/download.py --article <bbbs_id> "38"

# 在单部法规中 grep 关键词
python scripts/download.py --article <bbbs_id> --grep "经济补偿"

跨法规法条级搜索

scripts/article_search.py 用于在多部法规中查找包含关键词的具体法条：

# 在标题含关键词的法规中搜索
python scripts/article_search.py "违约金" --max-laws 5 --context 1

# 在全文含关键词的法规中搜索
python scripts/article_search.py "违约金" --range content --max-laws 5

# 限定只查某一部法规
python scripts/article_search.py "善意取得" --law 民法典 --context 0

# JSON 输出
python scripts/article_search.py "违约金" --max-laws 3 --json

# 分批检索
python scripts/article_search.py "违约金" --range content --max-laws 5 --offset 5
python scripts/article_search.py "违约金" --range content --max-laws 5 --resume

智能限速与缓存

# 大任务使用自适应限速
python scripts/download.py --search "出租车" --urls-only --size 200 --rate-limit adaptive

# 查看缓存
python scripts/download.py --cache-stats

# 单次禁用缓存
python scripts/download.py --no-cache --info <bbbs_id>

# 清空缓存
python scripts/download.py --cache-clear

缓存位置：~/.cache/{namespace}/（共 10 个 namespace，每个数据源独立）。

缓存 TTL 与自动清理：

• 搜索结果/列表页缓存：30 分钟 ~ 1 小时
• 详情/元数据缓存：24 小时
• DOCX 下载缓存：7 天
• 过期缓存由 CacheManager 在每次运行时机会式自动清理（每 7 天最多完整扫描一次），无需手动干预
• --cache-clear 用于立即清空当前数据源的全部缓存

地域分类

城市级 authority 通常不含省份名，例如 "广州市人民代表大会常务委员会" 不会包含 "广东省"。region_classifier.py 自动处理这个问题：

python scripts/download.py --search "物业管理条例" --urls-only --size 100 > urls.json
python scripts/region_classifier.py --classify < urls.json > classified.json
python scripts/region_classifier.py --matrix matrix.csv < classified.json

<details> <summary>Python API 示例</summary>

from scripts.region_classifier import classify_by_authority

classify_by_authority("广州市人民代表大会常务委员会")
# {
#   "province": "广东省",
#   "province_short": "广东",
#   "city": "广州市",
#   "level": "city",
#   "is_municipality": False,
#   "authority": "广州市人民代表大会常务委员会"
# }

</details>

批量采集

详见 references/batch_collection.md。批量采集请使用自适应限速，并避免重复、大量、高频请求。

---

MCP 接入（可选）

MCP 版是什么：把同一套检索能力封装成一个标准 MCP server（一个进程、 5 个工具），任何 MCP 兼容 agent 都能连接调用。它与 Skill 版共享全部 scripts/ 爬虫代码，mcp_server.py 只做转发，不修改任何现有文件。

和 Skill 版怎么选：

• 用 Skill 版：想让 agent 根据自然语言自动选数据源、直接 /cn-law-hub 调用，或需要下载原文、批量采集等完整工作流 —— 这是主路径。
• 用 MCP 版：更习惯"一个 server、N 个工具"的显式调用，或你的 agent 支持 MCP 但不支持自定义 skill（如 Cursor、Cline）。

pip install "mcp>=2.0.0"
python3 scripts/mcp_server.py        # 启动 stdio server（等待 MCP 客户端连接）

pip install "mcp>=2.0.0"
python3 scripts/mcp_server.py        # 启动 stdio server（等待 MCP 客户端连接）

Claude Code 会自动读取仓库根目录的 .mcp.json，打开项目即接入； 其他 agent 的配置见 references/mcp_setup.md。

提供 5 个工具：

| 工具 | 说明 | |---|---| | search_laws(source, keyword, category?, size?) | 统一搜索 10 个数据源 | | get_law_detail(source, url) | 拉取单条记录详情 | | query_article(bbbs_id, query?, grep?) | 按条号/关键词查单部法律法条 | | preview_law(bbbs_id) | 预览法律结构（条数 / 编号格式 / 前 20 条） | | article_search(keyword, law_keyword?, max_laws?, context?) | 跨法规法条级搜索 |

---

文件结构

cn-law-hub/
├── SKILL.md                      # 给 agent 看的 skill 主文档
├── README.md                     # 本文件
├── CHANGELOG.md                  # 更新日志
├── LICENSE                       # 临时竞赛许可证 v1.1（2026-09-21 前生效）
├── LICENSE-APACHE                # Apache-2.0 标准文本（2026-09-21 起生效）
├── NOTICE                        # 版权与贡献者声明（Apache-2.0 要求）
├── CITATION.cff                  # 机器可读引用信息
├── requirements.txt              # Python 依赖
├── requirements-dev.txt          # 开发依赖（测试/覆盖率）
├── pytest.ini                    # pytest 配置
├── .mcp.json                     # Claude Code MCP 配置（可选，MCP 接入用）
├── scripts/
│   ├── common/                   # 共享工具包
│   │   ├── __init__.py           # 统一导入与向后兼容别名
│   │   ├── cache.py              # 缓存管理
│   │   ├── chinese_numerals.py   # 中文数字转换
│   │   ├── cli_utils.py          # CLI 参数辅助
│   │   ├── constants.py          # 全局常量
│   │   ├── docx_utils.py         # DOCX 解析与法条提取
│   │   ├── file_io.py            # 文件读写
│   │   ├── logger.py             # 日志
│   │   ├── ratelimit.py          # HTTP 客户端与智能限速
│   │   └── text_utils.py         # 文本清洗与工具函数
│   ├── download.py               # NPC 搜索、下载、导出 URL、预览/查询法条
│   ├── article_search.py         # NPC 跨法规法条级关键词搜索
│   ├── gov_rules_crawler.py      # 国家规章库爬虫
│   ├── treaty_crawler.py         # 外交条约库爬虫
│   ├── gov_policy_library.py     # 国务院政策文件库
│   ├── moj_law_crawler.py        # 司法部行政法规库
│   ├── party_law_crawler.py      # 党内法规库 (12371.cn)
│   ├── mod_law_crawler.py        # 国防部法规文库
│   ├── tax_law_crawler.py        # 税务法规库 (国家税务总局)
│   ├── mee_law_crawler.py        # 生态环境部法规规章
│   ├── court_law_crawler.py      # 最高人民法院发布栏目
│   ├── mcp_server.py             # MCP server（可选接入，复用各爬虫函数）
│   └── region_classifier.py      # 地域分类与存在性矩阵
├── references/
│   ├── api_reference.md          # NPC API 端点与参数参考
│   ├── gov_rules_api_reference.md # 国家规章库 API 与认证参考
│   ├── gov_policy_api_reference.md # 国务院政策文件库 API 参考
│   ├── treaty_api_reference.md   # 外交条约库 HTML 结构参考
│   ├── setup.md                  # 环境配置与平台适配
│   ├── batch_collection.md       # 批量采集指南
│   ├── page_structure.md         # 页面结构与浏览器操作
│   ├── kimi_bridge_adapter.md    # Claude Code / Kimi Agent 适配
│   ├── codex_adapter.md          # Codex 适配
│   └── mcp_setup.md              # MCP 接入配置（Claude Code / 其他 agent）
└── tests/
    ├── conftest.py               # pytest fixtures
    ├── fixtures/                 # 各数据源 mock 数据
    │   ├── court/
    │   ├── gov_policy/
    │   ├── mee/
    │   ├── mod/
    │   ├── moj/
    │   ├── party/
    │   └── tax/
    ├── test_article_search.py    # 法条搜索测试
    ├── test_common.py            # 共享模块测试
    ├── test_download.py          # NPC 下载测试
    ├── test_gov_policy_library.py # 国务院政策文件库测试
    ├── test_moj_law_crawler.py   # 司法部行政法规库测试
    ├── test_party_law_crawler.py # 党内法规库测试
    ├── test_mod_law_crawler.py   # 国防部法规文库测试
    ├── test_tax_law_crawler.py   # 税务法规库测试
    ├── test_mee_law_crawler.py   # 生态环境部法规测试
    ├── test_court_law_crawler.py # 最高法栏目测试
    ├── test_new_sources_contract.py # 七源契约测试
    ├── test_live_sources.py      # 在线冒烟测试（默认跳过）
    └── test_region_classifier.py # 地域分类测试

---

致谢

• 数据源贡献者 — 感谢 kasc0206 在 PR #1 中贡献了国务院政策文件库、司法部行政法规库、党内法规库、国防部法规文库、税务法规库、生态环境部法规规章和最高人民法院发布栏目共 7 个爬虫脚本，将数据源从 3 个大幅扩展至 10 个，并重构了 scripts/common/ 共享模块，补齐了测试与开发依赖，大大提升了本项目的覆盖面与工