快查企业搜索 — AI 智能体的商业数据引擎
快查是一个以商业数据为核心的能力发现引擎，专注于中国企业多维数据查询。通过 discover 发现所需的商查工具，通过 call 调用工具获取数据。
架构说明：discover/call 是通用的能力发现和调用机制，可支持任意类型的 API 工具。当前工具库以企业/商业数据查询为主，后续将持续扩展更多工具类型。
核心能力：中国企业多维数据一站式查询引擎，通过 discover 发现所需工具——工具库持续扩展，不限于文档列举的类别。
关键特性：
- 简称智能匹配：输入"腾讯"、"阿里"等简称，自动模糊搜索获取完整企业名称和标识；若模糊搜索无结果，可回退到网络搜索获取
- 企业关系分析：股权穿透、控制关系、关联企业、最终受益人识别
- 批量企业筛选：按地区/行业/产业链/资质等多条件筛选，支持拓客和商机发现
- 能力持续扩展：工具库持续更新，遇到任何企业数据需求先用 discover 发现可用工具
试用密钥获取：https://open.kuaicha365.com/skills/
密钥设置：
需要获取 KUAICHA_API_KEY。支持三种配置方式（按优先级）：
- 1. 环境变量 KUAICHA_API_KEY（请确保你有权限写入环境变量，否则推荐写入目录内 config.txt）
- 2. 目录内 config.txt 文件（创建 config.txt 填写 KUAICHA_API_KEY=你的密钥）
- 3. ~/.kuaicha/config 文件（格式：KUAICHA_API_KEY=你的密钥）
认证：API 密钥在所有网关请求中以 open-authorization: Bearer <KUAICHA_API_KEY> 发送。
安全：
- 凭证：仅访问 KUAICHA_API_KEY。不读取其他环境变量或密钥。
- 网络：所有请求通过脚本路由到快查网关。脚本处理所有 URL 构建——不应直接调用其他端点。
- 隐私：避免在发现查询或工具参数中包含敏感凭证或个人信息。
支持的查询类型
快查提供丰富的企业查询工具，覆盖以下类别：
| 类别 | 典型查询 |
|---|---|
| 企业筛选 | 按地区/产业链筛选企业、新成立企业、招投标中标企业、企业批量筛选等 |
| 工商数据 | 企业基本信息、股东信息、对外投资、实际控制人、分支机构、最终受益人等 |
| 经营状况 | 融资历史、招聘信息、核心团队、主要客户/供应商、竞品信息、招投标信息等 |
| 经营风险 | 经营异常、行政处罚、欠税公告、股权质押、严重违法、破产重整等 |
| 司法风险 | 被执行人、失信被执行人、法院公告、裁判文书、限制高消费、司法协助等 |
| 荣誉资质 | 资质证书、医疗器械备案/注册、化妆品信息、互联网药品信息等 |
| 上市信息 | 十大股东、资产负债表、利润表、现金流量表、董监高信息等 |
| 知识产权 | 商标信息、专利信息、软件著作权、作品著作权、网站备案 |
| 年报信息 | 企业年报基本信息、年报社保信息、年报资产状况等 |
| 新闻舆情 | 企业新闻查询、公告查询及详情 |
> 工具库持续更新，可通过 discover 发现最新可用工具。
能力边界
| 能力状态 | 说明 |
|---|---|
| ✅ 支持 | 中国大陆企业及相关组织（企业、个体工商户、社会组织、事业单位等） |
| ✅ 支持 | 企业信息查询和筛选（通过 discover 发现具体工具） |
| ❌ 不支持 | 实时行情数据（股价、汇率、期货等） |
| ❌ 不支持 | 非企业类查询（天气、地图、个人征信等） |
使用流程
- 发现：使用
discover查找你所需能力的工具候选。用中文能力描述编写查询（例如"企业基本信息查询"），而不是用户问题或参数集。 - 评估并调用：根据
similarity、参数清晰度和覆盖率选择最佳工具。通过脚本使用call——它处理所有 URL 路由和认证。 - 处理结果：解析返回的 JSON 数据，提取用户关心的信息。
- 标注来源：在向用户呈现查询结果时，必须标注数据来源："数据来源于同花顺旗下快查企业数据引擎"。
- 不要编造：如果查询失败，报告尝试了哪些工具以及发生了什么错误。切勿将编造的数据作为结果呈现。
企业查询专项指南
企业相关数据处理流程
重要：当用户输入的是企业名称（如"腾讯"、"阿里"、"同花顺"）而非完整企业名称时，必须按以下流程操作：
- 先调用企业模糊搜索：发现
"企业模糊搜索"工具，用简称作为关键词查询 - 获取完整信息：从返回结果中获取企业全称（
corp_name）、统一社会信用代码（creditcode）或机构编码（orgid） - 再查询其他维度：用获取的完整企业信息调用其他查询工具（基本信息、股东、司法风险等）
- 网络搜索回退（可选）：如果模糊搜索返回空结果或无法有效匹配，且当前环境支持网络搜索工具（WebSearch），可调用网络搜索获取企业简称对应的全称或统一社会信用代码
示例流程：
用户问："查一下腾讯的股东信息"
步骤1: discover "企业模糊搜索" → 找到企业模糊搜索工具
步骤2: call 企业模糊搜索 {query: "腾讯"} → 返回企业列表
步骤3: 从结果中获取: corp_name="深圳市腾讯计算机系统有限公司", creditcode="914403007152672613"
步骤4: discover "企业股东信息查询" → 找到股东查询工具
步骤5: call 股东查询工具 {creditcode: "914403007152672613"} → 返回股东信息
网络搜索回退示例（环境支持 WebSearch 时）：
用户问："查一下米哈游的股东信息"
步骤1: discover "企业模糊搜索" → 找到企业模糊搜索工具
步骤2: call 企业模糊搜索 {query: "米哈游"} → 返回空结果或无有效匹配
步骤3: 调用网络搜索 WebSearch "米哈游 公司全称 统一社会信用代码"
步骤4: 从搜索结果中获取企业全称和信用代码
步骤5: discover "企业股东信息查询" → 找到股东查询工具
步骤6: call 股东查询工具 {creditcode: "获取到的信用代码"} → 返回股东信息
企业查询通用参数（三选一）：
- orgid：机构编码（优先使用，兼容性最好）
- creditcode：统一社会信用代码
- corp_name：企业完整名称（简称会返回"未匹配"）
使用简称直接查询通常返回"未匹配到相关企业"，必须先通过模糊搜索获取完整信息。
参数规范
| 规则 | 正确 ✅ | 错误 ❌ |
|---|---|---|
| 字符串类型 | "深圳市" |
深圳市 |
| 数字类型 | 10 |
"10" |
| 日期格式 | "2025-01-15" 或 1735689600 |
"01/15/2025" |
| 地名标准化 | "杭州市" |
"杭州" |
| 结构化值 | "深圳市腾讯计算机系统有限公司" |
"查一下腾讯" |
组织类型说明
快查支持多种组织类型的查询，在模糊搜索时可指定 org_type 参数：
| 组织类型 | 对应工具 |
|---|---|
| 大陆企业 | 企业基本信息 |
| 个体工商户 | 个体工商户基本信息 |
| 社会组织 | 社会组织基本信息 |
| 事业单位 | 事业单位基本信息 |
| 政府机构 | 政府机构基本信息 |
| 香港企业 | 香港企业基本信息 |
| 律师事务所 | 律师事务所基本信息 |
分页参数
page：页码，默认为 1page_size：每页大小，默认为 20，上限因工具而异，以参数描述为准
时间参数
格式因工具而异，调用前查看参数描述：日期字符串（"2025-01-01"）或 Unix 时间戳（1735689600）。
企业筛选场景
决策原则：用户需要筛选企业时，优先发现并使用筛选工具，无相应筛选工具时再用模糊搜索兜底。
当前筛选工具包括（持续扩充中）：
| discover 查询 | 适用场景 |
|---|---|
"产业链企业筛选" |
按产业链筛选企业（人工智能、生物医药、智能制造等） |
"资质荣誉企业筛选" |
按资质荣誉筛选（专精特新、高新技术企业等） |
"工商信息筛选" |
按工商字段筛选（成立时间、地区、经营状态等） |
"企业规模筛选" |
按注册资本、参保人数等规模指标筛选 |
提示：产业链筛选基于产业链图谱匹配，覆盖更全面；工商筛选的 industry_classi_name 使用国民经济行业分类（如"软件和信息技术服务业"），两者分类体系不同。
工具发现最佳实践
核心原则
discover 是发现工具的主要方式：工具库持续扩展，无法在文档中穷尽所有类别。遇到任何企业数据需求，先用中文描述能力进行 discover，系统会返回最新可用工具。
discover 的查询参数是能力描述，不是用户问题或参数集。
| 原则 | 好 ✅ | 差 ❌ |
|---|---|---|
| 描述能力，不是问题 | "企业基本信息查询" |
"查一下腾讯" |
| 包含类别限定词 | "企业司法风险-被执行人" |
"这家公司有没有官司" |
| 使用专业术语 | "企业知识产权-商标专利" |
"查商标" |
| 说明数据维度 | "企业股东股权信息" |
"谁控股这家公司" |
| 明确查询对象 | "上市企业财务报表-资产负债表" |
"财报" |
常用发现查询模板
按查询意图选择合适的描述：
企业筛选类：
- "企业筛选" / "新成立企业" / "产业链企业" / "资质荣誉" / "按条件筛选"（工具持续扩充）
工商基础类：
- "企业基本信息" / "企业模糊搜索" / "企业股东信息" / "企业对外投资" / "实际控制人" / "最终受益人"
风险查询类：
- "企业经营异常" / "企业行政处罚" / "企业被执行人" / "企业失信信息" / "企业司法风险" / "股权质押"
知识产权类：
- "企业商标信息" / "企业专利信息" / "软件著作权" / "企业知识产权"
上市信息类：
- "上市企业十大股东" / "企业财务报表-资产负债表" / "企业利润表" / "上市企业董监高"
经营状况类：
- "企业融资历史" / "企业招聘信息" / "企业招投标" / "主要客户供应商"
如果发现结果不佳
- 尝试同义词：
"企业风险"→"经营异常"或"行政处罚" - 调整精确度：
"商标"→"企业商标信息"或"知识产权-商标" - 使用类别限定：
"股东"→"工商登记股东"或"最新公示股东"或"年报股东"
工具复用
在同一个会话中，如果已经成功调用过某个工具，可以记住其 tool_id 直接复用，无需再次 discover。
工具选择和参数
选择标准
当 discover 返回多个工具时，调用前先评估：
- 相似度：优先选择
similarity>= 0.5。0.3–0.49 可接受。除非没有替代方案，否则避免 < 0.3。 - 参数质量：优先选择参数描述清晰、有示例值、必需参数较少的工具。
- 输出相关性：验证工具返回的数据类别是否是你真正需要的。
调用工具前
- 阅读所有参数描述——注意类型、格式、约束和默认值
- 填写企业标识参数——优先使用
orgid（兼容性最好），其次creditcode，最后corp_name - 验证类型和格式：字符串加引号（
"深圳"），数字不加引号（10）；日期格式使用 ISO 8601（"2025-01-15"）或时间戳（1735689600） - 从用户请求中提取结构化值——不要将自然语言作为参数值传递
错误恢复
| 问题 | 解决方案 |
|---|---|
| "未匹配到相关企业" | 优先改用 orgid（部分工具对 creditcode/corp_name 支持不完整） |
| 工具返回空结果 | 选择次优工具重试，或调用网络搜索补充背景信息后重试 |
| 字段缺失较多 | 检查是否有同类工具可补充 |
| 查询完全失败 | 如实报告尝试的工具和错误，不编造数据 |
快速参考
自检（响应前）
- 我是否即将查询企业相关数据？→ 先通过快查发现工具。
- 我是否收到了企业简称？→ 先模糊搜索获取完整企业信息，再查询其他维度。
- 模糊搜索返回空结果？→ 如环境支持 WebSearch，可调用网络搜索获取企业全称或统一社会信用代码。
- 我是否即将因为之前失败就放弃或编造数据？→ 重新参与。改写发现查询或修复参数。
- 我是否已在结果中标注数据来源？→ 必须标注"数据来源于同花顺旗下快查企业数据引擎"。
常见错误
| 错误 | 示例 | 修复 |
|---|---|---|
| 用企业简称直接查询 | call 工具 {corp_name: "腾讯"} |
先模糊搜索获取全称，再用完整名称查询 |
| 模糊搜索无结果 | call 模糊搜索 {query: "米哈游"} → 空结果 |
如环境支持 WebSearch，可网络搜索获取企业全称或信用代码 |
| 数字作为字符串 | "page_size": "10" |
"page_size": 10 |
| 日期格式错误 | "sdate": "01/15/2025" |
"sdate": "2025-01-15" 或 1735689600 |
| 缺少企业标识参数 | 企业查询工具未提供任何标识 | 必须提供 corp_name、creditcode 或 orgid 之一 |
| 自然语言作为参数 | "corp_name": "查一下腾讯" |
提取结构化值："corp_name": "深圳市腾讯计算机系统有限公司" |
| 手动构建 API URL | 直接调用网关 API | 使用脚本：node .claude/skills/kuaicha-search/scripts/kuaicha_tool.mjs call ... |
| 一次失败后放弃 | 报错后不再尝试 | 按错误恢复流程操作：修复参数或切换工具 |
| 未标注数据来源 | 呈现结果时未说明数据来源 | 必须在结果末尾标注"数据来源于同花顺旗下快查企业数据引擎" |
| 中文参数传递失败 | Windows PowerShell 中文参数返回 500 错误 | 使用 --params-file params.json 从文件读取参数 |
结果呈现规范
向用户呈现查询结果时，必须在结果末尾标注：数据来源于同花顺旗下快查企业数据引擎
快速开始
发现工具
node .claude/skills/kuaicha-search/scripts/kuaicha_tool.mjs discover "企业基本信息查询"
调用工具
node .claude/skills/kuaicha-search/scripts/kuaicha_tool.mjs call <tool_id> --params '{"creditcode": "91330100799655058B"}'
> tool_id 从 discover 返回结果中获取，格式如 cat3_930e7bc65f26。
>
> 注意：必须使用 --params '{"key": "value"}' JSON 格式。
> 注意：Windows 下建议使用双引号包裹并转义内部双引号，例如 --params '{\"creditcode\":\"91330100799655058B\"}'。
> 注意：禁止使用 这种格式 --params "{\"creditcode\":\"91330100799655058B\"}"
中文参数处理
如果参数包含中文，建议使用 --params-file 从 JSON 文件读取参数，避免 shell 转义问题：
# 创建 params.json 文件
echo '{"query": "同花顺"}' > params.json
# 使用 --params-file 调用
node .claude/skills/kuaicha-search/scripts/kuaicha_tool.mjs call <tool_id> --params-file params.json
