{"id":51026767,"url":"https://github.com/gitstq/stockmind","last_synced_at":"2026-06-21T20:02:19.598Z","repository":{"id":358915646,"uuid":"1243686054","full_name":"gitstq/stockmind","owner":"gitstq","description":"AI-Powered Stock Analysis CLI Tool - Technical Analysis meets AI Insights for A-shares, HK, and US stocks","archived":false,"fork":false,"pushed_at":"2026-05-19T15:12:13.000Z","size":22,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-19T18:41:46.097Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gitstq.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-19T15:09:51.000Z","updated_at":"2026-05-19T15:25:36.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/gitstq/stockmind","commit_stats":null,"previous_names":["gitstq/stockmind"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/gitstq/stockmind","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fstockmind","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fstockmind/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fstockmind/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fstockmind/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gitstq","download_url":"https://codeload.github.com/gitstq/stockmind/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gitstq%2Fstockmind/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34623906,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-21T02:00:05.568Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-21T20:02:18.775Z","updated_at":"2026-06-21T20:02:19.592Z","avatar_url":"https://github.com/gitstq.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📈 StockMind - AI驱动的股票分析CLI工具\n\n\u003cdiv align=\"center\"\u003e\n\n[![Python](https://img.shields.io/badge/Python-3.8%2B-blue.svg)](https://www.python.org/)\n[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![Platform](https://img.shields.io/badge/Platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)]()\n\n**简体中文** | [繁體中文](#繁體中文) | [English](#english)\n\n\u003c/div\u003e\n\n---\n\n## 🎉 项目介绍\n\n**StockMind** 是一款轻量级、智能化的股票分析CLI工具，专为投资者和交易者设计。它结合了传统技术分析指标与AI智能洞察，支持美股、港股和A股三大市场，帮助您做出更明智的投资决策。\n\n### 💡 灵感来源\n\n本项目灵感来源于 GitHub Trending 上的热门项目 [daily_stock_analysis](https://github.com/ZhuLinsen/daily_stock_analysis)，我们在此基础上进行了**完全独立自研开发**，专注于打造更轻量、更易用的命令行工具。\n\n### ✨ 自研差异化亮点\n\n- 🚀 **纯Python实现** - 单文件依赖（仅requests），零配置即可运行\n- 🌍 **多市场支持** - 美股、港股、A股全覆盖\n- 🤖 **AI智能分析** - 支持OpenAI、Anthropic、DeepSeek、GLM等多种LLM\n- 📊 **完整技术指标** - MA、RSI、MACD、布林带等经典指标\n- 💾 **智能缓存系统** - 本地缓存机制，减少API调用，提升响应速度\n- 🎨 **精美CLI界面** - 丰富的表情符号和格式化输出\n\n---\n\n## ✨ 核心特性\n\n### 📐 技术分析指标\n- **移动平均线 (MA)** - 支持SMA和EMA计算\n- **相对强弱指数 (RSI)** - 识别超买超卖信号\n- **MACD指标** - 趋势跟踪和动量分析\n- **布林带 (Bollinger Bands)** - 波动率分析和价格通道\n\n### 🤖 AI智能分析\n- 支持 **OpenAI GPT** 系列模型\n- 支持 **Anthropic Claude** 系列模型\n- 支持 **DeepSeek** 大模型\n- 支持 **智谱GLM** 系列模型\n\n### 🌍 多市场支持\n| 市场 | 代码示例 | 说明 |\n|------|---------|------|\n| 美股 | `AAPL`, `TSLA`, `MSFT` | 美国上市公司 |\n| 港股 | `0700.HK`, `9988.HK` | 香港交易所 |\n| A股 | `000001.SZ`, `600000.SS` | 沪深股市 |\n\n### 📊 实用功能\n- 🔍 **股票搜索** - 快速查找股票代码\n- 📈 **个股分析** - 完整的技术分析+AI洞察\n- 🔄 **多股对比** - 横向比较多只股票\n- ⭐ **自选股监控** - 实时监控关注股票\n- 🌍 **市场概览** - 全球主要指数行情\n\n---\n\n## 🚀 快速开始\n\n### 环境要求\n- **Python**: 3.8 或更高版本\n- **操作系统**: Windows / macOS / Linux\n\n### 安装步骤\n\n#### 方式一：通过 pip 安装（推荐）\n\n```bash\npip install stockmind\n```\n\n#### 方式二：从源码安装\n\n```bash\ngit clone https://github.com/gitstq/stockmind.git\ncd stockmind\npip install -e .\n```\n\n#### 方式三：直接运行（无需安装）\n\n```bash\ngit clone https://github.com/gitstq/stockmind.git\ncd stockmind\npip install -r requirements.txt\npython -m stockmind.cli analyze AAPL\n```\n\n### 配置AI分析（可选）\n\n如需使用AI分析功能，请设置环境变量：\n\n```bash\n# OpenAI\nexport OPENAI_API_KEY=\"your-openai-api-key\"\n\n# Anthropic Claude\nexport ANTHROPIC_API_KEY=\"your-anthropic-api-key\"\n\n# DeepSeek\nexport DEEPSEEK_API_KEY=\"your-deepseek-api-key\"\n\n# 智谱GLM\nexport GLM_API_KEY=\"your-glm-api-key\"\n\n# 设置默认AI提供商\nexport STOCKMIND_AI_PROVIDER=\"openai\"  # 可选: openai, anthropic, deepseek, glm\n```\n\n---\n\n## 📖 详细使用指南\n\n### 1️⃣ 分析单只股票\n\n```bash\n# 分析美股（默认）\nstockmind analyze AAPL\n\n# 分析港股\nstockmind analyze 0700.HK --market hk\n\n# 分析A股\nstockmind analyze 000001.SZ --market cn\n\n# 指定分析周期\nstockmind analyze AAPL --period 6mo  # 可选: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y\n\n# 禁用AI分析\nstockmind analyze AAPL --no-ai\n\n# 指定AI提供商\nstockmind analyze AAPL --ai-provider deepseek\n\n# 输出JSON格式\nstockmind analyze AAPL -o analysis.json\n```\n\n### 2️⃣ 搜索股票\n\n```bash\n# 搜索苹果相关股票\nstockmind search apple\n\n# 搜索腾讯\nstockmind search tencent\n```\n\n### 3️⃣ 查看市场概览\n\n```bash\n# 显示全球主要指数\nstockmind market\n```\n\n### 4️⃣ 多股对比\n\n```bash\n# 对比多只美股\nstockmind compare AAPL MSFT GOOGL\n\n# 对比港股\nstockmind compare 0700.HK 9988.HK --market hk\n\n# 指定分析周期\nstockmind compare AAPL TSLA NVDA --period 1mo\n```\n\n### 5️⃣ 自选股监控\n\n```bash\n# 监控多只股票\nstockmind watchlist AAPL MSFT TSLA\n\n# 监控港股\nstockmind watchlist 0700.HK 9988.HK --market hk\n```\n\n---\n\n## 💡 设计思路与迭代规划\n\n### 🎯 设计理念\n\nStockMind 的设计理念是**\"简洁而不简单\"**。我们相信，优秀的工具应该：\n- ✅ 开箱即用，无需复杂配置\n- ✅ 功能专注，解决核心问题\n- ✅ 输出清晰，一目了然\n- ✅ 扩展灵活，支持个性化需求\n\n### 🔧 技术选型原因\n\n| 技术 | 选型原因 |\n|------|---------|\n| **Python** | 生态丰富，金融分析库完善 |\n| **Yahoo Finance API** | 免费、稳定、覆盖全球市场 |\n| **Requests** | 轻量级HTTP库，满足基本需求 |\n| **多LLM支持** | 给用户更多选择，避免 vendor lock-in |\n\n### 📅 后续迭代计划\n\n#### v1.1.0（计划中）\n- [ ] 支持更多技术指标（KDJ、CCI、威廉指标）\n- [ ] 添加图表生成功能\n- [ ] 支持自定义扫描策略\n\n#### v1.2.0（计划中）\n- [ ] 添加回测功能\n- [ ] 支持邮件/微信推送\n- [ ] 添加投资组合分析\n\n#### v2.0.0（远期规划）\n- [ ] Web界面版本\n- [ ] 实时数据流支持\n- [ ] 机器学习预测模型\n\n### 🤝 社区贡献方向\n\n我们欢迎以下方面的贡献：\n- 🐛 **Bug修复** - 报告和修复问题\n- ✨ **新功能** - 添加新的技术指标或数据源\n- 🌍 **本地化** - 添加更多语言支持\n- 📚 **文档** - 完善使用文档和教程\n\n---\n\n## 📦 打包与部署\n\n### 打包为可执行文件\n\n#### 使用 PyInstaller\n\n```bash\n# 安装 PyInstaller\npip install pyinstaller\n\n# 打包为单文件可执行程序\npyinstaller --onefile --name stockmind stockmind/cli.py\n\n# 打包后的文件位于 dist/ 目录\ndist/stockmind\n```\n\n#### 使用 cx_Freeze\n\n```bash\n# 安装 cx_Freeze\npip install cx_freeze\n\n# 创建 setup.py 构建配置\npython setup.py build\n\n# 打包后的文件位于 build/ 目录\n```\n\n### 发布到 PyPI\n\n```bash\n# 安装构建工具\npip install build twine\n\n# 构建包\npython -m build\n\n# 上传到 PyPI\npython -m twine upload dist/*\n```\n\n---\n\n## 🤝 贡献指南\n\n### 提交PR\n\n1. Fork 本仓库\n2. 创建特性分支 (`git checkout -b feature/amazing-feature`)\n3. 提交更改 (`git commit -m 'feat: add amazing feature'`)\n4. 推送到分支 (`git push origin feature/amazing-feature`)\n5. 创建 Pull Request\n\n### 提交规范\n\n我们使用 [Conventional Commits](https://www.conventionalcommits.org/) 规范：\n\n- `feat:` 新功能\n- `fix:` Bug修复\n- `docs:` 文档更新\n- `style:` 代码格式调整\n- `refactor:` 代码重构\n- `test:` 测试相关\n- `chore:` 构建/工具相关\n\n### Issue反馈\n\n提交Issue时请包含：\n- 问题描述\n- 复现步骤\n- 期望行为\n- 实际行为\n- 环境信息（Python版本、操作系统）\n\n---\n\n## 📄 开源协议\n\n本项目采用 [MIT License](LICENSE) 开源协议。\n\n```\nMIT License\n\nCopyright (c) 2025 StockMind Team\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n```\n\n---\n\n## ⚠️ 免责声明\n\n**投资有风险，入市需谨慎。**\n\nStockMind 提供的分析结果仅供参考，不构成任何投资建议。投资者应根据自身情况独立做出投资决策，并自行承担投资风险。\n\n- 历史数据不代表未来表现\n- 技术分析存在局限性\n- AI分析可能存在偏差\n- 请理性投资，量力而行\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Made with ❤️ by StockMind Team**\n\n⭐ 如果这个项目对您有帮助，请给我们一个 Star！\n\n\u003c/div\u003e\n\n---\n\n# 繁體中文\n\n## 🎉 項目介紹\n\n**StockMind** 是一款輕量級、智能化的股票分析CLI工具，專為投資者和交易者設計。它結合了傳統技術分析指標與AI智能洞察，支持美股、港股和A股三大市場。\n\n### ✨ 核心特性\n\n- 📐 **完整技術指標** - MA、RSI、MACD、布林帶\n- 🤖 **AI智能分析** - 支持多種LLM提供商\n- 🌍 **多市場支持** - 美股、港股、A股\n- 💾 **智能緩存** - 提升響應速度\n- 🎨 **精美界面** - 豐富的表情符號\n\n### 🚀 快速開始\n\n```bash\n# 安裝\npip install stockmind\n\n# 分析股票\nstockmind analyze AAPL\n\n# 搜索股票\nstockmind search apple\n\n# 市場概覽\nstockmind market\n```\n\n---\n\n# English\n\n## 🎉 Introduction\n\n**StockMind** is a lightweight, intelligent stock analysis CLI tool designed for investors and traders. It combines traditional technical analysis indicators with AI-powered insights, supporting US, Hong Kong, and China A-share markets.\n\n### ✨ Key Features\n\n- 📐 **Complete Technical Indicators** - MA, RSI, MACD, Bollinger Bands\n- 🤖 **AI-Powered Analysis** - Multiple LLM provider support\n- 🌍 **Multi-Market Support** - US, HK, China A-shares\n- 💾 **Smart Caching** - Improved response speed\n- 🎨 **Beautiful Interface** - Rich emoji and formatting\n\n### 🚀 Quick Start\n\n```bash\n# Install\npip install stockmind\n\n# Analyze stock\nstockmind analyze AAPL\n\n# Search stocks\nstockmind search apple\n\n# Market overview\nstockmind market\n```\n\n### 📊 Supported Markets\n\n| Market | Examples | Description |\n|--------|----------|-------------|\n| US | `AAPL`, `TSLA`, `MSFT` | US Listed Companies |\n| HK | `0700.HK`, `9988.HK` | Hong Kong Exchange |\n| CN | `000001.SZ`, `600000.SS` | Shanghai/Shenzhen |\n\n### 🤖 AI Providers\n\n- OpenAI GPT series\n- Anthropic Claude series\n- DeepSeek\n- Zhipu GLM series\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**[⬆ Back to Top](#-stockmind---ai驱动的股票分析cli工具)**\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fstockmind","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgitstq%2Fstockmind","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgitstq%2Fstockmind/lists"}