Fazhi Mcp

---
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 配置                           |
| 查询完全失败     | 报告尝试的工具、参数类别和错误，不编造数据                                         |