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