aimoon 0.2.2__tar.gz → 0.3.0__tar.gz

aimoon-0.3.0/PKG-INFO

@@ -0,0 +1,239 @@
+Metadata-Version: 2.4
+Name: aimoon
+Version: 0.3.0
+Summary: AI-powered A-share stock analysis with multi-platform data collection
+Author-email: aimoon <aimoon@users.noreply.github.com>
+License: MIT
+Project-URL: Homepage, https://github.com/aimoon/aimoon
+Project-URL: Repository, https://github.com/aimoon/aimoon
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: Chinese (Simplified)
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: pydantic>=2.10.0
+Requires-Dist: pydantic-settings>=2.7.0
+Requires-Dist: jinja2>=3.1.4
+Requires-Dist: akshare>=1.16.0
+Requires-Dist: pysnowball>=0.1.0
+Requires-Dist: openai>=1.60.0
+Requires-Dist: python-dotenv>=1.0.1
+Requires-Dist: rich>=13.9.0
+Requires-Dist: orjson>=3.10.0
+Requires-Dist: tenacity>=9.0.0
+Requires-Dist: selenium>=4.45.0
+Requires-Dist: playwright>=1.60.0
+Requires-Dist: markdown>=3.10.2
+Provides-Extra: dev
+Requires-Dist: pytest>=8.3.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.24.0; extra == "dev"
+Requires-Dist: pytest-cov>=6.0.0; extra == "dev"
+Requires-Dist: ruff>=0.8.0; extra == "dev"
+Provides-Extra: selenium
+Requires-Dist: selenium>=4.45.0; extra == "selenium"
+Provides-Extra: all
+Requires-Dist: selenium; extra == "all"
+Requires-Dist: playwright; extra == "all"
+
+# Aimoon — AI A股分析工具
+
+输入股票代码，自动完成 **采集 → 整合 → AI分析 → 可视化报告** 四步流程。
+
+```bash
+# 安装
+cd aimoon
+uv tool install --editable .
+
+# 配置（编辑 .env 填入 API Key）
+cp .env.example .env
+
+# 分析任何A股
+aimoon 600519                  # 贵州茅台（真实数据）
+aimoon 600519 --mock           # Mock模式
+aimoon 000001                  # 平安银行
+aimoon 000858 -o ./reports     # 五粮液，指定输出目录
+```
+
+---
+
+## 数据采集覆盖
+
+| 数据源 | 采集方式 | 数据量 | 状态 |
+|--------|----------|--------|------|
+| 实时行情(含PE) | 雪球 stock.xueqiu.com API | — | ✅ |
+| 财务数据 | pysnowball (资产负债表/利润表/现金流) | — | ✅ |
+| 雪球热帖 | HTTP API (hot list + stock search) | 10条 | ✅ |
+| 东方财富股吧 | Selenium (优先) → akshare (兜底) | 10条 | ✅ |
+| 巨潮资讯·公司公告 | 官方API + secCode二次过滤 | 20条 | ✅ |
+| 微信公众号 | 搜狗微信搜索 | 10条 | ✅ |
+| 今日头条 | Playwright 搜索 | 7-10条 | ✅ |
+| 小红书 | Playwright + 登录态 | 7-10条 | ✅ |
+| 抖音 | Playwright（反爬严格） | — | ⚠️ 待调试 |
+
+> ✅ = 开箱即用 &emsp; ⚠️ = 需手动配置 &emsp; 🚧 = 开发中
+
+---
+
+## 安装指南
+
+### 前置依赖
+
+- **Python ≥ 3.12**
+- **uv**（Python包管理器）: `powershell -c "irm https://astral.sh/uv/install.ps1 | iex"`
+- **Chrome 浏览器** (Selenium/Playwright 需要)
+
+### 基础安装
+
+```bash
+# 1. 进入项目目录
+cd aimoon
+
+# 2. 安装依赖
+uv sync
+
+# 3. 首次安装 CLI 工具（全局可用）
+uv tool install --editable .
+
+# 4. Playwright 浏览器
+uv run playwright install chromium
+```
+
+### 配置文件 (.env)
+
+```ini
+# === 必配 ===
+DEEPSEEK_API_KEY=sk-xxx          # DeepSeek API Key
+
+# === 雪球（推荐配置，可获取含PE的实时行情 + 财报 + 雪球热帖）===
+XUEQIU_TOKEN=xq_a_token=xxx; u=xxx
+XUEQIU_COOKIE=xq_a_token=xxx; u=xxx
+```
+
+> 雪球 Cookie 获取: 浏览器登录 [xueqiu.com](https://xueqiu.com) → F12 → Application → Cookies → 复制 `xq_a_token` 和 `u`
+
+### 小红书/抖音登录（可选）
+
+```python
+# 运行一次，会弹出浏览器窗口，扫码登录后按回车即可
+uv run python -c "
+from stock_ai_analyst.collectors.xiaohongshu import XiaohongshuCollector
+XiaohongshuCollector.login()
+"
+# 抖音同理
+uv run python -c "
+from stock_ai_analyst.collectors.douyin import DouyinCollector
+DouyinCollector.login()
+"
+```
+
+> 登录态会保存到 `~/.stock-ai-analyst/`，后续自动复用。
+
+### 扩展工具（可选）
+
+| 工具 | 用途 | 安装 |
+|------|------|------|
+| **Agent Reach** | 小红书/多平台接入 | `pip install agent-reach @ https://github.com/Panniantong/agent-reach/archive/main.zip` |
+| **MediaCrawler** | 抖音/小红书专业采集 | `git clone https://github.com/NanmiCoder/MediaCrawler ~/.mediacrawler` |
+
+---
+
+## 架构
+
+```
+用户输入股票代码 (600519)
+     │
+     ▼
+┌─ ① 数据采集 ─────────────────────────────────────────────┐
+│                                                           │
+│  行情    → 雪球(含PE) → 新浪 → 腾讯   (三级兜底)          │
+│  财报    → pysnowball                                     │
+│  雪球    → HTTP热帖API + stock search                      │
+│  股吧    → Selenium → akshare                              │
+│  公告    → 巨潮资讯 API (searchkey + secCode)              │
+│  微信    → 搜狗搜索                                        │
+│  头条    → Playwright                                      │
+│  小红书  → Playwright + 登录态                              │
+│                                                           │
+└───────────────────────┬───────────────────────────────────┘
+                        ▼
+┌─ ② 数据整合 ─────────────────────────────────────────────┐
+│   - 9个采集器并发/串行执行                                 │
+│   - 格式校验 + 跨源交叉验证 + 时效性检查                    │
+│   - 单个采集器失败不影响全局                                │
+└───────────────────────┬───────────────────────────────────┘
+                        ▼
+┌─ ③ AI 分析 (DeepSeek) ───────────────────────────────────┐
+│   6维度: 情绪25% + 技术15% + 基本面20%                     │
+│          资金15% + 新闻15% + 综合10%                       │
+└───────────────────────┬───────────────────────────────────┘
+                        ▼
+┌─ ④ HTML 报告 (Jinja2) ───────────────────────────────────┐
+│   深蓝暗色 · 响应式Grid · 红涨绿跌                          │
+│   SVG图表 · 评分环形图 · 情感堆叠条                         │
+│   纯静态HTML，无外部依赖，可离线查看                         │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## 项目结构
+
+```
+src/stock_ai_analyst/
+├── main.py              # CLI 入口 + 四步流程编排
+├── config/settings.py   # 配置管理 (Pydantic + .env)
+├── models/              # 数据模型
+│   ├── stock.py         # StockQuote, FinancialData
+│   ├── social.py        # SocialPost, CollectResult
+│   └── report.py        # AnalysisReport, DimensionScore
+├── collectors/          # 10个采集器
+│   ├── quote.py         # 行情（雪球→新浪→腾讯）
+│   ├── xueqiu.py        # 雪球热帖 + 含PE行情
+│   ├── eastmoney_guba.py        # 东方财富股吧 (akshare)
+│   ├── eastmoney_selenium.py    # 东方财富股吧 (Selenium)
+│   ├── cninfo.py        # 巨潮资讯·公司公告
+│   ├── wechat.py        # 微信公众号（搜狗搜索）
+│   ├── toutiao.py       # 今日头条（Playwright）
+│   ├── douyin.py        # 抖音（Playwright）
+│   ├── xiaohongshu.py   # 小红书（Playwright）
+│   ├── agent_reach_wrapper.py   # AgentReach 接口
+│   └── mediacrawler_adapter.py  # MediaCrawler 适配器
+├── financial/           # 财报 (pysnowball)
+│   └── pysnowball_adapter.py
+├── ai/                  # DeepSeek 分析引擎
+│   └── analyzer.py      # DeepSeekAnalyzer + AIAnalyzer
+├── validation/          # 数据质量
+│   ├── format_validator.py
+│   ├── cross_validator.py
+│   └── freshness_checker.py
+└── report/              # 报告生成
+    ├── generator.py     # Jinja2 模板渲染
+    └── templates/index.html
+```
+
+## 输出示例
+
+生成的 HTML 报告包含：
+
+- **顶部**：股票代码、实时行情（价格/涨跌/PE）、综合评分环形图 + 摘要
+- **6维度评分**：市场情绪/技术面/基本面/资金面/新闻舆情/综合评级（带横向条形图）
+- **可视化图表**：技术面价格区间图、资金面现金流横向条、新闻情感堆叠条
+- **财务数据表**：营收/净利润/ROE/EPS/现金流
+- **全网舆情**：各平台帖子列表（标注来源/点赞/评论）
+- **AI 综合分析报告**：Markdown 渲染为排版良好的 HTML，含公司概况、财务评估、情绪分析、技术简析、投资建议、风险提示
+- **数据来源清单**：每个平台采集状态
+
+报告为纯静态 HTML，无外部 JS 依赖，可直接通过浏览器打开或分享。
+
+---
+
+## 免责声明
+
+本报告由 AI 自动生成，所有分析内容仅供参考，不构成任何投资建议。投资有风险，入市需谨慎。

aimoon-0.3.0/README.md

@@ -0,0 +1,193 @@
+# Aimoon — AI A股分析工具
+
+输入股票代码，自动完成 **采集 → 整合 → AI分析 → 可视化报告** 四步流程。
+
+```bash
+# 安装
+cd aimoon
+uv tool install --editable .
+
+# 配置（编辑 .env 填入 API Key）
+cp .env.example .env
+
+# 分析任何A股
+aimoon 600519                  # 贵州茅台（真实数据）
+aimoon 600519 --mock           # Mock模式
+aimoon 000001                  # 平安银行
+aimoon 000858 -o ./reports     # 五粮液，指定输出目录
+```
+
+---
+
+## 数据采集覆盖
+
+| 数据源 | 采集方式 | 数据量 | 状态 |
+|--------|----------|--------|------|
+| 实时行情(含PE) | 雪球 stock.xueqiu.com API | — | ✅ |
+| 财务数据 | pysnowball (资产负债表/利润表/现金流) | — | ✅ |
+| 雪球热帖 | HTTP API (hot list + stock search) | 10条 | ✅ |
+| 东方财富股吧 | Selenium (优先) → akshare (兜底) | 10条 | ✅ |
+| 巨潮资讯·公司公告 | 官方API + secCode二次过滤 | 20条 | ✅ |
+| 微信公众号 | 搜狗微信搜索 | 10条 | ✅ |
+| 今日头条 | Playwright 搜索 | 7-10条 | ✅ |
+| 小红书 | Playwright + 登录态 | 7-10条 | ✅ |
+| 抖音 | Playwright（反爬严格） | — | ⚠️ 待调试 |
+
+> ✅ = 开箱即用   ⚠️ = 需手动配置   🚧 = 开发中
+
+---
+
+## 安装指南
+
+### 前置依赖
+
+- **Python ≥ 3.12**
+- **uv**（Python包管理器）: `powershell -c "irm https://astral.sh/uv/install.ps1 | iex"`
+- **Chrome 浏览器** (Selenium/Playwright 需要)
+
+### 基础安装
+
+```bash
+# 1. 进入项目目录
+cd aimoon
+
+# 2. 安装依赖
+uv sync
+
+# 3. 首次安装 CLI 工具（全局可用）
+uv tool install --editable .
+
+# 4. Playwright 浏览器
+uv run playwright install chromium
+```
+
+### 配置文件 (.env)
+
+```ini
+# === 必配 ===
+DEEPSEEK_API_KEY=sk-xxx          # DeepSeek API Key
+
+# === 雪球（推荐配置，可获取含PE的实时行情 + 财报 + 雪球热帖）===
+XUEQIU_TOKEN=xq_a_token=xxx; u=xxx
+XUEQIU_COOKIE=xq_a_token=xxx; u=xxx
+```
+
+> 雪球 Cookie 获取: 浏览器登录 [xueqiu.com](https://xueqiu.com) → F12 → Application → Cookies → 复制 `xq_a_token` 和 `u`
+
+### 小红书/抖音登录（可选）
+
+```python
+# 运行一次，会弹出浏览器窗口，扫码登录后按回车即可
+uv run python -c "
+from stock_ai_analyst.collectors.xiaohongshu import XiaohongshuCollector
+XiaohongshuCollector.login()
+"
+# 抖音同理
+uv run python -c "
+from stock_ai_analyst.collectors.douyin import DouyinCollector
+DouyinCollector.login()
+"
+```
+
+> 登录态会保存到 `~/.stock-ai-analyst/`，后续自动复用。
+
+### 扩展工具（可选）
+
+| 工具 | 用途 | 安装 |
+|------|------|------|
+| **Agent Reach** | 小红书/多平台接入 | `pip install agent-reach @ https://github.com/Panniantong/agent-reach/archive/main.zip` |
+| **MediaCrawler** | 抖音/小红书专业采集 | `git clone https://github.com/NanmiCoder/MediaCrawler ~/.mediacrawler` |
+
+---
+
+## 架构
+
+```
+用户输入股票代码 (600519)
+     │
+     ▼
+┌─ ① 数据采集 ─────────────────────────────────────────────┐
+│                                                           │
+│  行情    → 雪球(含PE) → 新浪 → 腾讯   (三级兜底)          │
+│  财报    → pysnowball                                     │
+│  雪球    → HTTP热帖API + stock search                      │
+│  股吧    → Selenium → akshare                              │
+│  公告    → 巨潮资讯 API (searchkey + secCode)              │
+│  微信    → 搜狗搜索                                        │
+│  头条    → Playwright                                      │
+│  小红书  → Playwright + 登录态                              │
+│                                                           │
+└───────────────────────┬───────────────────────────────────┘
+                        ▼
+┌─ ② 数据整合 ─────────────────────────────────────────────┐
+│   - 9个采集器并发/串行执行                                 │
+│   - 格式校验 + 跨源交叉验证 + 时效性检查                    │
+│   - 单个采集器失败不影响全局                                │
+└───────────────────────┬───────────────────────────────────┘
+                        ▼
+┌─ ③ AI 分析 (DeepSeek) ───────────────────────────────────┐
+│   6维度: 情绪25% + 技术15% + 基本面20%                     │
+│          资金15% + 新闻15% + 综合10%                       │
+└───────────────────────┬───────────────────────────────────┘
+                        ▼
+┌─ ④ HTML 报告 (Jinja2) ───────────────────────────────────┐
+│   深蓝暗色 · 响应式Grid · 红涨绿跌                          │
+│   SVG图表 · 评分环形图 · 情感堆叠条                         │
+│   纯静态HTML，无外部依赖，可离线查看                         │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## 项目结构
+
+```
+src/stock_ai_analyst/
+├── main.py              # CLI 入口 + 四步流程编排
+├── config/settings.py   # 配置管理 (Pydantic + .env)
+├── models/              # 数据模型
+│   ├── stock.py         # StockQuote, FinancialData
+│   ├── social.py        # SocialPost, CollectResult
+│   └── report.py        # AnalysisReport, DimensionScore
+├── collectors/          # 10个采集器
+│   ├── quote.py         # 行情（雪球→新浪→腾讯）
+│   ├── xueqiu.py        # 雪球热帖 + 含PE行情
+│   ├── eastmoney_guba.py        # 东方财富股吧 (akshare)
+│   ├── eastmoney_selenium.py    # 东方财富股吧 (Selenium)
+│   ├── cninfo.py        # 巨潮资讯·公司公告
+│   ├── wechat.py        # 微信公众号（搜狗搜索）
+│   ├── toutiao.py       # 今日头条（Playwright）
+│   ├── douyin.py        # 抖音（Playwright）
+│   ├── xiaohongshu.py   # 小红书（Playwright）
+│   ├── agent_reach_wrapper.py   # AgentReach 接口
+│   └── mediacrawler_adapter.py  # MediaCrawler 适配器
+├── financial/           # 财报 (pysnowball)
+│   └── pysnowball_adapter.py
+├── ai/                  # DeepSeek 分析引擎
+│   └── analyzer.py      # DeepSeekAnalyzer + AIAnalyzer
+├── validation/          # 数据质量
+│   ├── format_validator.py
+│   ├── cross_validator.py
+│   └── freshness_checker.py
+└── report/              # 报告生成
+    ├── generator.py     # Jinja2 模板渲染
+    └── templates/index.html
+```
+
+## 输出示例
+
+生成的 HTML 报告包含：
+
+- **顶部**：股票代码、实时行情（价格/涨跌/PE）、综合评分环形图 + 摘要
+- **6维度评分**：市场情绪/技术面/基本面/资金面/新闻舆情/综合评级（带横向条形图）
+- **可视化图表**：技术面价格区间图、资金面现金流横向条、新闻情感堆叠条
+- **财务数据表**：营收/净利润/ROE/EPS/现金流
+- **全网舆情**：各平台帖子列表（标注来源/点赞/评论）
+- **AI 综合分析报告**：Markdown 渲染为排版良好的 HTML，含公司概况、财务评估、情绪分析、技术简析、投资建议、风险提示
+- **数据来源清单**：每个平台采集状态
+
+报告为纯静态 HTML，无外部 JS 依赖，可直接通过浏览器打开或分享。
+
+---
+
+## 免责声明
+
+本报告由 AI 自动生成，所有分析内容仅供参考，不构成任何投资建议。投资有风险，入市需谨慎。

aimoon-0.3.0/pyproject.toml

@@ -0,0 +1,69 @@
+[project]
+name = "aimoon"
+version = "0.3.0"
+description = "AI-powered A-share stock analysis with multi-platform data collection"
+requires-python = ">=3.12"
+readme = "README.md"
+license = {text = "MIT"}
+authors = [{name = "aimoon", email = "aimoon@users.noreply.github.com"}]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Financial and Insurance Industry",
+    "License :: OSI Approved :: MIT License",
+    "Natural Language :: Chinese (Simplified)",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Office/Business :: Financial :: Investment",
+]
+
+dependencies = [
+    "httpx>=0.28.0",
+    "pydantic>=2.10.0",
+    "pydantic-settings>=2.7.0",
+    "jinja2>=3.1.4",
+    "akshare>=1.16.0",
+    "pysnowball>=0.1.0",
+    "openai>=1.60.0",
+    "python-dotenv>=1.0.1",
+    "rich>=13.9.0",
+    "orjson>=3.10.0",
+    "tenacity>=9.0.0",
+    "selenium>=4.45.0",
+    "playwright>=1.60.0",
+    "markdown>=3.10.2",
+]
+
+[project.urls]
+Homepage = "https://github.com/aimoon/aimoon"
+Repository = "https://github.com/aimoon/aimoon"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.3.0",
+    "pytest-asyncio>=0.24.0",
+    "pytest-cov>=6.0.0",
+    "ruff>=0.8.0",
+]
+selenium = ["selenium>=4.45.0"]  # 东方财富股吧增强采集
+all = ["selenium", "playwright"]
+
+[build-system]
+requires = ["setuptools>=75.0"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[project.scripts]
+aimoon = "stock_ai_analyst.main:main"
+
+[tool.ruff]
+target-version = "py312"
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "N", "W", "UP"]