SuperAPI AI 工具集

cninfo-to-notebooklm

数据与分析

查看项目

更新于 10-15 17:08

技能介绍

用途

cninfo-to-notebooklm 用于下载中国 A 股和港股上市公司的年度报告与定期报告(来源为 cninfo.com.cn),并将这些 PDF 上传到 NotebookLM,借助专门的“财务分析师”人设进行 AI 驱动的分析。

适用时机

  • 用户提供中国股票名称或代码(A 股或港股)
  • 用户想分析某公司的财务报告
  • 用户要求“下载报告”或“研究”某只中国股票
  • 用户想把股票报告上传到 NotebookLM

支持的市场

  • A 股:6 位代码(0xxxxx、3xxxxx、6xxxxx),例如 600519(贵州茅台)、000001(平安银行)
  • 港股:5 位代码(00xxx、01xxx、02xxx、09xxx),例如 00700(腾讯控股)、09988(阿里巴巴)

核心工作流

用户提供股票名称/代码 → 1. 在数据库中查询股票(自动识别市场)→ 2. 从 cninfo 下载报告(近 5 年年度报告;当年一季报、半年报、三季报)→ 3. 创建 NotebookLM 笔记本 → 4. 配置“财务分析师”人设及自定义提示词 → 5. 上传全部 PDF 作为来源 → 6. 返回笔记本 ID。

使用方式

第 0 步:环境准备(仅首次运行)

运行脚本前需确认环境就绪:

  • 检查依赖:确认是否已安装依赖(特别是 notebooklm 和 playwright)。
  • 安装:若依赖缺失或为首次运行,执行安装脚本:
chmod +x install.sh && ./install.sh
  • 认证:确保用户已通过 NotebookLM 认证(notebooklm login)。若未认证,请用户先完成认证。

第 1 步:运行主编排脚本

在技能目录下运行:

python3 scripts/run.py <stock_code_or_name>

示例:

python3 scripts/run.py 600350   # A 股
python3 scripts/run.py 山东高速  # A 股(按名称)
python3 scripts/run.py 00700    # 港股(腾讯)
python3 scripts/run.py 腾讯控股  # 港股(按名称)

该脚本会处理全部流程:将报告下载到临时目录、创建 NotebookLM 笔记本、使用 assets/financial_analyst_prompt.txt 配置笔记本、上传全部 PDF、清理临时文件。

第 2 步:向用户报告

提供以下信息:

  • ✅ 下载并上传的报告数量
  • 📚 NotebookLM 笔记本 ID
  • 📊 市场类型(A 股或港股)
  • 💡 提醒用户该笔记本已创建“财务分析师”人设,可用于深度分析

配置

该技能使用位于 assets/financial_analyst_prompt.txt 的自定义系统提示词。该提示词基于“手把手财报”方法论,将 NotebookLM 配置为“财务报告分析师”。

错误处理

  • 股票未找到:检查代码是否为有效的 A 股或港股
  • 未找到 NotebookLM CLI:确保 notebooklm-py 与 requirements.txt 匹配且在 PATH 中
  • 缺少认证:运行 notebooklm login 通过浏览器认证
  • 上传失败:检查网络连接和 NotebookLM 服务状态

依赖

  • Python 3.8+
  • httpx 包
  • notebooklm-py 包
  • playwright(用于认证)

快速参考

A 股报告类型

  • 年度报告:category_ndbg_szsh,近 5 年
  • 半年报:category_bndbg_szsh,当年
  • 一季报:category_yjdbg_szsh,当年
  • 三季报:category_sjdbg_szsh,当年

港股与 A 股差异

  • 市场代码:A 股为 szse,港股为 hke
  • 分类:A 股使用分类代码,港股分类为空
  • 搜索关键词:A 股使用中文搜索词,港股搜索关键词为空
  • 报告命名:A 股为 YYYY年年度报告,港股可能使用阿拉伯数字或中文数字
  • 搜索周期:A 股为次年(3 月至 6 月),港股为当年或次年

限制

资料未提供关于收费、价格、平台兼容性、分析效果或具体使用步骤之外的更多信息,暂未提供。