B2B客户深度背调报告生成器

概述

为外贸企业生成海外B2B客户的深度背调报告。报告采用7步分析框架，输出为专业排版Word文档，包含中英双语内容、彩色表格、痛点评级和供应商匹配度分析。

触发场景：

• 用户要求对某个海外客户/公司做"背调"、"背景调查"、"深度调研"
• 用户提供客户网站或公司名，要求分析其业务
• 用户要求生成客户调研/背调报告
• 用户提到"深度背调"、"客户调研"
• 用户需要开发海外B2B客户前的市场调研

用户公司配置

本技能支持用户自定义公司信息，用于报告中的"供应商匹配度分析"章节。

首次使用时，需在 assets/user_profile.json 中填写用户公司信息。如未配置，报告将跳过匹配度分析章节，仅输出前6步通用分析。

配置方法：

1. 复制 assets/user_profile.example.json 为 assets/user_profile.json
2. 填写公司名称、主营产品、核心优势等信息
3. 后续每次生成报告将自动读取配置

工作流程

Step 1: 信息收集（WebSearch + WebFetch）

用户会提供目标客户的公司名或网站。执行以下搜索：

1. 公司基础信息搜索（3-5组关键词）
• "{公司名} company profile revenue employees"
• "{公司名} owner CEO founder leadership team"
• "{公司名} revenue employees {当前年份} {上一年份}"
• "{公司名} about us company history founded"

1. 产品线与供应链搜索（2-3组）
• 访问目标客户网站，抓取产品分类、品牌、价格
• "{公司名} brands products models categories"

1. 市场竞争搜索（2-3组）
• "{公司名} competitor market {行业关键词}"
• "{行业} market size growth CAGR {当前年份}"

1. 财务与风险搜索（2-3组）
• "{公司名} revenue growth funding valuation"
• "{公司名} tariff import regulation compliance"
• "{公司名} lawsuit legal issue litigation"

1. 口碑与ESG搜索（2-3组）
• "{公司名} review complaints BBB Trustpilot"
• "{公司名} sustainability ESG certification"
• "{公司名} employee review Glassdoor Indeed"

1. WebFetch抓取关键页面
• About Us页面
• 主要产品分类页面
• 品牌页面
• 新闻/PR页面（如有）

重要： 将搜索结果整理成结构化笔记，作为后续报告的数据源。

Step 2: 框架分析

按7步框架整理数据：

Step 3: 生成Word报告

运行 scripts/generate_report.py 生成报告。脚本接受JSON数据文件作为输入。

python scripts/generate_report.py --data <json_data_file> --output <output_path>

可选参数：

• --profile — 用户公司配置文件路径（默认读取 assets/user_profile.json）
• --lang zh|en|bilingual — 报告语言（默认 bilingual 中英双语）

如果脚本执行失败（依赖缺失等），则用Python直接内联生成报告，参考 references/report_template.py 中的样式和结构。

报告样式规范

Step 4: 供应商匹配度分析（需用户配置）

如用户已配置 assets/user_profile.json，报告最后将包含"供应商 vs {客户名} 匹配度分析"章节：

• 产品匹配矩阵：逐品类对比用户可供应情况
• 综合匹配度评估：产品/规模/痛点/竞争/难度5维度打星
• 切入优先级排序：第一优先→第四优先

如未配置，报告跳过此章节，仅输出通用6步分析。

Step 5: 追加英文附录 + 数据来源

• 英文Summary表（公司背景 + 痛点 + 推荐策略）
• 数据来源表（序号 + 检索关键词 + 数据来源 + 关键发现 + 数据时效）
• 报告声明（数据来源、推断标注、建议验证步骤、数据时效说明）

动态数据更新机制

为确保报告数据的时效性，搜索时必须遵守以下规则：

1. 年份标记：所有搜索关键词必须包含当前年份或上一年份，确保获取最新数据
2. 时效标注：报告中每个数据点必须标注获取日期（格式：YYYY-MM-DD）
3. 多源验证：关键数据（营收、市场份额等）必须至少2个独立来源交叉验证
4. 趋势追踪：对核心指标（营收、员工数、产品线数量）记录历年变化趋势
5. 政策时效：关税/合规/法规类信息必须注明生效日期和有效期
6. 下次更新建议：报告末尾标注建议下次更新的时间（默认3个月后）

输出规范

1. 文件格式： Word (.docx)
2. 保存位置： 用户桌面
3. 文件命名： {国家}客户背调报告_{客户域名}.docx
4. 报告长度： 通常15-30页
5. 双语要求： 正文中文，附录英文Summary
6. 数据时效： 每个数据表附"数据截止日期"行

注意事项

• 所有推断内容必须标注"推测"并附依据
• 营收数据需注明来源平台（如RocketReach/Growjo/Owler），多源数据需做交叉验证
• 口碑数据需引用具体平台和评分
• 关税/政策信息需注明时效性
• 法律/合规信息需标注"非法律意见，仅供参考"
• 不在首次沟通话术中提及客户的差评（避坑原则）
• 报告中不得存储任何用户公司信息——所有用户数据通过配置文件传入

资源文件说明

scripts/generate_report.py

核心报告生成脚本。接受JSON数据文件，输出Word文档。

包含完整的样式定义、表格生成、章节组织逻辑。

支持 --profile 参数传入用户公司配置。

references/report_template.py

报告模板参考。包含完整的Python-docx样式代码，可直接复制修改用于新客户的报告生成。

当generate_report.py不适合时，可基于此模板快速生成。

references/diligence_framework.md

7步背调框架的详细说明，包含每步的检查清单、搜索关键词和数据需求。

assets/user_profile.example.json

用户公司信息配置模板。首次使用需复制为 user_profile.json 并填写。

assets/user_profile.json

用户实际配置文件（不入版本控制）。包含公司名称、主营产品、核心优势等信息，用于匹配度分析。