📦 Business Information Inquiry Tool‌ — 商业信息查询工具

企业信息调研 Skill 功能概述 接收用户输入的企业名称，使用 Tavily Search API 作为主要数据源，从公开网络获取企业的工商信息、业务规模、行业地位及数字化系统应用（ERP、CRM、WMS、TMS 等），生成结构化的 HTML 调研报告。

适用场景 • ERP 售前客户背景调查（了解目标企业数字化现状） • 合作伙伴资质审查（评估其信息化成熟度） • 竞争对手分析（掌握对手业务与系统布局）

⚠️ 依赖说明 主要依赖：Tavily Search API 本 Skill 使用 Tavily Search API 作为主要数据源，纯 Python HTTP 实现，无需外部文件依赖。

配置方式（任选其一） 方式1：环境变量（推荐，所有 Claw 环境通用） export TAVILY_API_KEY=your_tavily_api_key_here

方式2：.env 文件（自动检测常见路径） # 以下路径自动识别： ~/.openclaw/workspace/.env ~/.qclaw/workspace/.env ~/.maxclaw/workspace/.env ~/.kimiclaw/workspace/.env ~/.env ./.env

获取 Tavily API Key： 访问 https://tavily.com/ 注册账号并获取 API Key 免费额度：每月约 1000 次调用，足够个人/小团队使用

降级方案（无 Tavily API Key） 如果没有配置 TAVILY_API_KEY，Skill 会自动降级使用 Brave 搜索（免费，无需 API Key）。 ⚠️ 重要提醒： 降级后的数据质量和完整性可能明显低于 Tavily；Brave 搜索返回的是网页 HTML，需要解析提取，可能存在信息缺失。建议配置 Tavily API Key 以获得最佳体验。

环境兼容性 ✅ 完全兼容以下环境（无需修改代码）： OpenClaw / QClaw / MaxClaw / KimiClaw 任何支持 Python 3.8+ 的环境

原理：使用标准库 urllib 直接 HTTP 调用 Tavily API，不依赖任何外部文件或特定 Claw 的目录结构。

接口定义 输入参数 参数名 类型 必填 说明 company_name string 是 企业全称或关键字（建议使用全称提高准确率）

调用方式 /enterprise_info <企业名称>

输出格式 生成完整 HTML 页面，包含以下板块：

• 企业基础信息

企业名称、统一社会信用代码、法定代表人、注册资本、实缴资本、成立日期、经营状态、登记机关、企业类型、所属行业、注册地址、经营范围

• 业务概况与行业地位

主营业务、主要产品/服务、行业地位、企业规模、年营业额/营业收入

• 数字化应用系统

ERP/CRM/WMS/TMS 等产品及厂商、其他系统、信息化水平评价

• 股东信息表格

前 5 大股东：名称、持股比例、认缴出资额

• 主要人员表格

姓名、职务

• 对外投资（如有）

被投资企业名称、投资比例、状态

• 司法风险概览（如有）

涉诉数量、被执行金额、开庭公告摘要

• 经营状况（如有）

纳税信用等级、社保参保人数、行政许可数量

数据源 主要数据源（推荐）：Tavily Search – 结构化搜索，返回带来源摘要，数据质量高 降级数据源：Brave 搜索 – 网页搜索，返回 HTML 需解析

使用示例 示例1：查询上市公司 /enterprise_info 深圳市共进电子股份有限公司

示例2：查询民营企业 /enterprise_info 西安农心作物科技股份有限公司

返回：企业信息调研报告 HTML 页面链接

异常处理 • 企业未找到：返回提示页面“未找到相关企业，请检查企业名称” • 搜索失败：显示错误信息及可能原因 • 数据缺失：字段显示“无公开数据”或“暂未获取” • 降级提醒：如未配置 Tavily API Key，报告顶部显示降级提示

配套资源 核心脚本 scripts/enterprise_search.py – 企业信息搜索脚本（Tavily + Brave 双数据源） scripts/html_generator.py – HTML 报告生成器 v3.2（模板化架构）

模板文件（v3.2 拆分） templates/report-css-v3.css – CSS 样式模板（独立文件，统一金蝶蓝主题） templates/report-html-v3.html – HTML 结构模板（独立文件，保证输出一致性）

参考文档 references/search_patterns.md – 搜索查询模板与正则提取规则

模板架构说明（v3.1 更新） 拆分原则 • 样式与逻辑分离：CSS 样式完全独立到 templates/report-css-v3.css • 生成器只负责数据填充：html_generator.py 读取外部模板，不再硬编码样式 • 兜底机制：如外部模板丢失，生成器内置基础样式保证可用性

目录结构（v3.2） kd-enterprise-info/ ├── SKILL.md # 技能说明文档 ├── README.md # 用户使用指南 ├── templates/ │ ├── report-css-v3.css # CSS 样式模板（可独立修改） │ └── report-html-v3.html # HTML 结构模板（88 个细粒度占位符） ├── scripts/ │ ├── html_generator.py # 生成器 v3.2（读取外部模板） │ └── enterprise_search.py # 搜索脚本（Tavily + Brave） ├── references/ │ └── search_patterns.md # 搜索规则参考 └── assets/ # 资源目录（预留）

模板定制 • 如需修改报告样式，直接编辑 templates/report-css-v3.css，无需修改生成器代码。 • 如需修改报告结构，编辑 templates/report-html-v3.html，88 个细粒度占位符对应各数据字段。

版本历史 v3.2 – 模板架构完善：CSS + HTML 模板完全分离，88 个细粒度占位符，新增 README 使用指南 v3.1 – 模板架构重构：CSS 样式拆分到独立文件 v3.0 – 统一 CSS 样式，完整数据维度（10 大板块） v2.0 – 支持 Tavily/Brave 双数据源，添加 HTML 解析，优化正则匹配 v1.0 – 初始版本