用途
OpenBusiness 是一个开源的 Python 命令行工具,用于商业模式研究。它接收公司名称、域名以及可选的股票代码,收集公开证据,运行基于 LangGraph 的分析师智能体,并生成一份 Markdown 格式的商业模式报告。它面向创始人、投资者、顾问、产品团队和研究人员,适合在深入尽调之前快速获得一份结构化的初步公司报告。
其核心产品原则是:明确已知内容,仅在证据支持时进行推断,并标记未知信息而非隐藏它。每条论断都会被标注为「已验证」「推断」或「缺失」,这一证据标签契约贯穿收集、分析、综合、压力测试和最终定稿全过程。
它受 TradingAgents 启发,但并非多空辩论系统;商业模式分析需要的是分解、证据追踪和假设压力测试,而不是买入或卖出的投票。
主要能力
- 基于 LangGraph 的多智能体商业分析流水线。
- 通过 Tavily 搜索、Firecrawl 抓取和 SEC EDGAR 进行证据收集。
- 输出商业模式画布,并显式标注证据标签:已验证、推断或缺失。
- 内置领域分析包:SaaS、上市公司、电商、AI 基础设施、消费应用、投资筛选和通用公司研究。
- 内置受众模板:标准分析、投资者备忘录、创始人模仿研究、竞争对手地图、市场研究和决策备忘录。
- 可复现的运行产物,包含阶段输出、来源提取和运行元数据。
- 通过
--language en和--language zh支持双语报告生成。 - 支持 OpenAI、Anthropic 和 DeepSeek 提供商。
- 本地配置向导,支持隐藏 API 密钥输入和 0600 配置文件权限。
- 当生成报告混合输出语言时给出语言纯度警告。
- 纯 Markdown 报告,可直接归档、编辑或分享。
使用方式
安装:pipx install openbusiness
一次性运行:uvx openbusiness analyze "Notion" --domain notion.so
安装程序会先让你选择英文或中文,检查 Python,必要时创建虚拟环境,以可编辑模式安装包,并以所选语言启动配置向导。首次语言选择会成为默认终端界面语言以及 openbusiness analyze 的默认报告语言,除非之后显式覆盖。
如果接受默认的 .venv 设置,安装程序会在安装会话中激活它。在每个新终端中运行 openbusiness 之前需要再次激活。如果拒绝创建虚拟环境,则跳过激活步骤,使用安装该包的 Python 环境。
配置或重新配置:安装程序通常会自动启动此向导。当跳过向导、在完成设置前切换终端或稍后需要更新密钥时,可手动运行。配置保存在 ~/.config/openbusiness/config.toml。
分析选项:openbusiness analyze 在启动时不会询问语言选择。终端界面语言来自安装或配置,报告语言跟随该界面语言,除非显式设置 --language、OPENBUSINESS_OUTPUT_LANGUAGE 或 openbusiness config --language。报告写入 output/notion_business_model.md。
环境变量会覆盖本地配置,适用于 CI、容器和临时切换提供商。界面语言优先级:openbusiness analyze --ui-language en > OPENBUSINESS_UI_LANGUAGE=en > 本地配置中的 ui_language = "en"。报告语言优先级:openbusiness analyze --language en > OPENBUSINESS_OUTPUT_LANGUAGE=en > 本地配置中的 output_language = "en"。
使用 --depth deep 可获得更严肃的研究过程:standard 保持证据收集有界以加快运行;deep 让证据收集器花费更多工具轮次并使用更广的搜索深度,用于客户证明、招聘信号、生态线索、竞争对手定位和负面证据。所有分析师节点仍使用相同的深度标准:主要结论必须包含机制、证据质量、反例、商业含义和验证数据。
每次运行保留可移植报告路径,并写入可复现的产物文件夹,包含运行元数据、证据、来源和阶段输出,便于调试、比较和改进。
适用场景
当你需要在深入尽调之前获得一份结构化的初步商业模式研究报告时,OpenBusiness 很有用。其 FAQ 中列出的相关关键词包括:商业模式研究 CLI、商业模式画布生成器、公司研究工具、竞争分析、单位经济学、LangGraph 智能体、证据标签报告。
限制与注意事项
- 关于私有公司:可以分析,但私有公司报告通常包含更多推断和缺失论断,因为私有公司不会发布完整财务数据、流失率、CAC、ARPU 或群组数据。OpenBusiness 的设计是展示这些缺口,而不是用编造的数字填充。
- 运行成本:报告在 API 调用上大约花费 0.10 至 0.40 美元,具体取决于提供商和证据包大小。包在 MIT 许可证下开源,需要自备 OpenAI、Anthropic、DeepSeek、Tavily 和 Firecrawl 密钥。
- 可选证据 API:如果未配置 Tavily 或 Firecrawl,流水线仍会运行,但更多论断会被标记为
[INFERRED]或[MISSING]。 - 语言纯度:英文报告若生成内容包含中文字符会给出警告;zh 报告若生成内容包含英文章节标题或类似英文的段落行也会警告。公司名称、URL、股票代码、指标缩写、API/工具名称、模型名称和证据标签会被有意保留。
- 自定义分析包和模板仅为提示指引:它们不能绕过证据标签,也不能将缺失数据变为已验证论断。
- 故障排查:
./install.sh: Permission denied、openbusiness: command not found、报告大多为推断、报告语言混合等问题在官方文档中有对应说明。
项目信息
- 仓库:https://github.com/wanikua/OpenBusiness
- PyPI 包:openbusiness 0.1.0
- 许可证:MIT License
- 提供静态网站 GUI 演示,位于
site-demo/,展示分析驾驶舱、证据标签计数器、LangGraph 流水线、报告预览、来源和运行产物。 - 贡献:可提交领域包、报告模板、证据连接器或更优的阶段提示;提交 PR 前请阅读 CONTRIBUTING.md,添加分析包、报告模板或证据工具时参考 docs/EXTENDING.md。