财经日报 (Finance Daily Report)#

Overview#

Generate a professional, interactive HTML financial daily report covering A-shares, Hong Kong stocks, and major global indices. The report follows Chinese stock market conventions (red for up, green for down) and uses AKShare for free real-time data.

When to Use#

Trigger this skill when the user asks for:

• 财经日报 / 今日财经 / 股市日报
• A daily financial market report
• Stock market overview or analysis
• 大盘分析 / 今日股市 / 金融日报
• Any request involving generating a daily financial summary

Workflow#

Step 1: Prepare Environment#

Before running the script, ensure dependencies are installed:

bash

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple akshare pandas --trusted-host pypi.tuna.tsinghua.edu.cn

Use the managed Python runtime at C:/Users/PC/.workbuddy/binaries/python/versions/3.13.12/python.exe and create/use a venv if needed.

Step 2: Run the Report Generator#

Execute the main script to generate the report:

bash

python scripts/generate_report.py [--output <path>] [--date YYYY-MM-DD]

Options:

• --output: Output HTML file path (default: current working directory finance_daily_report_YYYY-MM-DD.html)
• --date: Target date in YYYY-MM-DD format (default: today). Note: only historical dates work for complete data; today may have incomplete real-time data.

Step 3: Present the Report#

After generation, present the HTML file to the user using present_files. The report is a self-contained interactive HTML file that opens directly in the browser.

Report Modules#

The generated report includes 6 modules:

1. 大盘指数概览 — A-share main indices (SSE, SZSE, ChiNext, STAR 50), Hang Seng, Hang Seng Tech, with real-time price, change %, and change amount.
2. 行业板块热力 — Top 5 gaining and top 5 declining industry sectors with representative stocks.
3. 资金流向 — North-bound capital flow, total market turnover, main capital flow direction.
4. 外汇与商品 — USD/CNY exchange rate, gold price, crude oil price.
5. 财经要闻 — Key financial news headlines for the day.
6. 明日关注 — Financial calendar events and upcoming economic data releases.

Visual Conventions#

• Red (红色 #e74c3c): Price increase (涨) — Chinese market convention
• Green (绿色 #27ae60): Price decrease (跌) — Chinese market convention
• Interactive charts powered by Chart.js (loaded from CDN)
• Responsive design, mobile-friendly

Data Sources#

The script uses the following AKShare data sources (v1.18+ optimized for China network):

ModuleAPISourceA-share indicesak.stock_zh_index_spot_sina()Sina (reliable in China)HK indicesak.stock_hk_index_spot_sina()SinaIndustry sectorsak.stock_board_industry_summary_ths()TongHuaShun (THS)North-bound flowak.stock_hsgt_hist_em(symbol='沪股通')EastMoneyTurnoverCalculated from stock_zh_index_spot_sina()SinaForexak.fx_spot_quote()-Commoditiesak.futures_global_spot_em()EastMoneyNewsak.stock_news_em()EastMoney

See references/akshare_apis.md for detailed API mappings and column schemas.

Important: Encoding#

On Windows, always set PYTHONIOENCODING=utf-8 when running the script to avoid GBK encoding errors:

bash

PYTHONIOENCODING=utf-8 python scripts/generate_report.py --date 2026-06-16

Error Handling#

• Each API call includes automatic 2-retry with 1s delay for transient failures
• Failed modules gracefully degrade: show "暂无数据" placeholder in report
• Sina-based APIs ( stock_zh_index_spot_sina, stock_hk_index_spot_sina) are preferred over EastMoney for reliability in China
• If AKShare is not installed, guide the user to install it first