无 MCP 时的 API 入口
使用本 Skill 的 scripts/yd-run 启动标准库 Python CLI。示例路径相对于 Skill；在案件目录工作时使用该脚本的绝对路径，输入文件也优先用绝对路径。
鉴权
优先读取环境变量 YD_API_KEY，其次读取 scripts/.env。脚本会检查缺失和占位值；不要另行输出密钥。首次配置可参照 scripts/.env.example，Key 从 元典开放平台 获取。未配置时提示用户配置，不能阻止独立的 MCP 路径。
常用入口
scripts/yd-run --no-report detail "中华人民共和国民法典" --ft-name "第六百九十二条"
scripts/yd-run --no-report search "普通房屋租赁中履约保证金的性质及违约金调减"
scripts/yd-run --no-report case-semantic "员工离职带走客户名单，何种信息和保密措施构成商业秘密"
scripts/yd-run --no-report case "房屋买卖 过户 尾款 同时履行"
scripts/yd-run --no-report keyword "违约金" --fgmc "中华人民共和国民法典"全局留存参数放在子命令前。普通调用不再继承 aggressive 的参数；语义默认不发送 rewrite_flag/return_num，关键词不隐式增加 top_k。需要覆盖时显式用 --return-num、--rewrite-flag／--no-rewrite、--top-k，以各子命令 --help 为准。不要固定预设候选数或自动双查。
法条 detail 支持 --reference-date。案例详情使用 case-detail --type ptal --id ... 或 --ah ...；权威案例类型用 qwal。案例语义和关键词的日期／筛选字段不同，读取具体 --help，不要猜参数。
企业信息、法规全文、幻觉检测等扩展接口只在用户要求的范围内使用，按需查 scripts/yd-run --help、endpoints/ 或 企业画像，不作为普通法律检索默认步骤。本地 adapter 的接口清单不等于官网全部服务。
网络与费用
普通法条／案例接口标价通常为每次10积分，价格以平台为准；缓存命中不请求网络、不消耗新积分。不要仅为补写 Markdown 底稿重复请求。
yd-run 清理代理等环境变量并传递鉴权、归类和归档目录设置，不改变系统权限。网络失败先运行无积分的 scripts/yd-run --network-check，核查 DNS/TLS；受限环境需按宿主权限流程处理，不盲目重试。响应已返回但归档失败时仍交付响应并告警，不再次请求。
API 原始 JSON 默认归档；正式报告只消费 Agent 精选，见 报告生成。