cn-law-hub

name

cn-law-hub

description

用于查询、检索、核验、下载、导出、批量采集中国官方法律法规、规章、条约和具体法条。Use this skill aggressively when the user asks to 查法律、查法规、查条例、查规章、查条约、查法条、查第几条、找法律依据、引用法律依据、核验现行有效、判断是否废止/已修改/尚未生效、下载法规全文、导出法规目录、批量下载法规文件、按关键词检索具体法条、展开法条分析，或在中国法律咨询、案例分析、合规审查、合同审查、劳动争议、行政法分析、公司合规、数据合规、政策研究中需要调用、核验或引用中国现行有效法律法规原文作为依据。Trigger also when phrases such as 依法、依规、依照法律规定、法律法规 imply a need to verify specific statutory authority or article-level text. Covers 国家法律法规数据库 (flk.npc.gov.cn), 国家规章库 (gov.cn), 外交条约库 (treaty.mfa.gov.cn), 国务院政策文件库 (sousuo.www.gov.cn), 司法部行政法规库 (xzfg.moj.gov.cn), 党内法规库 (12371.cn), 国防部法规文库 (mod.gov.cn), 税务法规库 (fgk.chinatax.gov.cn), 生态环境部法规规章 (mee.gov.cn), and 最高人民法院发布栏目 (court.gov.cn). Supports 标题/正文检索, 精确/模糊检索, 时效性过滤, 分类过滤, 分页, 排序, 单篇下载, 批量下载, 法条级抽取, 地区/制定机关分类, and browser fallback. Trigger when the answer may depend on current effective Chinese statutes, regulations, rules, treaties, article text, official document status, or official source attribution. Do not use for purely general legal theory, generic writing, or legal reasoning that does not require retrieving or verifying official Chinese legal documents.

Data Sources

#	Database	Script	Source	Type
1	国家法律法规数据库 (NPC)	scripts/download.py	flk.npc.gov.cn	JSON API
2	国家规章库 (Gov Rules)	scripts/gov_rules_crawler.py	gov.cn/zhengce/xxgk/gjgzk	Athena API + HTML
3	外交条约库 (Treaty)	scripts/treaty_crawler.py	treaty.mfa.gov.cn	HTML
4	国务院政策文件库	scripts/gov_policy_library.py	sousuo.www.gov.cn	REST API (GET)
5	司法部行政法规库	scripts/moj_law_crawler.py	xzfg.moj.gov.cn	HTML
6	党内法规库	scripts/party_law_crawler.py	www.12371.cn	HTML
7	国防部法规文库	scripts/mod_law_crawler.py	www.mod.gov.cn	HTTP
8	税务法规库	scripts/tax_law_crawler.py	fgk.chinatax.gov.cn	REST API (POST)
9	生态环境部法规规章	scripts/mee_law_crawler.py	mee.gov.cn	HTML
10	最高人民法院发布栏目	scripts/court_law_crawler.py	court.gov.cn	HTML

All scripts share --search, --info, --size, --output, --rate-limit, --no-cache, --cache-stats, --cache-clear. Run python <script> --help for full parameter lists.

---

Core Rules

Search Strategy (applies to ALL data sources)

Decide before calling the script — never default to fuzzy for everything:

• Known title (e.g. "物业管理条例", "北京市生活垃圾管理条例"): use --exact to reduce noise.
• Broad topic (e.g. "出租车", "环境保护"): use fuzzy search (default).
• Full-text match: add --range content when you need documents where the keyword appears in the body, not just the title.
• Ambiguous: ask the user, or run both exact+fuzzy and compare.

Status Filtering

NPC status codes (sxx / --status):

Code	Meaning
1	已废止
2	已修改
3	现行有效
4	尚未生效

Other sources use their own status values (e.g. --status effective for MoJ). Check --help per script.

Article-Level Queries (NPC)

For individual articles instead of full documents:

Command	When	Output
--preview <id>	Understand structure first	Title, article count, TOC
--article <id> "第X条"	Know the article number	Single article text
--article <id> --grep "kw"	Find articles by keyword in one law	All matching articles

Supports Chinese numerals (第三十八条), Arabic (第38条), or bare numbers (38).

For cross-law article search, use scripts/article_search.py <keyword> --max-laws N.

Rate Limiting

Auto mode picks by estimated requests: OFF (≤10), FIXED 5 req/s (11–100), ADAPTIVE 1–8 req/s with 429 backoff (>100). Override: --rate-limit {off|fixed|adaptive}.

Caching

Local file cache enabled (~/.cache/ per namespace). Search results: 1h TTL. Detail metadata: 24h. DOCX: 7 days. Use --no-cache to bypass, --cache-stats to inspect.

---

Validity Rules — MANDATORY

1. Only state 现行有效, 已废止, 已修改, or 尚未生效 when the official page or API response explicitly provides that status.
2. If the source has no explicit validity field, say: "官方页面未明确标注效力状态".
3. Do not infer validity from file accessibility or recency of publication date.
4. Always return: official URL, file type, issuing authority, publication date, and retrieval date — even when status is absent.
5. For same-name / multi-version documents, flag the ambiguity and verify amendment, repeal, and effective-date information.
6. Distinguish document types: 法律, 行政法规, 地方性法规, 规章, 司法解释, 司法文件, 党内法规, 政策文件, 通知, 案例, 条约. Do not conflate.
7. Never write "现行法律" as a generic label for all official publications.

---

Document Type Attribution

When reporting results, always identify the document type and source database explicitly. Use the format:

来源: [数据库名称] ([URL])
文件类型: [法律/行政法规/规章/司法解释/党内法规/政策文件/通知/...]
发布机关: [authority]
发布日期: [date]
效力状态: [现行有效/已废止/...] 或 "官方页面未明确标注效力状态"

---

Script Routing Summary

Script	Purpose	Key flags	Output dir
scripts/download.py	NPC search, download, article, preview	--search, --exact, --range, --status, --download, --article, --preview, --urls-only	stdout, files
scripts/article_search.py	Cross-law article-level search	keyword, --law, --range, --max-laws, --context, --json, --offset, --resume	stdout
scripts/gov_rules_crawler.py	Gov.cn rules	--search, --categories, --download, --info	gov_rules_output/
scripts/treaty_crawler.py	MFA treaties	--search, --collections, --download, --info	treaty_output/
scripts/gov_policy_library.py	State Council policies	--search, --range, --category, --year	gov_policy_output/
scripts/moj_law_crawler.py	MoJ admin regulations	--search, --range, --status	moj_law_output/
scripts/party_law_crawler.py	Party regulations (12371.cn)	--search, --category	party_law_output/
scripts/mod_law_crawler.py	MOD law library	--search, --category	mod_law_output/
scripts/tax_law_crawler.py	Tax regulations (chinatax)	--search, --category	tax_law_output/
scripts/mee_law_crawler.py	MEE env regulations	--search, --category	mee_law_output/
scripts/court_law_crawler.py	SPC announcements	--search, --category	court_law_output/
scripts/region_classifier.py	Province/city classification	--classify, --matrix	JSON/CSV

Each script has --help. Run it for detailed parameter lists.

---

Reference Files

Read these on demand, not proactively:

File	Read when...
references/setup.md	First run, dependency issues, or switching agent environments
references/api_reference.md	Need full NPC API payloads, field mappings, auth, or pagination details
references/gov_rules_api_reference.md	Gov Rules auth issues (401/403) or response field parsing
references/gov_policy_api_reference.md	Need State Council API parameter details beyond --help
references/treaty_api_reference.md	Treaty HTML structure or field extraction patterns
references/page_structure.md	Browser automation — page layout, selectors, UI-only search flow
references/kimi_bridge_adapter.md	Running on Kimi Agent or Claude Code + kimi-webbridge
references/codex_adapter.md	Running on Codex
references/batch_collection.md	Large-scale collection (200+ items), batch download workflows

Browser fallback: only when the API/script fails or UI-only search is required. Read references/page_structure.md first.

---

Key Notes by Data Source

• NPC: ossFile paths from detail API are not directly downloadable — always use --download. bbbs = unique law ID.
• Gov Rules: Requires dynamic RSA auth from the frontend JS bundle; may expire during long runs. Restart on 401/403.
• Treaty: Pure HTML, no API. Collections: 全部, 双边, 多边.
• Party Law (12371.cn): No search API; keyword filtering is client-side on titles only.
• MOD: Static HTML, no search API. Client-side title filtering.
• Tax: POST API, requires session cookie (auto-managed). Channel ID auto-discovered.
• MEE: Static HTML, categories pre-loaded in page. No search API. Standards (环保标准) excluded.
• Court: List pages paginated (/fabu/gengduo/{id}.html → {id}_{n}.html). No search API.