Metadata-Version: 2.4
Name: fin-agent
Version: 0.1.6
Summary: A financial analysis agent powered by DeepSeek and Tushare
Author: Fin Agent Team
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: tushare>=1.2.89
Requires-Dist: openai>=1.0.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: pandas>=2.0.0
Requires-Dist: requests>=2.31.0
Requires-Dist: colorama>=0.4.6
Dynamic: author
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Fin-Agent: 智能金融分析助手

Fin-Agent 是一个基于 **DeepSeek** 大模型和 **Tushare** 金融数据的智能金融分析代理。它能够通过自然语言交互，帮助用户查询股票行情、分析财务数据、获取市场指标，并提供投资参考建议。

## ✨ 主要功能

- **自然语言交互**：直接使用中文与 AI 对话，无需记忆复杂的命令或代码。
- **智能诊断**：结合 LLM 的分析能力，对获取的数据进行解读和总结。
- **全面的 Tushare 支持**：覆盖个股、大盘、资金、财务、热点等全方位数据。

## 📦 安装

```bash
pip install fin-agent
```

## 🚀 快速开始

安装完成后，直接在终端运行以下命令启动：

```bash
fin-agent
```

首次运行会自动引导您配置 API Key。

## ⚙️ 配置说明

Fin-Agent 需要以下两个 API 密钥才能正常工作：

1.  **Tushare Token**: 用于获取金融数据 ([注册 Tushare](https://tushare.pro/))
2.  **DeepSeek API Key**: 用于驱动智能对话 ([注册 DeepSeek](https://www.deepseek.com/))

### 自动配置
首次运行程序时，如果没有检测到配置文件，Fin-Agent 会自动进入设置向导，引导您输入 API 密钥。配置将自动保存到您的用户目录下。

## 💬 场景示例

Fin-Agent 支持丰富的金融分析场景，您可以参考以下对话来探索它的能力：

### 1. 基础信息查询 (`get_stock_basic`)
> **用户**："平安银行属于什么行业？什么时候上市的？"
> **Agent**："平安银行（000001.SZ）属于银行行业，上市日期为 19910403。它是深圳本地的股份制商业银行..."

### 2. 实时行情与走势 (`get_realtime_price`, `get_daily_price`)
> **用户**："现在的贵州茅台股价是多少？最近一周走势如何？"
> **Agent**："贵州茅台当前价格为 1750.00 元，今日下跌 0.5%。回顾过去一周（20240101-20240107），股价整体呈现震荡上行趋势，最高触及 1780 元..."

### 3. 大盘指数分析 (`get_index_daily`)
> **用户**："今天大盘（上证指数）表现怎么样？"
> **Agent**："今日上证指数收于 3050 点，上涨 0.8%，成交量较昨日有所放大，市场情绪回暖..."

### 4. 估值与基本面 (`get_daily_basic`)
> **用户**："帮我看看万科A现在的估值高吗？"
> **Agent**："万科A当前的市盈率（PE）为 6.5 倍，市净率（PB）为 0.6 倍。与历史水平及同行业相比，当前估值处于较低位置..."

### 5. 财务业绩分析 (`get_income_statement`)
> **用户**："宁德时代去年的营收和净利润是多少？"
> **Agent**："根据 2023 年年报，宁德时代实现营业收入 4009 亿元，同比增长 22%；净利润 441 亿元，同比增长 43%..."

### 6. 业绩预告筛选 (`get_forecast`)
> **用户**："最近有哪些公司发布了业绩预增公告？"
> **Agent**："为您查询到近期发布业绩预告的公司中，有以下几家业绩大幅预增：比亚迪（预计增长 60%）、立讯精密..."

### 7. 资金流向监测 (`get_moneyflow`)
> **用户**："今天中信证券的主力资金是流入还是流出？"
> **Agent**："今日中信证券主力资金（大单+特大单）净流出 2.5 亿元，其中特大单流出 1.8 亿元，显示机构资金有撤退迹象..."

### 8. 北向资金动向 (`get_hsgt_top10`)
> **用户**："今天外资（北向资金）都在买什么？"
> **Agent**："今日沪深港通十大成交活跃股中，外资净买入前三名分别为：贵州茅台（+5亿）、美的集团（+3亿）、招商银行（+2亿）..."

### 9. 涨跌停分析 (`get_limit_list`)
> **用户**："今天有哪些股票涨停了？是什么原因？"
> **Agent**："今日共有 45 只股票涨停。其中华为概念股表现强势，赛力斯、欧菲光等多只个股涨停..."

### 10. 龙虎榜追踪 (`get_top_list`)
> **用户**："查一下今天龙虎榜的情况，有没有机构大举买入的票？"
> **Agent**："今日龙虎榜数据显示，机构席位净买入最多的个股是中科曙光，净买入金额达 3 亿元..."

### 11. 概念板块挖掘 (`get_concept_detail`)
> **用户**："列出几只Sora概念股。"
> **Agent**："Sora（文生视频）概念股主要包括：因赛集团、万兴科技、中广天择等。其中因赛集团近期关注度较高..."


## 📊 数据来源

*   **金融数据**: [Tushare Pro](https://tushare.pro/) - 专业免费的财经数据接口包。
*   **大模型**: [DeepSeek](https://www.deepseek.com/) - 深度求索开源大模型。

## 📝 许可证

本项目采用 [MIT License](LICENSE) 开源许可证。
