← Back to Skills Marketplace
hj2916

financial-report-analyzer

by HJ2916 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
213
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install financial-report-analyzer
Description
智能解析PDF格式财务报告,自动提取关键财务指标,生成可视化分析图表和投资参考报告。适用于分析中国A股、港股、美股上市公司的财务报表。Use when user needs to analyze financial reports, extract financial data from PDFs, compar...
README (SKILL.md)

\r \r

财报智析 - Financial Report Analyzer\r

\r 智能解析PDF财报,提取关键财务指标,生成可视化分析报告。\r \r

⚠️ 重要声明\r

\r 本工具仅供学习和研究使用,分析结果仅供参考,不构成投资建议。股市有风险,投资需谨慎。所有数据处理在本地完成,不会上传至任何外部服务器。\r \r ---\r \r

功能概览\r

\r

  1. PDF财报解析 - 自动提取三大报表数据\r
  2. 关键指标计算 - 盈利能力、成长能力、偿债能力、运营能力\r
  3. 可视化图表 - 生成趋势图、结构图、对比图\r
  4. 多期对比 - 支持多期财报对比分析\r \r ---\r \r

使用方法\r

\r

基础用法\r

\r 用户上传PDF财报文件后,自动执行分析:\r \r

用户: 帮我分析这份财报\r
[上传PDF文件]\r
```\r
\r
### 进阶用法\r
\r
```\r
用户: 对比这三年的财报变化\r
[上传多个PDF文件]\r
\r
用户: 生成可视化图表\r
\r
用户: 分析盈利能力指标\r
```\r
\r
---\r
\r
## 分析流程\r
\r
### Step 1: 读取PDF文件\r
\r
使用 `scripts/extract_pdf.py` 提取PDF文本内容:\r
\r
```bash\r
python scripts/extract_pdf.py \x3Cpdf_path>\r
```\r
\r
### Step 2: 解析财务数据\r
\r
使用 `scripts/parse_financial_data.py` 识别并提取财务数据:\r
\r
```bash\r
python scripts/parse_financial_data.py \x3Cextracted_text_file>\r
```\r
\r
### Step 3: 生成分析报告\r
\r
根据解析的数据生成结构化分析报告,包括:\r
- 关键财务指标表格\r
- 可视化图表(调用 `scripts/generate_charts.py`)\r
- 简要分析结论\r
\r
---\r
\r
## 财务指标体系\r
\r
### 📊 盈利能力指标\r
\r
| 指标 | 计算公式 | 说明 |\r
|------|----------|------|\r
| 营业收入 | - | 主营业务收入 |\r
| 净利润 | - | 归属于母公司股东的净利润 |\r
| 毛利率 | (营业收入-营业成本)/营业收入 | 反映产品盈利能力 |\r
| 净利率 | 净利润/营业收入 | 反映整体盈利能力 |\r
| ROE | 净利润/平均净资产 | 净资产收益率 |\r
| ROA | 净利润/平均总资产 | 总资产收益率 |\r
\r
### 📈 成长能力指标\r
\r
| 指标 | 计算公式 | 说明 |\r
|------|----------|------|\r
| 营收增长率 | (本期营收-上期营收)/上期营收 | 收入增长速度 |\r
| 净利润增长率 | (本期净利润-上期净利润)/上期净利润 | 利润增长速度 |\r
| 总资产增长率 | (本期总资产-上期总资产)/上期总资产 | 规模扩张速度 |\r
\r
### 💰 偿债能力指标\r
\r
| 指标 | 计算公式 | 说明 |\r
|------|----------|------|\r
| 资产负债率 | 总负债/总资产 | 财务杠杆水平 |\r
| 流动比率 | 流动资产/流动负债 | 短期偿债能力 |\r
| 速动比率 | (流动资产-存货)/流动负债 | 即时偿债能力 |\r
\r
### 🔄 运营能力指标\r
\r
| 指标 | 计算公式 | 说明 |\r
|------|----------|------|\r
| 总资产周转率 | 营业收入/平均总资产 | 资产使用效率 |\r
| 应收账款周转天数 | 365/(营业收入/平均应收账款) | 回款速度 |\r
| 存货周转天数 | 365/(营业成本/平均存货) | 库存管理效率 |\r
\r
---\r
\r
## 输出格式\r
\r
### 1. 关键指标摘要\r
\r
```\r
📊 关键财务指标摘要\r
═══════════════════════════════════════════\r
报告期: 2024年年报\r
公司名称: [公司名称]\r
═══════════════════════════════════════════\r
\r
【盈利能力】\r
营业收入: XXX亿元 (同比+X%)\r
净利润: XXX亿元 (同比+X%)\r
毛利率: XX% \r
净利率: XX%\r
ROE: XX%\r
\r
【成长能力】\r
营收增长率: +X%\r
净利润增长率: +X%\r
\r
【偿债能力】\r
资产负债率: XX%\r
流动比率: X.X\r
\r
【运营能力】\r
总资产周转率: X.X\r
═══════════════════════════════════════════\r
```\r
\r
### 2. 可视化图表\r
\r
自动生成以下图表:\r
- `revenue_trend.png` - 收入趋势图\r
- `profit_margin.png` - 利润率变化图\r
- `asset_structure.png` - 资产负债结构图\r
- `cash_flow.png` - 现金流分析图\r
\r
### 3. 分析报告\r
\r
生成Markdown格式的完整分析报告,包含:\r
- 执行摘要\r
- 详细财务数据分析\r
- 风险提示\r
- 免责声明\r
\r
---\r
\r
## 多期对比分析\r
\r
当用户提供多期财报时,自动执行对比分析:\r
\r
1. **趋势分析** - 关键指标变化趋势\r
2. **同比分析** - 与上年同期对比\r
3. **结构分析** - 收入/成本结构变化\r
4. **异常检测** - 识别异常波动指标\r
\r
---\r
\r
## 技术实现\r
\r
### 依赖库\r
\r
```\r
pdfplumber - PDF文本提取\r
pandas - 数据处理\r
matplotlib - 图表生成\r
numpy - 数值计算\r
```\r
\r
### 数据处理流程\r
\r
```\r
PDF文件 → 文本提取 → 数据清洗 → 指标计算 → 图表生成 → 报告输出\r
```\r
\r
---\r
\r
## 限制说明\r
\r
1. **数据来源** - 仅支持用户上传的PDF文件,不连接外部数据库\r
2. **格式支持** - 主要针对中国A股财报格式优化\r
3. **准确性** - 自动提取可能存在误差,建议人工核对关键数据\r
4. **时效性** - 分析基于历史数据,不预测未来表现\r
\r
---\r
\r
## 安全与隐私\r
\r
✅ **本地处理** - 所有数据在用户本地处理  \r
✅ **无网络传输** - 不连接外部API或服务器  \r
✅ **只读访问** - 仅读取用户提供的PDF文件  \r
✅ **无数据存储** - 不保存任何用户数据  \r
\r
---\r
\r
## 参考资料\r
\r
详细财务指标说明参见 `references/financial_metrics.md`\r
\r
报告模板参见 `references/report_template.md`\r
\r
---\r
\r
*免责声明:本工具由AI生成,仅供学习交流使用。投资有风险,决策需谨慎。*\r
Usage Guidance
This package appears internally consistent and local-only, but before installing: (1) review and run the scripts on non-sensitive sample PDFs to confirm behavior; (2) install Python dependencies from trusted sources (pip from PyPI) and inspect dependency versions; (3) if you will analyze sensitive documents, run the tool offline or in a sandbox to ensure data never leaves your environment; (4) if you require guarantees, manually audit the code (it's small and readable) to confirm there are no network calls added in future updates.
Capability Analysis
Type: OpenClaw Skill Name: financial-report-analyzer Version: 1.0.0 The financial-report-analyzer skill bundle is a legitimate tool designed to extract and analyze financial data from PDF reports. The included Python scripts (extract_pdf.py, parse_financial_data.py, generate_charts.py, and generate_report.py) perform local data processing using standard libraries like pdfplumber and matplotlib, with no evidence of network exfiltration, malicious execution, or unauthorized file access. The SKILL.md instructions are consistent with the tool's stated purpose and do not contain any prompt-injection attempts or instructions to bypass security boundaries.
Capability Assessment
Purpose & Capability
Name/description (PDF financial report analysis) aligns with the included scripts: extract_pdf.py, parse_financial_data.py, generate_charts.py, generate_report.py. No unexpected binaries, services, or credentials are required.
Instruction Scope
SKILL.md instructs the agent to run the included scripts on user-supplied PDF(s). The instructions reference only local files and the included scripts; they do not direct reading unrelated system files, contacting external endpoints, or collecting extra data.
Install Mechanism
This is instruction-plus-source (no install spec). No downloads from arbitrary URLs or archive extraction. Dependencies are standard Python libraries (pdfplumber, pandas, matplotlib, numpy) consistent with the task.
Credentials
The skill declares no required environment variables, credentials, or config paths. The code reads only provided PDF/text/json files and writes chart/report outputs locally—proportional to the stated functionality.
Persistence & Privilege
always is false and there is no behavior that modifies other skills or system-wide agent settings. The skill does not request elevated or persistent privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install financial-report-analyzer
  3. After installation, invoke the skill by name or use /financial-report-analyzer
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: Analyze financial reports in PDF format, extract key metrics, and generate visual and textual analysis. - Automatically parses China A-share, Hong Kong, and US-listed company PDFs to extract financial data. - Calculates and summarizes profitability, growth, solvency, and operating indicators. - Supports multi-period comparisons and trend analyses of key financial metrics. - Generates visual charts (trends, structures, comparisons) and Markdown-format analysis reports. - All data processed locally for enhanced privacy; no data upload or external API use. - Optimized for standard mainland China financial report formats.
Metadata
Slug financial-report-analyzer
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is financial-report-analyzer?

智能解析PDF格式财务报告,自动提取关键财务指标,生成可视化分析图表和投资参考报告。适用于分析中国A股、港股、美股上市公司的财务报表。Use when user needs to analyze financial reports, extract financial data from PDFs, compar... It is an AI Agent Skill for Claude Code / OpenClaw, with 213 downloads so far.

How do I install financial-report-analyzer?

Run "/install financial-report-analyzer" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is financial-report-analyzer free?

Yes, financial-report-analyzer is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does financial-report-analyzer support?

financial-report-analyzer is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created financial-report-analyzer?

It is built and maintained by HJ2916 (@hj2916); the current version is v1.0.0.

💬 Comments