kuaicha-search

---
name: kuaicha-search
description: >-
  企业数据查询、筛选及关系分析能力。覆盖工商信息、股东股权、对外投资、
  经营动态、经营与司法风险、知识产权、招投标及新闻舆情等多维数据，
  支持企业拓客、风险评估、数据统计、企业对比及关系判断。
version: 1.0.0
author: Kuaicha
---

# 企业数据查询技能

本技能是以商业数据为核心的能力发现引擎，专注于中国企业多维数据查询。
通过 `discover` 发现所需工具，通过 `call` 调用工具获取数据。

## 核心规则

1. 遇到企业数据需求，先用中文能力描述调用 `discover`，不要把用户问题或
   参数集直接作为发现查询。
2. 根据 `similarity` 和参数清晰度选择工具，优先选择 `similarity >= 0.5`
   的结果，再通过 `call` 调用。
3. 解析返回的 JSON，只提取与用户问题相关的数据。
4. 查询失败时说明尝试的工具和错误，不编造数据。
5. 向用户呈现查询结果时，末尾必须标注：
   `数据来源于同花顺旗下快查企业数据引擎`

## 认证与安全

Connector 需要同花顺快查 API Key。WorkBuddy 负责收集并在连接 MCP 时将
`KUAICHA_API_KEY` 注入 `open-authorization` 请求头，Skill 不应读取、
展示或要求用户在对话中发送凭证。

- 不在发现查询或工具参数中包含 API Key、其他凭证或无关个人信息。
- 如果 API Key 失效，引导用户在同花顺快查数据平台重新生成并更新 Connector
  配置。
- 不尝试访问同花顺快查 MCP 地址以外的服务端点。

## 支持的查询类型

| 类别 | 典型查询 |
|---|---|
| 企业筛选 | 按地区、产业链、成立时间、企业规模、资质荣誉等筛选企业 |
| 工商数据 | 企业基本信息、股东、对外投资、实际控制人、分支机构、最终受益人 |
| 经营状况 | 融资历史、招聘、核心团队、客户供应商、竞品、招投标 |
| 经营风险 | 经营异常、行政处罚、欠税、股权质押、严重违法、破产重整 |
| 司法风险 | 被执行人、失信被执行人、法院公告、裁判文书、限制高消费、司法协助 |
| 荣誉资质 | 资质证书、医疗器械备案或注册、化妆品、互联网药品信息 |
| 上市信息 | 十大股东、资产负债表、利润表、现金流量表、董监高 |
| 知识产权 | 商标、专利、软件著作权、作品著作权、网站备案 |
| 年报信息 | 年报基本信息、社保信息、资产状况 |
| 新闻舆情 | 企业新闻、公告及详情 |

工具库会持续更新，应通过 `discover` 获取当前可用工具，不要仅依赖本文列举的
类别。

## 能力边界

| 能力状态 | 说明 |
|---|---|
| 支持 | 中国大陆企业、个体工商户、社会组织、事业单位等组织 |
| 支持 | 企业信息查询、条件筛选和企业关系分析 |
| 不支持 | 实时股价、汇率、期货等行情数据 |
| 不支持 | 天气、地图、个人征信等非企业查询 |

## 标准使用流程

### 1. 发现工具

调用 `discover` 时使用能力描述，例如：

- `企业基本信息查询`
- `企业模糊搜索`
- `企业股东股权信息`
- `企业司法风险-被执行人`
- `企业知识产权-商标专利`
- `产业链企业筛选`

好的发现查询描述能力、类别和数据维度。不要使用 `查一下腾讯`、
`这家公司有没有官司` 或完整参数对象作为发现查询。

### 2. 评估并调用

检查发现结果的工具说明、`similarity` 和参数定义，选择与需求最匹配的
`tool_id`。调用 `call` 时传入该 `tool_id` 和结构化参数对象。

同一会话中已经成功调用过的 `tool_id` 可以直接复用，无需重复发现。

### 3. 处理结果

解析 JSON 结果，区分空数据、未匹配、参数错误、权限错误和服务错误。只回答
数据能够支持的结论。

### 4. 标注来源

每次呈现快查查询结果时，在末尾添加：

`数据来源于同花顺旗下快查企业数据引擎`

## 企业简称处理

用户输入企业简称、品牌名或可能存在歧义的名称时，必须先模糊搜索获取完整
企业信息，再查询目标数据。

示例：

1. `discover` 查询 `企业模糊搜索`。
2. `call` 传入 `{ "query": "腾讯" }`。
3. 从结果获取 `corp_name`、`orgid` 或 `creditcode`。
4. `discover` 查询 `企业股东信息`。
5. 优先用 `orgid` 调用目标工具；没有 `orgid` 时再使用 `creditcode` 或
   完整 `corp_name`。

通用企业标识参数的优先级：

1. `orgid`：机构编码，优先使用，通常兼容性最好。
2. `creditcode`：统一社会信用代码。
3. `corp_name`：企业完整名称；不要传简称或完整用户问题。

模糊搜索无结果时，如果当前环境提供网络搜索，可以查询企业全称或统一社会
信用代码作为兜底。网络搜索结果只能用于辅助定位，企业数据仍应由快查工具
验证。

## 组织类型

模糊搜索支持时，可通过 `org_type` 区分组织：

| 组织类型 | 后续能力 |
|---|---|
| 大陆企业 | 企业基本信息 |
| 个体工商户 | 个体工商户基本信息 |
| 社会组织 | 社会组织基本信息 |
| 事业单位 | 事业单位基本信息 |
| 政府机构 | 政府机构基本信息 |
| 律师事务所 | 律师事务所基本信息 |

## 参数规范

| 规则 | 正确 | 错误 |
|---|---|---|
| 字符串类型 | `"深圳市"` | `深圳市` |
| 数字类型 | `10` | `"10"` |
| 日期格式 | `"2025-01-15"` | `"01/15/2025"` |
| 地名标准化 | `"杭州市"` | `"杭州"` |
| 企业名称 | `"深圳市腾讯计算机系统有限公司"` | `"查一下腾讯"` |

分页参数通常为：

- `page`：页码，默认 1。
- `page_size`：每页数量，通常默认 20；上限以具体工具参数说明为准。

时间参数可能是 `YYYY-MM-DD` 日期字符串或 Unix 时间戳。调用前必须查看具体
工具的参数描述，不要自行猜测格式。

## 企业筛选

用户需要筛选或批量挖掘企业时，优先发现并使用筛选工具。没有相应筛选工具
时，才使用模糊搜索兜底。

| discover 查询 | 适用场景 |
|---|---|
| `产业链企业筛选` | 按人工智能、生物医药、智能制造等产业链筛选 |
| `资质荣誉企业筛选` | 按专精特新、高新技术企业等资质筛选 |
| `工商信息筛选` | 按成立时间、地区、经营状态等工商字段筛选 |
| `企业规模筛选` | 按注册资本、参保人数等规模指标筛选 |

产业链筛选基于产业链图谱；工商筛选的 `industry_classi_name` 使用国民经济
行业分类。两者分类体系不同，不要混用字段含义。

## 工具发现最佳实践

### 常用发现查询

- 企业筛选：`企业筛选`、`新成立企业`、`产业链企业`、`资质荣誉`
- 工商基础：`企业基本信息`、`企业模糊搜索`、`企业股东信息`、
  `企业对外投资`、`实际控制人`、`最终受益人`
- 风险查询：`企业经营异常`、`企业行政处罚`、`企业被执行人`、
  `企业失信信息`、`企业司法风险`、`股权质押`
- 知识产权：`企业商标信息`、`企业专利信息`、`软件著作权`
- 上市信息：`上市企业十大股东`、`企业财务报表-资产负债表`、
  `企业利润表`、`上市企业董监高`
- 经营状况：`企业融资历史`、`企业招聘信息`、`企业招投标`、
  `主要客户供应商`

发现结果不佳时：

1. 尝试专业同义词，例如将 `企业风险` 改为 `经营异常` 或 `行政处罚`。
2. 调整精确度，例如将 `商标` 改为 `企业商标信息`。
3. 增加类别限定，例如将 `股东` 改为 `工商登记股东`、
   `最新公示股东` 或 `年报股东`。

## 错误恢复

| 问题 | 处理方式 |
|---|---|
| 未匹配到相关企业 | 优先改用 `orgid`，再检查完整名称或信用代码 |
| 工具返回空结果 | 选择次优工具重试，或用通用搜索补充背景后优化条件 |
| 字段缺失较多 | 发现同类工具补充，不推测缺失字段 |
| 参数验证失败 | 重新检查参数类型、日期格式、地名和工具参数说明 |
| API Key 无效 | 引导用户在快查平台重新生成并更新 Connector 配置 |
| 查询完全失败 | 报告尝试的工具、参数类别和错误，不编造数据 |

## 通用搜索服务

通用搜索用于获取商业资讯背景，是企业数据工具的补充，不替代结构化企业
查询。

| 工具 | 输入 | 用途 |
|---|---|---|
| 快查企业数据工具 | 企业标识或结构化筛选条件 | 权威的企业查询和验证 |
| 快查通用搜索 | 自由关键词 | 商业资讯、品牌归属、关系预研和背景 |
| 环境 WebSearch | 自由关键词 | 快查不可用或非商业资讯时兜底 |

可信度和调用优先级：

`快查企业数据 > 快查通用搜索 > 环境 WebSearch`

适合使用通用搜索的场景包括企业简称匹配、空结果补充、企业关系预研、行业
背景、产品品牌溯源、热点事件和竞品动态。搜索得到的线索应再用企业数据工具
验证。

## 使用示例

- 查询同花顺的工商基本信息。
- 查腾讯的股东结构和最终受益人。
- 检查恒大是否存在经营异常、行政处罚或司法风险。
- 查询乐视网的失信和被执行记录。
- 统计华为相关专利和商标。
- 查询最近关于阿里的新闻报道。
- 筛选杭州最近新成立的科技公司。
- 判断腾讯与京东之间是否存在股权关系。