cn-law-hub

用于查询、检索、核验、下载、导出、批量采集中国官方法律法规、规章、条约和具体法条。Use this skill aggressively when the user asks to 查法律、查法规、查条例、查规章、查条约、查法条、查第几条、找法律依据、引用法律依据、核验现行有效、判断是否废止/已修改/尚未生效、下载法规全文、导出法规目录、批量下载法规文件、按关键词检索具体法条、展开法条分析,或在中

SKILL.md

GitHub

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.