qcc-agent-cli

企查查智能体数据平台命令行工具 —— 为人类和 AI Agent 而生的企业数据查询利器

📖 项目简介

qcc-agent-cli 是企查查官方推出的命令行工具，旨在帮助开发者和 AI Agent 快速访问企业工商信息、知识产权、经营风险、招投标与拟建项目等全维度商业数据。

核心能力：

• 🎯 多服务域覆盖：企业信息、风险信息、经营信息、知识产权、历史信息、董监高、法律数据、标讯数据与智能文档解析
• 🔧 201 个查询工具：覆盖企业、法律、司法案例与招投标等数据查询场景，实际数量以 qcc list-tools 为准
• 🤖 AI Agent 友好：Markdown 格式化输出、Schema 自省、参数自动验证
• 🔒 安全可控：配置隔离、敏感信息脱敏

🌟 为什么选择 qcc-agent-cli？

🤖 为 AI Agent 原生设计

• Markdown 格式化输出：默认输出易读的 Markdown 格式，支持 --json 输出原始 JSON
• 参数自描述：每个工具的 inputSchema 完整描述参数类型和用途
• Schema 自省：支持 qcc list-tools 动态获取工具定义，Agent 可自主发现能力
• 确定性输出：无歧义的错误码和状态码，便于 Agent 决策

👤 为人类开发者设计

• 简洁命令：qcc company get_company_registration_info "企业名称"
• 友好输出：默认 Markdown 格式化展示，支持 --json 输出原始数据
• 智能提示：内置 --help 和参数验证，快速上手
• 配置检查：qcc check 一键诊断配置状态

🏢 为企业级应用设计

• 配置驱动：统一配置文件 ~/.qcc/config.json，支持多环境切换
• 工具缓存：本地缓存工具定义，减少网络请求，提升响应速度
• 错误处理：统一的错误类型和友好的错误提示

🚀 零门槛上手

• 3 分钟安装：npm install -g qcc-agent-cli
• 一行命令查询：无需编写代码，命令行直达数据
• MIT 开源协议：可自由定制和扩展

🛡️ 安全可控

• 凭证隔离：配置文件权限自动设置为 600，仅所有者可读写
• 敏感信息脱敏：日志和输出中自动隐藏密钥和 Token

⚡ 功能特性

数据服务矩阵

| 服务标识 | 服务名称 | 工具数 | 典型场景 | 文档 | | :---: | :---: | :---: | :--- | :--- | | company | 企业信息 | 16 | 企业画像、工商核验、股权结构与财务概览 | 查看文档 | | risk | 风险信息 | 38 | 司法风险、信用风险、税务风险、担保与资产受限排查 | 查看文档 | | operation | 经营信息 | 35 | 经营动态、资质许可、融资、舆情、监管与市场活动分析 | 查看文档 | | ipr | 知识产权 | 18 | 商标、专利、软著、应用产品、社媒账号与网络服务备案分析 | 查看文档 | | history | 历史信息 | 34 | 历史沿革追溯、历史风险回溯、历史股权与司法记录核查 | 查看文档 | | executive | 董监高 | 44 | 董监高任职穿透、个人风险核查、关联企业识别 | 查看文档 | | regulation | 法律法规 | 6 | 法规检索、法条定位、引用核验与修订沿革查询 | qcc list-tools regulation | | case | 司法案例 | 4 | 类案检索、裁判文书详情与司法引用核验 | qcc list-tools case | | tender | 标讯数据 | 6 | 招投标搜索、拟建项目查询、企业搜索与企业招投标查询 | 查看文档 |

除上述数据查询服务外，document 提供本机文件、在线链接的文档解析及异步结果查询能力，详见文档解析任务提交与结果查询。

🚀 快速开始

1. 环境准备

| 依赖 | 要求 | | :--- | :--- | | Node.js | >= 18.0 | | npm | >= 9.0 |

2. 安装工具

使用 npm 全局安装：

npm install -g qcc-agent-cli

如已安装，可通过以下命令更新到最新版本：

npm update -g qcc-agent-cli

安装完成后，验证版本：

qcc --version

3. 初始化配置

在使用之前，需要配置您的 MCP 服务地址和鉴权信息：

qcc init --authorization "Bearer YOUR_API_KEY"

仅指定 --authorization 时，CLI 会把 mcp.baseUrl 恢复为默认值 https://agent.qcc.com/mcp。这也可用于修复旧配置中误写为 .../company/stream 等具体服务端点的地址。如需使用自定义 MCP 基础地址，请显式传入：

qcc init --mcpBaseUrl "http://localhost:8401/custom" --authorization "Bearer YOUR_API_KEY"

4. 开启查询

查询企业工商注册信息：

qcc company get_company_registration_info "企查查科技股份有限公司"

📖 命令手册

基础管理命令

| 命令 | 描述 | 示例 | | :--- | :--- |:-------------------------------------------------------| | init | 初始化全局配置 | qcc init --authorization "Bearer YOUR_API_KEY" | | check | 检查当前配置有效性及环境状态 | qcc check | | update | 强制同步远程工具定义到本地缓存 | qcc update | | list-tools | 列出当前支持的所有查询工具 | qcc list-tools <server> |

数据查询调用

qcc <server> <tool> --<paramKey> "<paramValue>" [--<filterKey> "<filterValue>"]

工具定义通常会自动同步。服务端工具发生变化但本地尚未生效时，可手动刷新缓存；需要查看当前服务支持的工具及参数时，可查询对应服务的工具列表：

qcc update
qcc list-tools <server>

文档解析任务提交与结果查询

提供专用 document 命令，用于提交本地文件或 HTTP(S) 文档 URL 创建解析任务，并根据 task_id 查询解析状态和 Markdown 结果。命令默认输出 JSON，便于脚本和 Agent 继续处理。

# 本地文件异步提交
qcc document parse_document --file_path "./sample.pdf"

# 本地文件同步等待 Markdown 结果
qcc document parse_document --file_path "./sample.pdf" --wait

# URL 文件异步提交
qcc document parse_document --file_url "https://files.example.com/sample.pdf"

# URL 文件同步等待 Markdown 结果
qcc document parse_document --file_url "https://files.example.com/sample.doc" --wait


# 查询任务结果
qcc document get_parse_result "<task_id>"

parse_document 当前仅支持 --file_path、--file_url、--wait 三个参数。--file_path <path> 与 --file_url <url> 必须二选一且只能提供一个：本地文件会从当前机器读取并提交解析，URL 文件会直接按 URL 提交；CLI 不会为 URL 文件做下载或探测。

--wait 是布尔开关，不传时创建异步任务并返回 task_id；传入时会尝试等待解析完成，若已完成可直接返回 details[].result_md，若仍在处理中则继续使用 get_parse_result 查询。当前版本暂不支持 --start_page_id、--end_page_id 指定页码范围；传入会作为无效参数处理。

document 命令复用 qcc init 写入的全局配置和鉴权信息，不需要单独配置文档解析地址或凭证。未初始化或凭证不可用时，请先运行 qcc init 或 qcc check。

当前 CLI 只支持单文件解析；不支持多文件、base64、直接传文件内容、callback、计费控制、check_params、full_json、title_tree 或完整 result 控制项。文件类型、大小、页数等业务规则以服务端校验结果为准。

📚 查询指令手册

调用格式

qcc <server> <tool> --<paramKey> "<paramValue>" [--<filterKey> "<filterValue>"]

参数说明：

• server：服务标识（company / risk / operation / ipr / history / executive / regulation / case / tender）
• tool：工具名称，可通过 qcc list-tools <server> 获取
• --paramKey：参数键，如 --searchKey、--personName、--year、--role
• paramValue：参数值，如企业名称、统一社会信用代码、人员姓名、年份、日期或状态过滤值

通用参数：

• --json：输出原始 JSON 格式（默认输出 Markdown 格式化结果）
• 可选过滤参数按工具 schema 追加；CLI 会按工具 schema 自动转换数字、布尔值和数组。
• 数组类型参数可传单个值，例如 --role "原告"；多个值请重复传入同一选项，例如 --role "原告" --role "被告"。

服务文档

| 服务标识 | 服务名称 | 工具数 | 典型场景 | 文档 | | :---: | :---: | :---: | :--- | :--- | | company | 企业信息 | 16 | 企业画像、工商核验、股权结构与财务概览 | 查看文档 | | risk | 风险信息 | 38 | 司法风险、信用风险、税务风险、担保与资产受限排查 | 查看文档 | | operation | 经营信息 | 35 | 经营动态、资质许可、融资、舆情、监管与市场活动分析 | 查看文档 | | ipr | 知识产权 | 18 | 商标、专利、软著、应用产品、社媒账号与网络服务备案分析 | 查看文档 | | history | 历史信息 | 34 | 历史沿革追溯、历史风险回溯、历史股权与司法记录核查 | 查看文档 | | executive | 董监高 | 44 | 董监高任职穿透、个人风险核查、关联企业识别 | 查看文档 | | regulation | 法律法规 | 6 | 法规检索、法条定位、引用核验与修订沿革查询 | qcc list-tools regulation | | case | 司法案例 | 4 | 类案检索、裁判文书详情与司法引用核验 | qcc list-tools case | | tender | 标讯数据 | 6 | 招投标搜索、拟建项目查询、企业搜索与企业招投标查询 | 查看文档 |

各服务的工具说明已拆分到独立文档，便于按需查阅和后续维护。

⚙️ 配置说明

配置文件默认存储在 ~/.qcc/config.json。

字段解析

• mcp.baseUrl: MCP API 服务基础路径，默认值为 https://agent.qcc.com/mcp，document 文档解析命令也复用该地址。该值只允许 HTTP(S) 基础地址，不能包含查询参数、锚点或 /company/stream 等具体服务端点；末尾的 / 会自动移除。
• mcp.authorization: MCP 与 document 文档解析共用访问凭证，输出时会自动脱敏。
• mcp.timeout: 通用请求超时时间（毫秒）；document 的 parse_document 提交阶段固定为 300 秒，get_parse_result 仍使用该值。
• mcp.enabled: 是否启用 MCP 模式（默认 true）。

配置命令

# 设置配置
qcc config set mcp.baseUrl "https://agent.qcc.com/mcp"
qcc config set mcp.authorization "Bearer YOUR_API_KEY"

# 获取配置
qcc config get mcp.baseUrl

# 列出所有配置
qcc config list

qcc init --authorization "<token>" 用于重新初始化连接配置，会把 mcp.baseUrl 恢复为默认值。若只想更新凭证并保留现有自定义地址，请使用 qcc config set mcp.authorization "<token>"。修改 mcp.baseUrl 或 mcp.authorization 后，旧工具缓存会自动清除。

安全性提示

• 敏感信息遮蔽：在执行 config list 或 check 时，authorization 将显示为 [已配置]。
• 权限保护：配置文件目录由系统权限自动保护（权限 600），建议不要手动将其暴露在公共仓库中。

🏗️ 目录结构

qcc-cli/
├── bin/
│   └── index.js              # CLI 入口
├── src/
│   ├── cliSetup.js           # CLI 命令注册
│   ├── commands/             # 指令实现 (init, check, update, config...)
│   ├── services/             # 核心逻辑 (MCP 协议解析、配置持久化)
│   ├── utils/                # 工具类 (HTTP 客户端、验证器、格式化器)
│   └── config/               # 静态服务与工具定义
└── package.json

📄 开源协议

本项目遵循 MIT License 开源协议。