mcpField
S
stock-research-group

stock-research-group

github.com/kirkluokunData & databases6664 installsUpdated 32w ago
Repository

About stock-research-group

A stock-research skillset for financial data lookup, analysis, and report processing. It includes date-aware data refreshes and modules for earnings alerts, broker reports, financial statements, technical factors, and more.

Key features

  1. 01Compares actual results with broker forecasts
  2. 02Searches and parses broker research reports
  3. 03Tracks monthly broker stock picks
  4. 04Retrieves company and institution research records
  5. 05Queries financial statements and indicators
  6. 06Refreshes registered data sources by date

Use cases

  1. 01Flagging earnings that differ from forecasts
  2. 02Extracting views from broker report PDFs
  3. 03Reviewing monthly broker recommendations
  4. 04Inspecting financial statements or technical factors

Install

Copy the command and run it in a terminal.

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

After installing, type/stock-research-groupin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with 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

Details

From the project 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 积分。

操作约定

用户偏好：

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

Comments

Markdown supported