--- name: fazhi-mcp description: >- 本技能是法智/快查共享 MCP 的内部数据工具调用层，统一封装 6 个法律数据工具及企业数据能力入口： case_search（案例检索）、case_browser（案例全文阅读）、legal_article_search（法条综合检索）、 law_content_visit（法规全文阅读）、webpage_search（联网搜索）、webpage_visit（网页阅读），以及 discover（企业能力发现）和 call（企业工具调用）。法智与快查是同一 Connector 和运行时 MCP 服务的两种业务称谓。 仅供 case-search、law-search、legal-research、legal-drafting、legal-opinion、legal-due-diligence 等上层业务技能在执行过程中按需调用。 本技能不直接面向最终用户，不要用它直接回答法律咨询、法条查询、案例检索、企业查询、深度研究、文书起草、尽职调查或案件可视化请求。 security: child_process: false eval: false filesystem_write: false filesystem_read: false --- # 法智/快查 MCP 底层工具调用（fazhi-mcp） 本技能是法智与快查共用的**底层 MCP 工具调用层**。法律业务沿用“法智”名称并使用 6 个法律数据工具；企业信息业务沿用“快查”名称并通过 `discover`、`call` 动态发现和调用企业数据工具。两类能力共用同一个 Connector、认证和运行时 MCP 服务，不需要重复安装或配置。 上层业务技能需要检索法律或企业数据时，必须通过本技能调用 MCP 工具，不得直接调用 HTTP API。企业查询结果必须标明快查数据来源，不得包装成法智自有法律数据库结果。 ## 认证与安全 共享 Connector 需要法智/快查平台提供的有效访问凭证。TRAE 负责收集凭证，并在连接 MCP 时按当前 Connector 配置注入认证请求头；Skill 不应读取、展示或要求用户在对话中发送凭证。 - 不在工具参数中包含 API Key、其他凭证或无关个人信息。 - 如果凭证失效，引导用户在对应的法智/快查数据平台重新生成并更新同一个 Connector 配置。 - 不写死服务器标识符、Remote MCP 地址、请求头名称或 Connector 变量名，以当前运行时配置为准。 - 不尝试绕过共享 MCP 访问其他服务端点。 ## MCP 工具总览 | # | 工具 ID | 工具名称 | 来源类型 | 功能 | | --- | ---------------------- | ------ | ------- | ---------------- | | 1 | `case_search` | 案例检索 | 司法案例来源 | 类案搜索，支持时间/地域范围筛选 | | 2 | `case_browser` | 案例全文阅读 | 司法案例来源 | 浏览指定案例的裁判文书全文 | | 3 | `legal_article_search` | 法条综合检索 | 法规规范来源 | 法条检索合并接口（语义+精确） | | 4 | `law_content_visit` | 法规全文阅读 | 法规规范来源 | 阅读指定法规全文内容 | | 5 | `webpage_search` | 联网搜索 | 互联网公开来源 | 互联网法律实务资讯检索 | | 6 | `webpage_visit` | 网页阅读 | 互联网公开来源 | 阅读指定网页正文 | | 7 | `discover` | 企业能力发现 | 快查企业数据 | 用中文能力描述发现当前可用企业工具 | | 8 | `call` | 企业工具调用 | 快查企业数据 | 使用已确认的 tool_id 和参数执行查询 | ### 工具调用方式 所有工具均通过 TRAE 当前会话已注册的 MCP 工具调用： ``` server: 以 TRAE 当前会话实际注册的法智/快查共享 MCP 服务器为准 tool: 对应上表的工具 ID（case_search / case_browser / legal_article_search / law_content_visit / webpage_search / webpage_visit / discover / call） arguments: 严格按照该工具当前公开的参数 schema 传入 JSON 对象 ``` > **注意**：调用前先查看 TRAE 当前会话暴露的 MCP 工具描述，确认实际工具名和参数 schema。不要依赖固定服务器标识符，不要把凭证放入工具参数，也不要绕过 MCP 直接请求 HTTP 端点。 --- ## 1. case_search（案例检索） ### 描述 在本地案例数据库中检索与用户问题相关的司法案例，支持设定地域、时间、法院层级筛选条件。返回案号、案由、法院、裁判日期、案件概要、争议焦点、法院观点、裁判结果等摘要信息。 ### 适用场景 - 用户明确要求查找案例、类案、判例、案号、裁判观点 - 用户询问"法院会不会支持""实务中怎么认定""胜诉概率如何" - 用户问题涉及争议较大、需要参考司法实践的法律判断 - 法条规定较原则，需要通过案例了解适用标准 - 用户要求比较不同法院或不同案件的裁判倾向 - 需要分析法院对某一事实、证据、合同条款、行为性质的裁判观点 - 需要辅助判断案件风险、诉讼策略、争议焦点 - 需要检索类案支持法律分析 ### 调用要求 - 一次调用提供 2-3 组检索语句 - 引用案例时，应核验基本事实、法院观点、裁判结果及与用户问题的相似度 - 案例之间存在不同观点时，应说明裁判分歧和较稳妥的判断 - 不得将单个案例直接上升为普遍规则 - 不得编造、补全、拼接案号 ### 参数 Schema | 参数 | 类型 | 必填 | 说明 | | ------- | ----------- | --- | ----------------------------------------------------------------------- | | `query` | arraystring | 必填 | 检索语句应围绕案件事实、法律关系、行为类型、争议焦点、责任承担等构造。使用完整通顺的语句或核心要素组合；必须保留用户问句中的关键事实、专有名词 | | `size` | integer | 选填 | 返回案例的最大数量，实际返回数量小于等于此值，默认 10，最小 5 | | `time` | arraystring | 选填 | 搜索时间范围过滤，例如：`["2023-01-01 至 2024-01-01"]` | | `area` | arraystring | 选填 | 搜索地域范围过滤，例如：`["北京", "上海"]` | ### 返回结果说明 返回字段通常包含：案号、案由、法院、裁判日期、案件概要、争议焦点、法院观点、裁判结果、`lawsuit_id`（用于拼接案例详情页链接）、`refer`（业务引用信息）。 案例详情页链接格式：`https://www.fazhi.law/law-saas/caseDetail/{lawsuit_id}` --- ## 2. case_browser（案例全文阅读） ### 描述 根据指定案号或案件名称精确检索单个案例，返回裁判文书正文信息，包括案号、案由、审理法院、裁判日期、文书标题、文书正文等。该工具主要用于核验特定案例的具体内容和裁判要点。 ### 适用情形 - 在案例检索结果中，需要进一步读取某一精确案例的正文 - 用户提供了具体案号，要求核验或分析、或查找该案裁判观点 - 用户要求确认某一案例是否存在、法院如何判决 - 需要围绕某一确定案例提炼裁判规则、争议焦点或适用价值 ### 调用要求 - 应优先使用案号进行精确定位，案件名称只能作为辅助检索条件 - 如无法精确匹配到案号，应优先使用联网搜索工具查询 - 不得根据不完整案号自行补全 ### 参数 Schema | 参数 | 类型 | 必填 | 说明 | | ------------- | ------ | ---- | ------------------------------------------- | | `case_number` | string | 二者选一 | 案件案号（如 `"(2024)京01民初123号"`），与 case_name 二选一 | | `case_name` | string | 二者选一 | 案件名称（如 `"张三诉李四合同纠纷案"`），与 case_number 二选一 | --- ## 3. legal_article_search（法条综合检索） ### 描述 在本地法律数据库中检索与用户问题相关的法条，支持混合检索、语义检索、精确法条定位和法规名称检索。返回法规名称、条文编号、条文内容、效力层级、效力状态、公布日期、施行日期等信息。 ### 适用情形 - 用户要求"法律依据是什么""依据哪条法律""有没有规定" - 用户问题涉及具体法律责任、权利义务、合同效力、诉讼时效、管辖、举证责任、执行、赔偿 - 用户问题需要引用具体法条支撑 - 不确定应适用哪部法律或哪一条规定 - 用户没有明确给出条文编号，但问题显然需要法律依据 - 用户给定了明确条文编号和法律名称，可用精确法条检索 ### 参数 Schema | 参数 | 类型 | 必填 | 说明 | | ---------- | ------- | ---- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `query` | string | 条件必填 | 检索关键词或法律问题描述，必须将口语化表达转化为法律专业术语，并对同义词、近义词进行穷举，避免遗漏。禁止使用"法条""法律依据""法律规定"等无意义术语。例如：`"公司不签合同"` 可转化为 `"劳动合同 订立 书面形式 事实劳动关系 用人单位"`；`"离婚房子归谁"` 可转化为 `"离婚 房产 分割 夫妻共同财产 不动产权属"`。如果已知道具体法规名称和条文编号，可省略 query，改用 law_name + item | | `law_name` | string | 选填 | 法规名称，例如：`"中华人民共和国民法典"`、`"中华人民共和国刑法"`。三种用法：(1) 配合 item 精确查某条；(2) 单独使用查法规基本信息；(3) 配合 query 限定检索范围 | | `item` | string | 选填 | 法条编号，例如：`"第五百六十三条"`、`"563"`。需配合 law_name 使用，精确检索指定法条 | | `status` | string | 选填 | 效力状态过滤，枚举值：`"现行有效"`、`"已被修改"`、`"失效"`。传 `"现行有效"` 时仅检索现行有效法条，不传不做约束 | | `size` | integer | 选填 | 返回结果数量，默认 5，最小 1，最大 20 | ### 返回结果说明 返回字段通常包含：法规名称、条文编号、条文内容、效力层级、效力状态、公布日期、施行日期、`law_id`（用于拼接法规详情页链接和调用 law_content_visit）、`refer`（业务引用信息）。 法规引用统一使用以下两种 Markdown 链接格式： - 引用具体条文：`[《法规全称》第N条](https://www.fazhi.law/law-saas/lawDetail/{law_id}?pos=tN)`； - 仅引用整部法规：`[《法规全称》](https://www.fazhi.law/law-saas/lawDetail/{law_id})`。 `law_id` 必须来自工具实际返回结果，不得猜测、补全或编造。`N` 必须从工具已核验的条文编号转换为无前导零的阿拉伯数字，例如“第十条”转换为 `t10`。引用款、项时，链接文本保留完整层级，但 `pos` 只锚定所属条，例如 `[《法规全称》第四十三条第二款](https://www.fazhi.law/law-saas/lawDetail/{law_id}?pos=t43)`。引用多条或条文区间时，必须按条拆分，每条分别使用完整的“法规全称+条号”作为链接文本。无法可靠解析条号时，降级为整部法规链接，不得编造 `pos`。 输出法规引用前必须取得真实 `law_id`。首次结果缺少 `law_id` 时，应使用法规名称检索补取；按既定重试规则仍无法取得时，不得构造 URL，也不得把该法规作为正式可点击引用。法律、行政法规、司法解释、部门规章、地方性法规及规范性文件均适用本规则。法规名称和条款编号本身就是链接，不得另附独立的原文入口。 --- ## 4. law_content_visit（法规全文阅读） ### 描述 阅读指定的法规全文用于读取某一指定法律、行政法规、司法解释、部门规章、地方性法规或规范性文件的全文，并根据用户目标提取、总结、比较或分析其中的相关制度规则。 ### 适用场景 - 已经确定法规名称，需要系统读取全文而非检索个别条文 - 法条语义检索结果不足以覆盖用户要求的完整制度内容 - 用户要求提取某部法规中关于某一主题的全部规定 - 用户要求分析某部法规的制度框架、适用范围、责任体系 - 用户要求围绕某部法规制作合规清单、审查清单、制度要点 ### 调用要求 - 简单法条查询不得调用本工具 - 如果法规名称不确定，应先使用法条综合检索工具确认标准名称和 law_id - 必须提供准确的法规 id 和聚焦的阅读目的 ### 参数 Schema | 参数 | 类型 | 必填 | 说明 | | -------- | ------ | --- | ----------------------------------------------- | | `law_id` | string | 必填 | 法规唯一标识，来自 legal_article_search 返回结果中的 law_id 字段 | | `goal` | string | 必填 | 阅读目的/需要查找的具体内容 | --- ## 5. webpage_search（联网搜索） ### 描述 用于执行互联网搜索并返回与用户查询相关的网页内容摘要。适用于涉及具体事件、新闻热点、案件人物或公司背景、平台规则、软件工具信息、最新政策监管动态、行业实践，以及需要外部公开信息补充的问题。 ### 适用场景 - 查询政府机关、法院、检察院、监管部门发布的公告、政策、通知、解读、典型案例等公开信息 - 查询最新政策、地方办事规则、监管口径、平台规则、行政审批流程 - 查询某一公开事件、企业、机构、人员、平台、软件工具的公开背景信息 - 用户要求"帮我查一下""网上有没有""有没有官方公告""最新规定是什么" - 回答需要引用网页资料或官方公开信息作为支撑 - 法规或案例之外，需要补充现实背景、发布动态或公开材料 ### 调用要求 - 查询语句应完整、清晰、语义明确，不得只输入零散关键词 - 对同一检索目标，失败或无结果时最多重试一次 - 不得把搜索摘要直接等同于法律依据或裁判全文 ### 参数 Schema | 参数 | 类型 | 必填 | 说明 | | ------- | ------- | --- | ----------------- | | `query` | string | 必填 | 检索关键词，支持法律术语和自然语言 | | `size` | integer | 选填 | 返回结果数量，默认 10 | --- ## 6. webpage_visit（网页阅读） ### 描述 浏览指定一个或者多个 url 的网页内容并返回与用户查询目标相关的内容摘要。该工具适合在已经获得具体网址后，对网页正文、公告内容、政策说明、办事指南、公开材料等进行进一步阅读和分析。 ### 适用场景 - 联网搜索返回重要官方网页，需要进一步读取原文 - 需要确认网页中的发布时间、发布主体、政策内容、适用对象、办理条件、办理流程等 - 需要从官方公告、法院发布、监管文件、行政机关页面中提取具体内容 - 用户提供网址并要求总结、分析、核验内容 ### 调用要求 - 应明确阅读目标，避免笼统要求"阅读网页" - 优先阅读高价值资料：政府权威网站、律师律所高质量公众号等 - 如网页无法读取或内容不足，应说明当前无法核实，不得推测网页正文内容 ### 参数 Schema | 参数 | 类型 | 必填 | 说明 | | ------ | ------ | --- | ------------------ | | `url` | string | 必填 | 目标网页链接 | | `goal` | string | 必填 | 阅读目的/需要提取的信息 | | `uid` | string | 选填 | 网页唯一标识（可选），用于去重和编号 | --- ## 7—8. 企业数据能力（discover / call） ### 能力定位 `discover` 和 `call` 是共享 MCP 中快查企业数据能力的统一入口，覆盖中国大陆企业、个体工商户、社会组织、事业单位等组织的工商、股权、对外投资、经营与司法风险、知识产权、招投标、资质和新闻舆情数据。工具库会持续更新，不得把本文示例当作固定工具清单。 ### 标准调用流程 1. **发现能力**：用中文能力描述调用 `discover`，例如“企业模糊搜索”“企业基本信息”“工商登记股东”“企业被执行人信息”“股权质押及注销信息”。不得把完整用户问题、凭证或参数对象当作发现语句。 2. **选择工具**：检查返回结果的能力说明、`similarity` 和参数 schema；优先选择 `similarity >= 0.5` 且参数定义匹配的结果。无合适结果时可改变为专业同义能力描述重试一次，不得猜测 `tool_id`。 3. **执行查询**：使用 `call` 传入真实 `tool_id` 和严格符合该工具 schema 的结构化参数。同一会话中已经成功验证的 `tool_id` 可以复用。 4. **完成分页**：列表类结果按照工具实际公开的分页参数逐页读取，直至空页、达到总页数或工具明确标记结束。未完成分页时不得作完整性或数量结论。 5. **处理结果**：区分成功、空结果、未匹配、参数错误、权限错误和服务错误；只使用返回数据能够支持的结论，不补全缺失字段。 ### 主体消歧与标识 - 企业名称为简称、品牌名或存在歧义时，先发现并调用“企业模糊搜索”，根据企业全称、统一社会信用代码、地区、住所和法定代表人锁定主体。 - 固化主体后，后续企业工具参数优先级为 `orgid > creditcode > 完整 corp_name`；不得把简称或完整用户问句填入 `corp_name`。 - 无法唯一匹配时暂停实体级查询，列出候选并请求确认，不得猜测目标主体。 - 参数名称、类型、日期格式、分页字段和上限均以所选工具的当前 schema 为准。 ### 企业数据边界与来源 - 快查结构化结果属于公开企业数据，不替代工商内档、许可证原件、合同、审计、征信、社保、银行或主管机关证明。 - 空结果只表示本次查询在当前覆盖范围内未返回记录，不得写成“无诉讼”“无处罚”“不存在风险”等绝对事实。 - 不查询个人征信，不为取得个人信息绕过工具能力、授权或最小必要原则。 - 向用户直接呈现企业查询结果时，在末尾标注：`数据来源于同花顺旗下快查企业数据引擎`。法律尽调报告按 `legal-due-diligence` 规定的单次来源声明和证据限制写入，不在各章节重复标注。 --- ## 工具选择规则 | 用户意图 / 研究阶段 | 调用工具 | 说明 | | ------------- | ---------------------- | --------------------- | | 用问句或案情找相似类案 | `case_search` | 支持 `time`/`area` 范围筛选 | | 查看某个具体案号/案例详情 | `case_browser` | 传案号或案例名 | | 检索法律法规条文 | `legal_article_search` | 语义检索或法名+条号精确检索 | | 精读某法规全文并按要点总结 | `law_content_visit` | 需先拿到 `law_id` | | 检索互联网法律实务资讯 | `webpage_search` | 补充背景、最新政策 | | 阅读某个指定网页正文 | `webpage_visit` | 传目标 URL | | 发现企业数据能力 | `discover` | 使用中文能力名称，不传完整用户问题 | | 执行企业数据查询 | `call` | 传真实 tool_id 和匹配 schema 的参数 | ### 检索与调参技巧 - **类案/法条定位**：优先 `case_search`（类案）和 `legal_article_search`（法条），语义检索用完整自然语言问句 - **精准法条**：明确知道法律名和条号时，`legal_article_search` 传 `law_name` + `item`，信息更精确 - **地域/年限**：类案检索带上 `area`/`time` 较贴近真实需求 - **案例详情**：先 `case_search` 定位，再 `case_browser` 查看案号详情 - **内容深读**：法规正文用 `law_content_visit`，网页正文用 `webpage_visit` ## 工具使用边界 | 工具 | 用途 | 检索或读取要求 | 禁止 | | ---------------------- | -------------------- | --------------------------------------------------- | ----------------------------------- | | `legal_article_search` | 定位适用法律法规条文 | 自然语言专业术语句子；不得提及具体法规名或条文号；可按工具能力限定法规 | 零散关键词、「法条」「法律规定」等无意义堆砌 | | `law_content_visit` | 阅读法规全文、核验条文内容和效力状态 | 基于已明确法规或条文对象按需读取 | 未经检索直接假定法规内容 | | `case_search` | 类案、裁判观点、法院认定标准 | 多维度关键词组合（≥2 维度：事实+争议焦点、法条+时间、场景+焦点）；以明确核心事实与争议焦点为基础 | 简单续写用户问句；「地域+时间」空泛组合；同义重复历史失败 query | | `case_browser` | 阅读具体裁判文书全文、核验案号和裁判理由 | 基于已取得案号或案例对象按需读取 | 未取得明确案例对象时盲目读取 | | `webpage_search` | 法律实务文章、官方解读、热点事件背景 | 自然语言短语或关键词；优先引导检索微信公众号文章 | 仅用「法律规定」「相关案例」等空泛术语 | | `webpage_visit` | 阅读网页正文、核验网页内容 | 基于已取得网页结果按需读取 | 把搜索摘要当网页全文 | | `discover` | 发现快查企业数据工具 | 中文能力描述；核对相似度、能力说明和参数 schema | 传用户完整问题、参数对象、凭证或猜测 tool_id | | `call` | 执行已发现的企业工具 | 使用真实 tool_id；参数严格匹配 schema；列表查询完成分页 | 猜测参数、跳过主体消歧、以空结果证明事项不存在 | ## 错误恢复 | 问题 | 处理方式 | | ---------- | ------------------------------------------------------------- | | 未匹配到相关案例 | 优先改用更宽泛的检索语句，或调整 size 参数 | | 工具返回空结果 | 改变检索语句表述重试一次，或用其他工具补充背景后优化条件 | | 字段缺失较多 | 调用对应的读取工具（case_browser / law_content_visit / webpage_visit）补充 | | 参数验证失败 | 重新检查参数类型、日期格式、枚举值和工具参数说明 | | 企业能力未匹配 | 改用更准确的中文能力描述重试一次；仍无匹配则记录未覆盖，不猜测 tool_id | | 企业列表分页不完整 | 继续按实际 schema 分页；异常中止时标记结果不完整，不作完整性结论 | | 企业查询空结果 | 记录查询条件、时间和覆盖限制；不得转换为事项不存在 | | API Key 无效 | 引导用户在对应的法智/快查平台重新生成并更新共享 Connector 配置 | | 查询完全失败 | 报告尝试的工具、参数类别和错误，不编造数据 |