全球市场实时仪表盘

提供A股大盘指数、涨跌停、北向资金监控及交易税费计算，支持多源数据交叉验证和用户自定义接口扩展。

Security Scan

The skill's code, instructions, and optional environment variables are coherent with its stated purpose (a multi‑source market dashboard); nothing in the bundle requests unrelated credentials or installs unexpected software.

Purpose & Capability

Name/description promise a multi-source market dashboard; included SKILL.md, dashboard HTML and Python script implement data fetching (Tencent/Sina, optional Yahoo/AlphaVantage), cross-validation, a tax calculator and a local HTML UI. Required features (API keys, proxy) are optional and match described extended data sources.

Instruction Scope

Runtime instructions tell the agent to run the provided Python script and optionally set API keys or proxy. The SKILL.md does not ask the agent to read unrelated system files or exfiltrate secrets; code reads only the declared environment variables and (per docs) a user config file under ~/.config/stock-toolkit if present, which is reasonable for this tool.

Install Mechanism

No install spec is provided (instruction-only install), and the bundle contains the script and HTML. Nothing is downloaded from third‑party URLs during install. Running the script will perform network requests to public market-data endpoints (expected for this functionality).

Credentials

No required environment variables are declared in registry metadata. The code optionally reads YAHOO_API_KEY, ALPHA_VANTAGE_KEY, HTTP_PROXY/HTTPS_PROXY which the SKILL.md documents and which are proportionate to optional extended data sources and proxying needs. No unrelated credentials (cloud keys, tokens) are requested.

Persistence & Privilege

Skill is not always-enabled, does not request elevated system-wide privileges, and does not modify other skills. It may read/write its own config under the user's home (~/.config/stock-toolkit) per the documentation — this is expected behavior for a user-facing tool.

Assessment

This skill appears to do what it says: fetch market data from public endpoints, aggregate and display it, and optionally use user-supplied API keys or a proxy. Before running: (1) review the included scripts if you have security concerns; (2) avoid pasting high-scope secrets — provide only the API keys you intend to use; (3) run it in an isolated environment (container/VM) if you want to restrict network access; (4) be aware network calls go to public market-data endpoints (e.g., web.sqt.gtimg.cn, hq.sinajs.cn) and to any custom data URLs you configure; (5) the tool’s disclaimer about data delay and non-advice is accurate — do not use it as trading advice.

🌍 全球市场实时仪表盘 — china-stock-toolkit

Author: Lin Hui | GitHub | MIT License | v2.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. 📈 个股详情分析

点击任意股票查看多维度分析：

• 基础行情：价格、涨跌幅、成交量、成交额
• 技术指标：MA5/MA10/MA20、RSI、MACD
• 资金流向：主力净流入、散户流向
• 涨跌停分析：封单量、炸板次数（如适用）
• 税费计算：自动代入当前价，计算卖出费用
• 持仓盈亏：记录买入价，实时计算浮动盈亏

5. 🧮 交易税费计算器

• 买入/卖出费用精确计算
• 印花税（卖出千分之0.5）
• 佣金（默认万分之三，可自定义）
• 过户费（十万分之一）
• 盈亏计算 + 收益率

---

🔧 多源数据架构

用户查询：上证指数
  ├─ 腾讯财经 API → 4078.64
  ├─ 新浪财经 API → 4078.60
  ├─ 东方财富 API → 4078.65
  └─ 用户自定义 API → 4078.62（可选）
      ↓ 交叉验证
  结果：4078.64（多数一致，可信度高）

配置示例

方法1：环境变量

# 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：配置文件

# ~/.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

---

🚀 快速开始

不配置任何东西（使用免费数据源）

# 查看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

配置扩展数据源后

# 配置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依赖：离线可用
• 🎨 暗色主题：护眼舒适

---

📦 安装

skillhub install china-stock-toolkit

---

🌟 特色

• 🌍 全球市场 — A股/港股/美股/日韩/贵金属
• 🔄 多源聚合 — 腾讯/新浪/东方财富三路数据
• ✅ 交叉验证 — 自动校验数据可靠性
• 🚀 开箱即用 — 免费数据源无需配置
• 🔌 可扩展 — 支持自定义付费数据源
• ⭐ 自选股 — 个性化关注列表
• 📈 个股详情 — 多维度深度分析
• 🧮 税费计算 — 精确计算交易成本
• 📊 图形界面 — HTML仪表盘开箱即用
• 🔒 免费 — 无需API Key即可使用基础功能
• 🇨🇳 A股特色 — 红涨绿跌、涨跌停、北向资金

---

📝 更新日志

v2.0.0 (2026-04-28)

• ✨ 新增全球市场支持（港股、美股、日韩）
• ✨ 新增贵金属行情（黄金、白银）
• ✨ 新增自选股管理功能
• ✨ 新增个股详情分析（多维度）
• ✨ 新增可扩展数据源架构
• 🐛 修复税费计算逻辑
• 📚 完善数据源配置文档

v1.0.0 (2026-04-27)

• 🎉 首次发布
• ✅ A股5大指数
• ✅ 涨跌停监控
• ✅ 北向资金
• ✅ 税费计算器

---

再次提醒：本工具仅供学习研究，不构成任何投资建议。投资有风险，入市需谨慎。