yuandian-law-search（元典法律检索）

元典法条与案例检索

通过元典 API 检索中国法律法规条文和案例，支持法条语义/关键词/详情检索和案例关键词/向量语义检索共 5 种模式。

前置要求（每次调用前自动检测）

每次使用本技能前，必须先执行以下检测流程，确认 API Key 已就绪：

检测步骤

1. 检测 .env 文件：检查 scripts/.env 是否存在
2. 检测 API Key：读取文件中 YD_API_KEY 的值，确认非空且不是占位符 your-api-key-here
3. 若检测失败，向用户提示以下引导信息并终止：

⚠️ 元典 API Key 未配置。请按以下步骤获取并配置：

1. 注册/登录：访问 https://passport.legalmind.cn/ ，使用手机号注册
2. 创建 API Key：登录后访问 https://passport.legalmind.cn/apiKey/manage ，点击「创建 Key」
3. 配置密钥：将 Key 填入以下文件

   scripts/.env
   ─────────────
   YD_API_KEY=sk-你的密钥
   ─────────────

API 覆盖范围：法条检索（语义/关键词/详情）+ 案例检索（关键词/向量语义），共 5 个端点，共用同一个 Key。
配置完成后重新发起检索即可。

1. 若检测通过，继续执行用户请求的检索命令

检测命令

# 检测 .env 文件和 API Key
if [ -f "scripts/.env" ]; then
  KEY=$(grep '^YD_API_KEY=' scripts/.env | cut -d'=' -f2)
  if [ -n "$KEY" ] && [ "$KEY" != "your-api-key-here" ]; then
    echo "API Key 已就绪"
  else
    echo "API Key 未配置"
  fi
else
  echo ".env 文件不存在"
fi

五种检索模式

1. 法条语义检索（search）

用自然语言提问，找到最相关的法条。

python3 scripts/yd_search.py search "正当防卫的限度" --sxx 现行有效

2. 法条关键词检索（keyword）

用精确关键词检索法条，支持日期范围和效力级别筛选。

python3 scripts/yd_search.py keyword "人工智能 监管" \
  --effect1 法律 --sxx 现行有效 \
  --fbrq-start 2022-01-01 --fbrq-end 2026-03-01

3. 法条详情检索（detail）

按法规名称 + 条号精确获取某一条法条全文。

python3 scripts/yd_search.py detail "民法典" --ft-name "第十五条"

4. 案例关键词检索（case）

用关键词检索案例，支持案由、法院、省份等多维过滤。

python3 scripts/yd_search.py case "买卖合同纠纷" --province 广西 --authority-only

5. 案例语义检索（case-semantic）

用自然语言描述查找相似案例。

python3 scripts/yd_search.py case-semantic "正当防卫的限度" --jarq-start 2020-01-01

通用参数说明

法条检索通用筛选

案例检索通用筛选

完整参数说明见 references/api-spec.md。

输出格式

脚本输出 Markdown 格式，包含法条全文、法规名称、发布机关、时效性等元信息，以及原文链接。可直接用于法律文书引用或 AI 分析。

调试

使用 raw 子命令查看原始 JSON 响应：

python3 scripts/yd_search.py raw /search "正当防卫" --extra '{"sxx":["现行有效"]}'