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/

---

什么时候使用这个 Skill

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

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

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

例如：

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

---

功能概览

• 多数据源支持：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"

---

一键安装

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

发布版请从 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
• 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  --format docx output.doc

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

# 跨法规检索具体法条
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 

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

# 在单部法规中 grep 关键词
python scripts/download.py --article  --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 

# 清空缓存
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  classified.json
python scripts/region_classifier.py --matrix matrix.csv < classified.json

批量采集

详见 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 个工具：

---

文件结构

cn-law-hub/
├── SKILL.md                      # 给 agent 看的 skill 主文档
├── README.md                     # 本文件
├── CHANGELOG.md                  # 更新日志
├── LICENSE                       # Apache License 2.0 全文
├── 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/ 共享模块，补齐了测试与开发依赖，大大提升了本项目的覆盖面与工程质量。
• 特别感谢 Li2zon3 的 law-crawler-unified 项目，国家规章库（scripts/gov_rules_crawler.py）和外交条约库（scripts/treaty_crawler.py）的实现大量参考了其中的思路与方案，帮了很大的忙。

---

使用倡议

官方公共法律数据库的维护不易，请大家在使用时保持克制，尽量避免大量高频请求。本项目在批量采集、搜索和下载等功能中已经内置了不同强度的智能限速（小任务关闭限速、中等任务固定限速、大任务自适应限速），希望在不明显影响使用体验的前提下，尽量减少对目标网站造成的负担。请珍惜并合理使用这些公开资源。

---

免责声明

本工具仅用于学习、研究、合规核验与个人/机构内部的辅助检索。请遵守 flk.npc.gov.cn、gov.cn、treaty.mfa.gov.cn、xzfg.moj.gov.cn、12371.cn、mod.gov.cn、fgk.chinatax.gov.cn、mee.gov.cn 和 court.gov.cn 等官方数据库的使用规则，避免高频请求、重复批量抓取或对目标网站造成额外负担。

本项目的代码许可请以仓库中的 LICENSE 文件为准。

本项目采用 Apache License 2.0 授权：可自由使用、修改、分发，包括商业用途，只需保留版权与许可声明（见 NOTICE）。

历史说明：本项目曾使用一份临时竞赛许可证（CN Law Hub Temporary Competition License v1.1），用于在 2026-09-21 前限制本工具被用作第四届大学生数据法治实验模型竞赛参赛作品的核心功能。按其自身第 8 节，该限制已于 2026-09-21 00:00:00（CST） 自动失效，此后本项目即按 Apache-2.0 授权，不再有任何使用限制。该许可证全文仍可在 git 历史中查阅。

⚠️ 注意：上述许可证变更发生在最近一次发布之后，已发布的 release 压缩包（截至 v2.0.2）尚未同步——其中的 LICENSE 仍是旧的临时竞赛许可证，并且额外带有一个 LICENSE-APACHE 文件。请以本仓库当前的 LICENSE（Apache-2.0 全文）为准；从旧 release 安装的用户，可忽略压缩包内的 LICENSE 与 LICENSE-APACHE，本项目实际已按 Apache-2.0 授权。

此外，尽管许可证允许，本项目仍不建议大量抓取官方法律数据库、镜像官方数据、转售数据、包装成收费数据服务等可能涉及官方数据再利用合规风险的商业化采集行为。上述行为访问量较大，可能影响目标网站正常运营，且带有盈利性，具有合规风险。使用者应自行评估其使用场景的合法性、合规性和对官方公共资源的影响。

本工具不提供法律意见，也不能替代律师、合规顾问或官方渠道的判断。对于法律文本的时效性、完整性和适用性，请以官方公布内容为准。

---

关于作者 / Contact

有任何问题欢迎随时交流！你可以从以下任何一种方式找到我～

---

Citation

如果你在论文、报告、课程作业或参赛作品中使用了本工具，欢迎按如下方式引用：

@software{cn_law_hub_2026,
  author = {ZongziForu},
  title = {CN Law Hub: Chinese Legal Research and Retrieval Agent Skill},
  year = {2026},
  url = {https://github.com/ZongziForu/cn-law-hub}
}

机器可读的引用信息见仓库中的 CITATION.cff。

---