deepxiv/deepxiv_sdk/deepxiv-fa-law

DeepXiv · Law · Statutes (law)

33,103 statutes / 1,539,593 articles from 26 jurisdictions; article-level hybrid retrieval, Chinese translations and per-article extraction (heading, subjects, conditions, consequences, references).

Corpus: 1,539,593 documents.

Setup

pip install -U deepxiv-sdk      # deepxiv registers a token on first use

With a registered key (https://data.rag.ac.cn/register), search and read are fair use: 60/min, 5 at once, 5,000/day; on the auto-registered token they spend the deepxiv daily limit at the credits listed below. ask draws on the daily ask allowance (resets 00:00 UTC; a site-wide daily total can run out early at peak times), or 3 lifetime trial asks on the auto-registered token. On 429, back off for Retry-After seconds. Data goes to stdout; cost, quota and sources go to stderr. Exit 0 ok, 1 API error, 2 usage error. The general CLI guide is the deepxiv-cli skill.

Start here

deepxiv fa search law "刑法第266条" -k 3   # statute + article number locates directly
deepxiv fa search law "个人信息出境" -F jurisdiction=CHN -F status=in_force -k 5
deepxiv fa read law 刑法 -l brief
deepxiv fa ask "个人信息出境需要满足什么条件" -d law -e medium

Free samples: ids 刑法; queries 诈骗罪 量刑.

Search

deepxiv fa search law "query" [-F FILTER]... [-k N] [--offset N] [--mode M] [--head] [--json]

Modes: hybrid, dense, bm25. Up to 100 hits. Cost 2 (with --head: 3). An empty query is rejected; use "*" to list by filters only. Filters combine with AND; an undeclared field exits 2.

Advanced filters (see deepxiv fa spec law): scope, granularity, law_type, domain, norm_type, effective_at.

Read

deepxiv fa read law ID [ID...] [-l brief|detail|full] [-e EXTRA] [-p k=v]... [-f json|md|html]

At -l full, -p section=NAME reads one section and -p characters=N the first N characters.

Facets

deepxiv fa facets law FIELD lists the legal values and counts, free. Use it instead of guessing a spelling. Fields: jurisdiction, law_type, status, domain, norm_type.

Ask

deepxiv fa ask "question" -d law [-e low|medium|high] [-p k=v]... [--no-stream] [--json]

Joint agentic Q&A over statutes and judgments: finds the governing articles, reads them, then checks how comparable judgments ruled; answers cite [statute art. N] / [case number], with sources.laws / sources.cases / coverage

Always pass -d law: automatic domain picking is still early.

What this corpus will and will not tell you

• law_id accepts a doc_id (jpn:law:労働基準法) or a Chinese title / short title (刑法, 劳动合同法).
• A query like '刑法第266条' (statute + article number) resolves exactly first.
• scope=national by default: local regulations copy national text and are the main source of noise.
• Translations and extractions are model-generated; cite text.src. needs_review=true marks translations of unusual length.
• knowledge_fill in level=brief / detail is model-recalled metadata, not a source.

Citing

Cite records as [中华人民共和国刑法 第266条]. Say plainly when the corpus has nothing.

Generated by scripts/gen_fa_skills.py from deepxiv fa spec law --json on 2026-10-19. Field names and prices can change; deepxiv fa spec law is the live source.