back
loading skill details...
提供A股大盘指数、涨跌停、北向资金监控及交易税费计算,支持多源数据交叉验证和用户自定义接口扩展。
---
name: china-stock-toolkit
description: 全球市场实时仪表盘 - A股/港股/美股/日韩指数、贵金属、外汇、自选股管理、个股详情分析、交易税费计算。内置多源聚合引擎(新浪/腾讯/东方财富),自动交叉验证数据可靠性。支持用户自定义数据接口扩展。Global market real-time dashboard with multi-source data aggregation, cross-validation, and HTML dashboard. GitHub: https://github.com/darbling/clawhub-skills 当用户询问A股行情、港股、美股、黄金、白银、汇率、自选股、个股分析、新闻、利好利空、交易税费、情绪分析时触发。
---
# 🌍 全球市场实时仪表盘 — china-stock-toolkit
**Author: Lin Hui** | [GitHub](https://github.com/darbling/clawhub-skills) | MIT License | v3.0.0
一个技能看遍全球市场。内置多源聚合引擎,自动交叉验证数据可靠性。
## ⚠️ 免责声明(重要)
**本工具仅供学习和技术研究使用,不构成任何投资建议、交易信号或财务指导。**
1. **非投资建议**:本工具展示的所有数据(包括但不限于指数行情、涨跌停统计、北向资金流向、外汇汇率)仅供参考,不构成买入、卖出或持有任何证券的建议。
2. **数据延迟**:默认免费数据源可能存在延迟(通常15-30分钟),不应作为实时交易决策依据。
3. **数据准确性**:尽管采用多源交叉验证机制,但仍无法保证数据的绝对准确性和完整性。
4. **风险自担**:用户基于本工具数据做出的任何投资决策,其风险和后果由用户自行承担。
5. **非专业服务**:本工具并非持牌证券咨询服务,不能替代专业金融机构的投资建议。
6. **税费计算**:交易税费计算结果仅供参考,实际费用以券商结算为准,各券商费率可能不同。
**使用本工具即表示您已阅读、理解并同意上述免责声明。如果您不同意,请立即停止使用。**
---
## 🌍 支持的市场与数据源
### ✅ 免费数据源(开箱即用)
| 市场 | 指数/品种 | 数据源 | 更新频率 | 状态 |
|------|----------|--------|----------|------|
| A股指数 | 上证/深证/创业板/科创50/北证50 | 腾讯/新浪/东方财富 | 实时 | ✅ 可用 |
| 港股 | 恒生指数 | 腾讯 | 实时 | ✅ 可用 |
| 贵金属 | 黄金/白银 | 腾讯 | 实时 | ✅ 可用 |
| A股个股 | 所有A股 | 腾讯/新浪/东方财富 | 实时 | ✅ 可用 |
### 🔧 扩展数据源(需用户配置)
| 市场 | 指数/品种 | 推荐数据源 | 配置方式 |
|------|----------|-----------|----------|
| 美股指数 | 道琼斯/纳斯达克/标普500 | Yahoo Finance | `export YAHOO_API_KEY=xxx` |
| 日韩指数 | 日经225/韩国KOSPI | Yahoo Finance | 同上 |
| 外汇 | 美元/人民币等 | Alpha Vantage | `export ALPHA_VANTAGE_KEY=xxx` |
| 加密货币 | BTC/ETH | CoinGecko API | 免费无需Key |
| 新浪国际 | 美股/日韩/外汇 | HTTP代理 | `export HTTP_PROXY=http://127.0.0.1:7890` |
---
## 🎯 核心功能
### 1. 📊 全球指数大盘
**A股(开箱即用)**
- 上证指数、深证成指、创业板指、科创50、北证50
- 实时价格、涨跌幅、成交额
- 多源聚合 + 交叉验证
**港股(开箱即用)**
- 恒生指数
**美股/日韩(需配置)**
- 道琼斯、纳斯达克、标普500
- 日经225、韩国KOSPI
### 2. 💰 大宗商品
**贵金属(开箱即用)**
- 黄金(XAU)、白银(XAG)
- 实时价格、涨跌幅
**原油/其他(需配置)**
- WTI、布伦特原油
- 铜、铝等商品
### 3. ⭐ 自选股管理
- 添加/删除自选股
- 实时行情刷新
- 涨跌幅排序
- 点击查看个股详情
### 4. 📰 新闻聚合 + 情感分析 ⭐ **NEW**
智能抓取个股/板块相关新闻,自动标注**利好 📈 / 利空 📉 / 中性 ➡️**:
- **个股新闻**:抓取东方财富、新浪财经的公司新闻和公告
- **板块新闻**:新能源、芯片、人工智能等板块动态
- **政策追踪**:财联社快讯 + 监管政策实时更新
- **情感分析**:基于200+利好词、150+利空词的关键词库,自动判断新闻情绪
- **情绪汇总**:统计利好/利空比例,给出整体市场情绪(看涨/看跌/观望)
**情感分析原理**:
```
新闻标题: "公司业绩大增50%,超预期"
↓ 关键词匹配
利好词: [增长, 大增, 超预期] → 3个
利空词: [] → 0个
↓ 计算得分
得分 = (3-0)/(3+0) = 1.0
↓ 判断
情感: 利好 📈
```
**使用场景**:
- 选中一只股票 → 查看最新5条新闻 + 情感标注
- 关心新能源板块 → 查看板块整体情绪(看涨/看跌)
- 关注政策动向 → 实时追踪监管政策新闻
### 5. 📈 个股详情分析
点击任意股票查看多维度分析:
- **基础行情**:价格、涨跌幅、成交量、成交额
- **技术指标**:MA5/MA10/MA20、RSI、MACD
- **资金流向**:主力净流入、散户流向
- **涨跌停分析**:封单量、炸板次数(如适用)
- **税费计算**:自动代入当前价,计算卖出费用
- **持仓盈亏**:记录买入价,实时计算浮动盈亏
- **相关新闻**:自动关联最新5条新闻 + 情感标注 📰
### 6. 🧮 交易税费计算器
- 买入/卖出费用精确计算
- 印花税(卖出千分之0.5)
- 佣金(默认万分之三,可自定义)
- 过户费(十万分之一)
- 盈亏计算 + 收益率
---
## 🔧 多源数据架构
```
用户查询:上证指数
├─ 腾讯财经 API → 4078.64
├─ 新浪财经 API → 4078.60
├─ 东方财富 API → 4078.65
└─ 用户自定义 API → 4078.62(可选)
↓ 交叉验证
结果:4078.64(多数一致,可信度高)
```
### 配置示例
#### 方法1:环境变量
```bash
# Yahoo Finance(美股、日韩)
export YAHOO_API_KEY="your_api_key_here"
# Alpha Vantage(外汇、商品)
export ALPHA_VANTAGE_KEY="your_api_key_here"
# HTTP代理(访问被墙数据源)
export HTTP_PROXY="http://127.0.0.1:7890"
```
#### 方法2:配置文件
```yaml
# ~/.config/stock-toolkit/config.yaml
datasources:
yahoo_finance:
api_key: "your_api_key_here"
enabled: true
alpha_vantage:
api_key: "your_api_key_here"
enabled: true
proxy:
http: "http://127.0.0.1:7890"
https: "http://127.0.0.1:7890"
# 自定义数据源
custom:
name: "我的行情API"
base_url: "https://your-api.com"
api_key: "your_key"
enabled: true
```
---
## 🚀 快速开始
### 不配置任何东西(使用免费数据源)
```bash
# 查看A股指数
python scripts/stock_toolkit.py --action indices
# 查看港股恒生指数
python scripts/stock_toolkit.py --action hsi
# 查看贵金属
python scripts/stock_toolkit.py --action precious
# 添加自选股
python scripts/stock_toolkit.py --action add_watchlist --code sh600519 --name 贵州茅台
# 查看个股详情
python scripts/stock_toolkit.py --action stock_detail --code sh600519
# 税费计算
python scripts/stock_toolkit.py --action calc_tax --buy_price 1800 --sell_price 1850 --volume 100
# 📰 个股新闻 + 情感分析(NEW)
python scripts/stock_toolkit.py --action stock_news --code sh600519 --name 贵州茅台
# 📰 板块新闻 + 情感分析
python scripts/stock_toolkit.py --action sector_news --name 新能源
# 📰 政策新闻 + 情感分析
python scripts/stock_toolkit.py --action policy_news
# 📰 市场整体情绪
python scripts/stock_toolkit.py --action market_sentiment
```
### 配置扩展数据源后
```bash
# 配置Yahoo Finance
export YAHOO_API_KEY=xxx
# 查看美股指数
python scripts/stock_toolkit.py --action us_indices
# 查看日韩指数
python scripts/stock_toolkit.py --action asia_indices
```
---
## 🖥️ 图形界面
安装后自动生成HTML仪表盘,支持:
- 🌍 **多市场切换**:A股 / 港股 / 美股 / 贵金属
- 📊 **大盘看板**:实时指数卡片
- ⭐ **自选股列表**:一键添加/删除
- 📈 **个股详情**:点击查看多维度分析
- 🧮 **税费计算**:自动代入价格计算
- 🔴🟢 **红涨绿跌**:符合A股习惯
- 📱 **响应式布局**:手机/电脑都能用
- 🔒 **零CDN依赖**:离线可用
- 🎨 **暗色主题**:护眼舒适
---
## 📦 安装
```bash
skillhub install china-stock-toolkit
```
---
## 🌟 特色
- 🌍 **全球市场** — A股/港股/美股/日韩/贵金属
- 🔄 **多源聚合** — 腾讯/新浪/东方财富三路数据
- ✅ **交叉验证** — 自动校验数据可靠性
- 🚀 **开箱即用** — 免费数据源无需配置
- 🔌 **可扩展** — 支持自定义付费数据源
- ⭐ **自选股** — 个性化关注列表
- 📈 **个股详情** — 多维度深度分析
- 🧮 **税费计算** — 精确计算交易成本
- 📊 **图形界面** — HTML仪表盘开箱即用
- 🔒 **免费** — 无需API Key即可使用基础功能
- 🇨🇳 **A股特色** — 红涨绿跌、涨跌停、北向资金
---
## 📝 更新日志
### v3.0.0 (2026-04-28)
- ✨ 新增全球市场支持(港股、美股、日韩)
- ✨ 新增贵金属行情(黄金、白银)
- ✨ 新增自选股管理功能
- ✨ 新增个股详情分析(多维度)
- ✨ 新增可扩展数据源架构
- 🐛 修复税费计算逻辑
- 📚 完善数据源配置文档
### v1.0.0 (2026-04-27)
- 🎉 首次发布
- ✅ A股5大指数
- ✅ 涨跌停监控
- ✅ 北向资金
- ✅ 税费计算器
---
*再次提醒:本工具仅供学习研究,不构成任何投资建议。投资有风险,入市需谨慎。*
don't have the plugin yet? install it then click "run inline in claude" again.