📊 智能股票代码API

基于宏观经济分析和AI智能推荐的股票代码获取API服务。

🎯 项目简介

这是一个智能化的股票代码获取API，结合了：

• 宏观经济数据分析 - 通过Tushare获取实时经济指标
• AI智能推荐 - 使用DeepSeek AI分析经济环境并推荐行业
• 股票代码获取 - 自动获取推荐行业的股票代码列表
• Docker容器化 - 支持一键部署到任何环境

🚀 快速开始

1. 克隆项目

git clone <your-repository-url>
cd stock-codes-api

2. 一键部署

# 运行部署脚本
./deploy.sh

3. 配置API密钥

编辑 .env 文件，填入你的API密钥：

TUSHARE_TOKEN=your_actual_tushare_token
DEEPSEEK_API_KEY=your_actual_deepseek_key

4. 重新部署

./deploy.sh

📋 API接口

简化股票代码接口

接口	方法	描述	返回格式
/stock-codes/recommended	GET	获取推荐行业股票代码	{"stock_codes": ["000001.SZ", ...]}
/stock-codes/{industry}	GET	获取指定行业股票代码	{"stock_codes": ["000001.SZ", ...]}
/stock-codes/all	GET	获取所有股票代码	{"stock_codes": ["000001.SZ", ...]}
/industries	GET	获取行业列表	{"industries": ["银行", "电子", ...]}

完整投资推荐接口

接口	方法	描述
/recommend	POST	获取完整投资推荐
/recommend	GET	获取最新推荐结果
/macro-data	GET	获取宏观经济数据

💻 使用示例

Python示例

import requests

# 获取推荐股票代码
response = requests.get("http://localhost:8000/stock-codes/recommended")
stock_codes = response.json()["stock_codes"]
print(f"推荐股票: {stock_codes}")

# 获取银行行业股票代码
response = requests.get("http://localhost:8000/stock-codes/银行")
bank_stocks = response.json()["stock_codes"]
print(f"银行股票: {bank_stocks}")

JavaScript示例

// 获取推荐股票代码
fetch('http://localhost:8000/stock-codes/recommended')
  .then(response => response.json())
  .then(data => {
    console.log('推荐股票代码:', data.stock_codes);
  });

cURL示例

# 获取推荐股票代码
curl http://localhost:8000/stock-codes/recommended

# 获取银行行业股票代码
curl http://localhost:8000/stock-codes/银行

🏗️ 项目结构

stock-codes-api/
├── web_api.py                 # Web API服务
├── investment_agent_enhanced.py  # 智能投资推荐Agent
├── investment_agent.py         # 基础投资推荐Agent
├── docker-compose-simple.yml  # Docker部署配置
├── deploy.sh                  # 一键部署脚本
├── requirements.txt           # Python依赖
├── Dockerfile                 # Docker镜像配置
├── .env                       # 环境变量配置
├── README.md                  # 项目主页
├── README_DEPLOY.md          # 部署指南
├── README_stock_codes_api.md # API使用指南
├── stock_codes_example.py    # 使用示例
└── config.py                 # 配置文件

🛠️ 技术栈

• 后端框架: FastAPI
• AI模型: DeepSeek Chat
• 数据源: Tushare Pro
• 容器化: Docker + Docker Compose
• 编程语言: Python 3.8+

📊 功能特性

✅ 已实现功能

• 宏观经济数据获取 (CPI, PMI, GDP, SHIBOR)
• AI智能行业推荐
• 股票代码自动获取
• 简化API接口
• Docker容器化部署
• 一键部署脚本
• 健康检查接口
• API文档自动生成
• 错误处理和日志
• 环境变量配置

🔄 计划功能

• Redis缓存支持
• Nginx反向代理
• HTTPS支持
• 用户认证
• 请求限流
• 监控告警
• 数据持久化

🚀 部署方式

1. Docker部署（推荐）

# 一键部署
./deploy.sh

# 手动部署
docker-compose -f docker-compose-simple.yml up -d

2. 本地部署

# 安装依赖
pip install -r requirements.txt

# 配置环境变量
cp env_template.txt .env
# 编辑.env文件

# 启动服务
python web_api.py

📈 性能指标

• 响应时间: < 5秒（推荐接口）
• 并发支持: 100+ 并发请求
• 数据准确性: 基于Tushare实时数据
• 服务可用性: 99.9%+

🔧 管理命令

# 查看服务状态
docker-compose -f docker-compose-simple.yml ps

# 查看日志
docker-compose -f docker-compose-simple.yml logs -f

# 重启服务
docker-compose -f docker-compose-simple.yml restart

# 停止服务
docker-compose -f docker-compose-simple.yml down

🔍 故障排除

常见问题

1. API密钥错误

   # 检查环境变量
   docker exec stock-api env | grep -E "(TUSHARE|DEEPSEEK)"

2. 服务启动失败

   # 查看详细日志
   docker-compose -f docker-compose-simple.yml logs

3. 网络连接问题

   # 检查容器网络
   docker network ls

📞 获取帮助

• API文档: http://localhost:8000/docs
• 健康检查: http://localhost:8000/health
• 部署指南: README_DEPLOY.md
• API使用指南: README_stock_codes_api.md

🤝 贡献指南

1. Fork 项目
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 打开 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

🙏 致谢

• Tushare Pro - 提供股票数据
• DeepSeek - 提供AI分析服务
• FastAPI - Web框架
• Docker - 容器化平台

📞 联系方式

• 项目主页: GitHub Repository
• 问题反馈: [Issues](/issues)
• 功能建议: [Discussions](/discussions)

---

⭐ 如果这个项目对你有帮助，请给它一个星标！