stock-analysis  by mingli30119

Automated stock fundamental analysis and deep research report generation

Created 3 weeks ago

New!

472 stars

Top 64.0% on SourcePulse

GitHubView on GitHub
Project Summary

Summary This project offers an automated system for in-depth fundamental analysis of A-share stocks, designed to generate professional, interactive HTML research reports. It targets individual investors, researchers, and power users who require a structured and comprehensive approach to evaluating stock fundamentals, providing a significant benefit by automating data collection and analysis into a digestible format.

How It Works The system leverages the akshare library to automatically fetch diverse stock data, including historical K-lines, financial statements, and news. Its core innovation is an 8-step analytical framework that systematically covers macro positioning, industry chain decomposition, quality scoring (across 5 dimensions), performance elasticity forecasting, risk assessment, valuation, peer benchmarking, and ongoing tracking. This structured approach is advantageous for ensuring a thorough, multi-faceted analysis. The final output is a professional HTML report, dynamically rendered with ECharts for interactive visualizations and dual-theme support, alongside a Markdown version.

Quick Start & Requirements Installation is straightforward: pip install -r requirements.txt. The recommended execution method is via Claude Code Skill, where natural language prompts like "分析 600519 股票" trigger a three-phase automated process: data acquisition, AI-driven analysis (MD report), and HTML visualization generation. For users needing only data collection, manual execution via python stock_full_report.py <stock_code> is supported, producing a JSON data file. No specific hardware or OS prerequisites beyond a Python environment are detailed.

Highlighted Details

  • Comprehensive 8-Step Analysis: Covers macro, industry, quality, elasticity, risk, valuation, benchmarking, and tracking.
  • Professional HTML Reports: Features dual-theme (dark/light) switching, responsive design, and interactive ECharts (v5.5.1) visualizations for K-lines, industry chains (SVG), financial metrics, and scoring.
  • Interactive Components: Includes navigation scrolling, smooth scrolling, theme-based chart redrawing, and a hero card with key metrics.
  • Data Sources: Utilizes akshare for stock data, financial abstracts, and news, with potential for local knowledge bases.

Maintenance & Community The project is primarily developed and maintained by @mingli30119. Community engagement is centered around the GitHub repository. No dedicated community channels like Discord or Slack are listed.

Licensing & Compatibility The project is distributed under the MIT License. This license is highly permissive, allowing for commercial use and integration into proprietary or closed-source software without significant restrictions.

Limitations & Caveats A crucial disclaimer states the tool is for learning and research only and does not constitute investment advice. Furthermore, manual script execution is limited to data acquisition; the full analysis and HTML report generation are exclusive to the Claude Code Skill invocation.

Health Check
Last Commit

2 weeks ago

Responsiveness

Inactive

Pull Requests (30d)
1
Issues (30d)
3
Star History
473 stars in the last 24 days

Explore Similar Projects

Feedback? Help us improve.