← Back to Skills Marketplace
yejinlei

excel-parser

by yejinlei · GitHub ↗ · v2.0.0 · MIT-0
cross-platform ⚠ suspicious
1016
Downloads
1
Stars
11
Active Installs
1
Versions
Install in OpenClaw
/install excel-parser-skill
Description
支持多种Excel格式的内容提取技能,使用calamine库处理.xls、.xlsx、.xlsm等格式。当用户需要解析Excel文件、提取表格数据、将Excel转换为文本格式、分析Excel内容或批量处理Excel文件时,务必使用此技能。适用于数据提取、报表分析、内容审核等场景。
README (SKILL.md)

Excel Parser Skill

Excel Parser技能用于从Excel文件中提取内容,支持多种Excel格式。

Compatibility

  • Python 3.7+
  • 依赖: python-dotenv, python-calamine
  • 备选依赖: xlrd (用于.xls文件), openpyxl (用于.xlsx文件)

使用方法

基本使用

from excel_parser import ExcelParser, process_excel

# 方法1: 使用ExcelParser类
parser = ExcelParser()
result = parser.parse_excel('path/to/file.xlsx')

# 方法2: 使用便捷函数
result = process_excel('path/to/file.xlsx')

# 获取文本格式输出
text = parser.parse_excel_to_text('path/to/file.xlsx')

返回结果格式

{
    "text": "格式化的文本内容",
    "sheets": [
        {
            "name": "Sheet1",
            "rows": [["A1", "B1"], ["A2", "B2"]],
            "row_count": 2,
            "column_count": 2
        }
    ],
    "sheet_count": 1,
    "total_cells": 4,
    "engine": "python-calamine"
}

支持的文件格式

  • .xls (Excel 97-2003)
  • .xlsx, .xlsm (Excel 2007+)
  • .xltx, .xltm (Excel模板)

环境变量配置

创建 .env 文件:

# 最大行数限制,默认100行
EXCEL_MAX_ROWS=100

# 是否保留空行,默认false
EXCEL_KEEP_EMPTY_ROWS=false

详细文档

更多使用示例和故障排除信息,参见 README.md

Usage Guidance
This skill looks consistent with its stated purpose, but be aware it will attempt to pip-install missing dependencies at runtime (internet access to PyPI is required). To reduce risk: run it in a sandboxed virtual environment, pin package versions, inspect the required packages (python-calamine, xlrd, openpyxl) before allowing installs, and verify the full script (including the truncated portion) if you need higher assurance. Also note the repository/homepage is unknown and setup.py lists version 1.0.0 while the registry metadata shows 2.0.0 — prefer obtaining packages from a trusted source (official PyPI/GitHub) before use.
Capability Analysis
Type: OpenClaw Skill Name: excel-parser-skill Version: 2.0.0 The skill bundle is classified as suspicious due to the inclusion of an automatic dependency installation mechanism in scripts/excel_parser.py. The install_dependency function uses subprocess.check_call to execute 'pip install' for missing libraries (python-calamine, xlrd, openpyxl). While the package names are hardcoded and the intent appears to be user convenience, auto-installing software at runtime is a high-risk behavior that bypasses standard environment controls and could be exploited for supply chain attacks or unauthorized code execution.
Capability Assessment
Purpose & Capability
Name, description, SKILL.md, requirements.txt and the Python code all align: this is an Excel parsing skill that uses python-calamine with xlrd/openpyxl as fallbacks. The code and declared dependencies are proportionate to the stated purpose.
Instruction Scope
SKILL.md and the code only describe reading user-supplied Excel files and optional .env settings (EXCEL_MAX_ROWS, EXCEL_KEEP_EMPTY_ROWS). The runtime code parses only the provided file paths and does not reference unrelated system paths or external endpoints. Note: the code calls load_dotenv() and will read .env if present (expected behavior).
Install Mechanism
There is no separate install spec, but the shipped Python script contains an install_dependency() helper that runs pip install via subprocess at runtime to fetch missing packages (e.g., python-calamine, xlrd). Using pip at runtime is a common convenience but increases risk because it performs network fetches and executes third-party package code; this is moderate risk but coherent with the skill's need for optional dependencies.
Credentials
The skill does not declare required environment variables or credentials in the registry. It documents optional .env keys for parser behavior (max rows, keep empty rows), which are reasonable and limited. No secrets, API keys, or unrelated env variables are requested.
Persistence & Privilege
always is false and the skill does not request elevated platform privileges. The only persistence-like behavior is installing Python packages into the runtime environment when dependencies are missing, which is expected but changes the environment; it does not modify other skills or system-wide agent settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install excel-parser-skill
  3. After installation, invoke the skill by name or use /excel-parser-skill
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.0
excel-parser-skill v2.0.0 - 新增对多种Excel格式的提取与解析支持,采用calamine库处理.xls、.xlsx、.xlsm等文件。 - 提供类ExcelParser与便捷处理函数,支持结构化数据和文本格式输出。 - 支持通过环境变量配置最大行数和空行处理,提升灵活性。 - 明确给出返回结构示例,便于二次开发和集成。 - 适用场景拓展至数据提取、报表分析、内容审核等多领域。
Metadata
Slug excel-parser-skill
Version 2.0.0
License MIT-0
All-time Installs 11
Active Installs 11
Total Versions 1
Frequently Asked Questions

What is excel-parser?

支持多种Excel格式的内容提取技能,使用calamine库处理.xls、.xlsx、.xlsm等格式。当用户需要解析Excel文件、提取表格数据、将Excel转换为文本格式、分析Excel内容或批量处理Excel文件时,务必使用此技能。适用于数据提取、报表分析、内容审核等场景。 It is an AI Agent Skill for Claude Code / OpenClaw, with 1016 downloads so far.

How do I install excel-parser?

Run "/install excel-parser-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is excel-parser free?

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

Which platforms does excel-parser support?

excel-parser is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created excel-parser?

It is built and maintained by yejinlei (@yejinlei); the current version is v2.0.0.

💬 Comments