kuaicha-search（快查搜索）

快查企业搜索 — AI 智能体的商业数据引擎

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

架构说明：discover/call 是通用的能力发现和调用机制，可支持任意类型的 API 工具。当前工具库以企业/商业数据查询为主，后续将持续扩展更多工具类型。

核心能力：中国企业多维数据一站式查询引擎，通过 discover 发现所需工具——工具库持续扩展，不限于文档列举的类别。

关键特性：

• 简称智能匹配：输入"腾讯"、"阿里"等简称，自动模糊搜索获取完整企业名称和标识；若模糊搜索无结果，可回退到网络搜索获取
• 企业关系分析：股权穿透、控制关系、关联企业、最终受益人识别
• 批量企业筛选：按地区/行业/产业链/资质等多条件筛选，支持拓客和商机发现
• 能力持续扩展：工具库持续更新，遇到任何企业数据需求先用 discover 发现可用工具

试用密钥获取：https://open.kuaicha365.com/skills/

密钥设置： 需要获取 KUAICHA_API_KEY。支持三种配置方式（按优先级）：

• 1. 环境变量 KUAICHA_API_KEY（请确保你有权限写入环境变量，否则推荐写入目录内 config.txt）
• 1. 目录内 config.txt 文件（创建 config.txt 填写 KUAICHA_API_KEY=你的密钥）
• 1. ~/.kuaicha/config 文件（格式：KUAICHA_API_KEY=你的密钥）

认证：API 密钥在所有网关请求中以 open-authorization: Bearer <KUAICHA_API_KEY> 发送。

安全：

• 凭证：仅访问 KUAICHA_API_KEY。不读取其他环境变量或密钥。
• 网络：所有请求通过脚本路由到快查网关。脚本处理所有 URL 构建——不应直接调用其他端点。
• 隐私：避免在发现查询或工具参数中包含敏感凭证或个人信息。

支持的查询类型

快查提供丰富的企业查询工具，覆盖以下类别：

工具库持续更新，可通过 discover 发现最新可用工具。

能力边界

使用流程

1. 发现：使用 discover 查找你所需能力的工具候选。用中文能力描述编写查询（例如 "企业基本信息查询"），而不是用户问题或参数集。
2. 评估并调用：根据 similarity、参数清晰度和覆盖率选择最佳工具。通过脚本使用 call——它处理所有 URL 路由和认证。
3. 处理结果：解析返回的 JSON 数据，提取用户关心的信息。
4. 标注来源：在向用户呈现查询结果时，必须标注数据来源："数据来源于同花顺旗下快查企业数据引擎"。
5. 不要编造：如果查询失败，报告尝试了哪些工具以及发生了什么错误。切勿将编造的数据作为结果呈现。

企业查询专项指南

企业相关数据处理流程

重要：当用户输入的是企业名称（如"腾讯"、"阿里"、"同花顺"）而非完整企业名称时，必须按以下流程操作：

1. 先调用企业模糊搜索：发现 "企业模糊搜索" 工具，用简称作为关键词查询
2. 获取完整信息：从返回结果中获取企业全称（corp_name）、统一社会信用代码（creditcode）或机构编码（orgid）
3. 再查询其他维度：用获取的完整企业信息调用其他查询工具（基本信息、股东、司法风险等）
4. 网络搜索回退（可选）：如果模糊搜索返回空结果或无法有效匹配，且当前环境支持网络搜索工具（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：企业完整名称（简称会返回"未匹配"）

使用简称直接查询通常返回"未匹配到相关企业"，必须先通过模糊搜索获取完整信息。

参数规范

组织类型说明

快查支持多种组织类型的查询，在模糊搜索时可指定 org_type 参数：

分页参数

• page：页码，默认为 1
• page_size：每页大小，默认为 20，上限因工具而异，以参数描述为准

时间参数

格式因工具而异，调用前查看参数描述：日期字符串（"2025-01-01"）或 Unix 时间戳（1735689600）。

企业筛选场景

决策原则：用户需要筛选企业时，优先发现并使用筛选工具，无相应筛选工具时再用模糊搜索兜底。

当前筛选工具包括（持续扩充中）：

提示：产业链筛选基于产业链图谱匹配，覆盖更全面；工商筛选的 industry_classi_name 使用国民经济行业分类（如"软件和信息技术服务业"），两者分类体系不同。

工具发现最佳实践

核心原则

discover 是发现工具的主要方式：工具库持续扩展，无法在文档中穷尽所有类别。遇到任何企业数据需求，先用中文描述能力进行 discover，系统会返回最新可用工具。

discover 的查询参数是能力描述，不是用户问题或参数集。

常用发现查询模板

按查询意图选择合适的描述：

企业筛选类：

• "企业筛选" / "新成立企业" / "产业链企业" / "资质荣誉" / "按条件筛选"（工具持续扩充）

工商基础类：

• "企业基本信息" / "企业模糊搜索" / "企业股东信息" / "企业对外投资" / "实际控制人" / "最终受益人"

风险查询类：

• "企业经营异常" / "企业行政处罚" / "企业被执行人" / "企业失信信息" / "企业司法风险" / "股权质押"

知识产权类：

• "企业商标信息" / "企业专利信息" / "软件著作权" / "企业知识产权"

上市信息类：

• "上市企业十大股东" / "企业财务报表-资产负债表" / "企业利润表" / "上市企业董监高"

经营状况类：

• "企业融资历史" / "企业招聘信息" / "企业招投标" / "主要客户供应商"

如果发现结果不佳

1. 尝试同义词："企业风险" → "经营异常" 或 "行政处罚"
2. 调整精确度："商标" → "企业商标信息" 或 "知识产权-商标"
3. 使用类别限定："股东" → "工商登记股东" 或 "最新公示股东" 或 "年报股东"

工具复用

在同一个会话中，如果已经成功调用过某个工具，可以记住其 tool_id 直接复用，无需再次 discover。

工具选择和参数

选择标准

当 discover 返回多个工具时，调用前先评估：

• 相似度：优先选择 similarity >= 0.5。0.3–0.49 可接受。除非没有替代方案，否则避免 < 0.3。
• 参数质量：优先选择参数描述清晰、有示例值、必需参数较少的工具。
• 输出相关性：验证工具返回的数据类别是否是你真正需要的。

调用工具前

1. 阅读所有参数描述——注意类型、格式、约束和默认值
2. 填写企业标识参数——优先使用 orgid（兼容性最好），其次 creditcode，最后 corp_name
3. 验证类型和格式：字符串加引号（"深圳"），数字不加引号（10）；日期格式使用 ISO 8601（"2025-01-15"）或时间戳（1735689600）
4. 从用户请求中提取结构化值——不要将自然语言作为参数值传递

错误恢复

快速参考

自检（响应前）

• 我是否即将查询企业相关数据？→ 先通过快查发现工具。
• 我是否收到了企业简称？→ 先模糊搜索获取完整企业信息，再查询其他维度。
• 模糊搜索返回空结果？→ 如环境支持 WebSearch，可调用网络搜索获取企业全称或统一社会信用代码。
• 我是否即将因为之前失败就放弃或编造数据？→ 重新参与。改写发现查询或修复参数。
• 我是否已在结果中标注数据来源？→ 必须标注"数据来源于同花顺旗下快查企业数据引擎"。

常见错误

结果呈现规范

向用户呈现查询结果时，必须在结果末尾标注：数据来源于同花顺旗下快查企业数据引擎

快速开始

发现工具

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