mcpField
S
stock-research-group

stock-research-group

github.com/kirkluokun数据与数据库6664 次安装32 周前更新
代码仓库

关于 stock-research-group

用于查询、分析金融数据和处理研报的股票研究技能集。它按日期自适应刷新数据，并涵盖业绩告警、券商研报、财务报表、技术因子等模块。

主要功能

  1. 01比较实际业绩与券商预测
  2. 02搜索并解析券商研报
  3. 03统计券商月度金股
  4. 04检索公司及机构调研记录
  5. 05查询财务报表与指标
  6. 06按日期刷新已注册数据源

适用场景

  1. 01标记业绩与预测的偏差
  2. 02提取券商研报 PDF 中的观点
  3. 03查看券商月度推荐股票
  4. 04检查财务报表或技术因子

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/kirkluokun/awesome-a-stock-openclawskills --skill stock-research-group

安装后在 Claude Code 中输入/stock-research-group确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

analyzers/
__init__.py
analyzers/balancesheet/
pipeline.py
schema.sql
search.py
analyzers/balancesheet/_shared/
db.py
analyzers/broker_recommend/
__init__.py
pipeline.py
schema.sql
stats.py
analyzers/broker_recommend/_shared/
__init__.py
db.py
analyzers/cashflow/
pipeline.py
schema.sql
search.py
analyzers/cashflow/_shared/
db.py
analyzers/earnings/
__init__.py
compare.py
db.py
ingest.py
pipeline.py
schema.sql
simulate.py
analyzers/earnings/_shared/
__init__.py
sim_runner.py
analyzers/fina_indicator/
pipeline.py
schema.sql
search.py
test_search.py
analyzers/fina_indicator/_shared/
db.py
analyzers/fina_mainbz/_shared/
db.py

详细介绍

来自项目 README

Stock Research Group

股票研究工具集：业绩预期对比告警、券商研报搜索下载与 AI 解析、券商月度金股统计、机构调研检索、资产负债表查询与分析。

数据源

接口说明拉取方式
forecast_vip业绩预告period 按报告期全量
express_vip业绩快报period 按报告期全量
income_vip正式业绩period 按报告期全量
report_rc券商盈利预测start_date + end_date 按日期范围（支持分页）

Period 自适应规则

ingest.py 根据当前日期自动计算 period，无需手动指定：

时间窗口自动拉取的 period说明
1月1日 - 4月30日上年1231 + 当年0331年报 + Q1 披露季
5月1日 - 8月31日当年0630中报披露季
9月1日 - 10月31日当年0930Q3 披露季
11月1日 - 12月31日当年1231年报预披露期

示例：2026年2月3日自动拉取 20251231 + 20260331

模块索引

域模块关键词说明参考文档
财务分析业绩监控业绩预告/快报/超预期/符合预期实际业绩 vs 券商预测，生成告警modules/fundamental/earnings.md
财务分析资产负债表资产负债表/资产拉取查询资产负债表数据modules/fundamental/balancesheet.md
财务分析财务指标财务指标/ROE/ROA拉取查询财务指标数据modules/fundamental/fina_indicator.md
财务分析现金流量表现金流量表/现金流拉取查询现金流量表数据modules/fundamental/cashflow.md
财务分析主营业务构成主营业务/产品构成/地区构成按产品/地区/行业拆分主营收入modules/fundamental/fina_mainbz.md
通用数据券商研报研报/解析/PDF搜索下载+Gemini提取观点modules/data/research_report.md
通用数据券商金股金股/月度金股拉取统计券商月度金股modules/data/broker_recommend.md
通用数据机构调研机构调研/调研按公司/机构/人员检索调研modules/data/stk_surv.md
技术分析技术面因子技术面因子/MACD/KDJ/RSI/布林带/均线日频261维因子，含前复权/后复权/不复权modules/technical/stk_factor_pro.md
技术分析神奇九转神奇九转/九转序列/抄底/逃顶TD序列反转信号，日线+60minmodules/technical/stk_nineturn.md
舆情分析—新闻/舆情/股吧TODOmodules/sentiment/_index.md

全量数据刷新

full_sync.py 一次性拉取所有数据源并更新数据库。Period 自动计算，日志保存到 logs/full_sync_YYYYMMDD_HHMMSS.log。

cd stock-research-group

# 执行全量刷新（自动计算 period）
python full_sync.py

# 指定基准日期
python full_sync.py --date 20260208

# 预览步骤（不执行）
python full_sync.py --dry-run

步骤由 sync_registry.json 注册表驱动，新增模块只需在注册表追加条目，设 enabled: false 可跳过。

单步失败不阻塞后续执行，末尾输出汇总（成功/失败数、耗时）。VIP 步骤需 5000 积分。

操作约定

用户偏好：

  • 当用户要求"读研报/读一下/解析"时，直接执行下载与解析流程，无需再次征求审批。

评论

支持 Markdown