白牛企业信息综合查询工具

查询中国大陆企业的全方位信息，支持单企业查询和批量导出。

重要说明：工具列表会持续动态更新，实际可用工具以 find_tool.js 查询结果为准。

密钥配置

首次使用先向用户询问密钥并配置API密钥，如若没有API密钥，请前往白牛商查申请获取：

1. 复制 .env.example 为 .env（若没有找到 .env.example 文件则直接创建 .env 文件）
2. 填入你的 BAINIU_API_KEY

详细配置说明见 references/config.md。

单企业查询

1. 查找工具

根据查询意图查找匹配的工具：

node scripts/find_tool.js "查询意图描述"

返回JSON包含：工具ID、描述、参数列表、匹配度评分。

2. 调用工具

node scripts/call.js <tool-id> key1=value1 key2=value2

重要: 参数必须使用 key=value 格式，禁止传入JSON字符串。

典型工作流程

注意：以下示例中的工具ID仅供参考，实际ID以 find_tool.js 返回结果为准。

# 步骤1：模糊搜索获取企业ID
node scripts/find_tool.js "企业模糊搜索"
node scripts/call.js 82e41e7c3f170ca1 key="小米"

# 步骤2：使用企业ID查询具体信息
node scripts/find_tool.js "企业高管查询"
node scripts/call.js 9c0d321a135295fc0c8ace6ccfa20d1a entid="<企业ID>" pindex=1 psize=20

工具复用

同一会话中已调用过的工具，可直接使用其 tool_id，无需再次 find_tool。

查询原则

1. 当有单个工具可以满足用户查询需求时，优先直接调用该工具，避免通过调用多个不同维度的工具来拼凑满足用户要求

批量企业信息导出或导出

当用户需要一次性查询多家企业（≥5家）的基本信息（工商登记、联系方式等）时，使用批量导出功能。将企业名称保存为 txt 文件后上传，即可获得包含所有匹配企业信息的 Excel 下载链接。

适用字段：统一社会信用代码、注册号、法定代表人、注册资本、注册地址、经营范围、联系方式（手机/固话/邮箱）等企业基本信息。

不适用：司法风险、知识产权、经营信息等非基本信息 → 使用单企业查询。

# 将企业名称写入txt文件（每行一个），然后上传
node scripts/upload_file.js "<txt文件路径>"

上传成功后返回 Excel 下载链接及剩余额度：

{
  "code": "200",
  "message": "SUCCESS",
  "result": {
    "file_link": "https://...xlsx",
    "matched_count": 1,
    "remaining_count": 4999
  },
  "error": null
}

若导出条数不足（code 为 "238"），需根据剩余额度减少查询企业数量并告知用户。

批量查询完成后，需删除批量查询过程中生成的临时文件，不删除用户的输入文件。

文件要求：.txt 格式、每行一个企业名称、单个文件最多10000行、超过则拆分为多个文件分别上传。

详细说明见 references/batch-enterprise-query.md。

错误处理

当查询失败或无结果时：

1. 认证失败：检查API密钥配置
2. 无结果：先用模糊搜索确认企业ID是否正确
3. 数据为空：可使用网络搜索作为回退方案

详细错误码说明见 references/error-codes.md。

参考文档

• 错误码与故障排除 - 遇到错误时查阅
• 工具参考 - 工具分类索引
• 批量企业信息导出 - 批量查询操作指南