CrewAI 多 Agent 辩论 + A 股恐惧与贪婪指数｜股票分析 CLI / CrewAI Multi‑Agent + Fear & Greed Stock CLI (China A‑shares)

一句话 / One‑liner：基于 CrewAI 的多 Agent 架构（Bull/Bear/Hold/Judge）+ “Fear & Greed（代理）” 市场情绪快照，输出可直接接入工作流的结构化 JSON。

亮点 / Highlights

• CrewAI 多 Agent 辩论：Bull / Bear / Hold / Judge
• A 股市场情绪快照：Fear & Greed（proxy，非官方指数）
• 结构化输出：JSON 结果可直接接入自动化/工作流
• 双语界面：中英文 --lang zh|en
• 漂亮的终端输出：rich（可选，未安装也能跑）

中文 / English

• 中文介绍
• English Overview

---

中文介绍

这是一个命令行小工具：输入 A 股股票代码与天数，程序会抓取最近 N 天的收盘价与市场情绪信息（含“恐惧与贪婪指数”代理指标），并基于 CrewAI 的多 Agent 架构让大模型以“看多 / 看空 / 持有 / 最终决策”四个角色输出结构化 JSON 分析结果。

适合用来：

• 快速得到结构化结论（便于接入你自己的工作流/自动化）
• 观察多方观点冲突点（Bull vs Bear vs Hold）
• 结合情绪指标（Fear & Greed proxy）做市场氛围参考

如果这个项目对你有帮助，欢迎点一个 Star（对开源项目非常重要）。

English Overview

A CLI tool for China A-shares: fetches recent prices + market context (including a proxy “Fear & Greed Index”), then runs a CrewAI-based multi-agent debate (Bull / Bear / Hold / Judge) and outputs structured JSON insights.

Great for:

• Structured outputs (easy to integrate)
• Multi-perspective debate (pros/cons/neutral)
• Quick sentiment snapshot via Fear & Greed proxy

If you find this useful, please consider starring the repo.

---

目录 / Table of Contents

• 运行环境
• 安装依赖
• 快速开始（中文）
• 配置密钥（不要提交到 GitHub）
• Quick Start (English)
• 示例输出 / Demo Output
• 架构 / Architecture
• 恐惧与贪婪指数（说明）
• Fear & Greed Index (What it is)
• 依赖清单（需要下载）

运行环境

• Python 3.11+（建议使用虚拟环境）

安装依赖

pip install -r requirements.txt

快速开始（中文）

启动：

python main.py

按提示输入：

• 仅股票代码：600519
• 股票代码 + 天数：600519 5
• 也支持显式交易所后缀：600519.SS / 000001.SZ

退出：输入 exit

配置密钥（不要提交到 GitHub）

本项目通过阿里云百炼（DashScope）的 OpenAI 兼容接口调用模型。

1. 复制环境变量模板：

copy .env.example .env

2. 编辑 .env，填入你的密钥：

• DASHSCOPE_API_KEY：必填
• DASHSCOPE_BASE_URL：可选（默认 https://dashscope.aliyuncs.com/compatible-mode/v1）

说明：项目已在 .gitignore 中忽略 .env，公开仓库不会上传你的密钥。

Quick Start (English)

Run:

python main.py

Examples:

• Ticker only: 600519
• Ticker + days: 600519 5
• With exchange suffix: 600519.SS / 000001.SZ

Quit: type exit

Optional flags:

python main.py 600519 5 --lang en
python main.py 600519 5 --json

示例输出 / Demo Output

展开 / Expand

示例输出为示意（字段结构与真实一致，具体内容会随输入与市场数据变化）。

Summary
- Decision: HOLD
- Trend: sideways
- Confidence: 0.62
- Winner: HOLD

Fear & Greed Index
- Score: 54.10
- Rating: Neutral
- Source: AShare Proxy (breadth + northbound)

架构 / Architecture

flowchart LR
    A[AkShare Market Data] --> B[Input Pack\nPrices + Market Context]
    B --> C1[Bull Agent]
    B --> C2[Bear Agent]
    B --> C3[Hold Agent]
    C1 --> J[Judge Agent]
    C2 --> J
    C3 --> J
    J --> O[Structured JSON Output]

Loading

恐惧与贪婪指数（说明）

这里的“恐惧与贪婪指数”不是官方指数，而是一个 A 股市场情绪的代理指标（proxy），基于：

• 市场涨跌家数/涨跌幅分布（breadth）
• 涨停/跌停的强弱
• 北向资金净流入（若可获取）

输出字段：

• score：0~100，越高越偏“贪婪”
• rating：Extreme Fear / Fear / Neutral / Greed / Extreme Greed

Fear & Greed Index (What it is)

This project shows a proxy Fear & Greed Index for China A-shares (not an official index). It’s derived from:

• Market breadth (advancers/decliners)
• Limit-up vs limit-down strength
• Northbound net inflow (when available)

Fields:

• score: 0~100 (higher means more “greed”)
• rating: Extreme Fear / Fear / Neutral / Greed / Extreme Greed

---

免责声明 / Disclaimer

• 本项目仅用于学习与信息展示，不构成任何投资建议。
• This is for educational/informational purposes only. Not financial advice.

依赖清单（需要下载）

• akshare：拉取 A 股行情数据与市场情绪信息
• crewai：多角色 Agent 编排
• openai：调用 OpenAI 兼容接口（DashScope Compatible Mode）
• python-dotenv：从 .env 加载环境变量（可选但推荐）
• rich：更美观的命令行界面输出