@zsmj/finebi-skill

An OpenClaw skill that integrates with FineBI to provide data analysis and visualization capabilities through natural language.

Quick Start (npx)

You can run this skill directly without cloning the repository:

# 1. First time setup (Configure FineBI credentials)
npx -y @zsmj/finebi-skill install

# 2. Use any command
npx @zsmj/finebi-skill search-datasets --keyword "Sales"

Features

• 📊 Dataset Discovery – Search and preview FineBI datasets
• 📈 Dashboard Export – Export dashboards to Excel, PDF, or PNG
• 📂 Data Management – Explore data folders, structures, and models
• 🕷️ Spider Update Status – Monitor data update tasks

Installation (Local Development)

pnpm install
pnpm build

Configuration

The skill requires the following connection details:

• FINEBI_BASE_URL: Base URL of your FineBI instance (e.g., http://bi.example.com)
• FINEBI_USERNAME: Your FineBI username
• FINEBI_PASSWORD: Your FineBI password

You can configure these using npx @zsmj/finebi-skill install which creates a .env file, or set them as environment variables.

Available Tools (CLI)

This skill exposes a CLI finebi-skill.

| Command | Description | | :--- | :--- | | install | Interactive setup for FineBI credentials | | search-datasets | Search datasets by keyword | | preview-dataset-data | Preview dataset data (up to 100,000 rows) | | get-dataset-info | Get a FineBI dataset info by tableName | | export-dashboard-excel | Export a dashboard to Excel | | export-dashboard-pdf | Export a dashboard to PDF | | export-dashboard-image | Export a dashboard to PNG | | get-dashboard-user-info | Get current user info and their dashboards | | subject-search | Search across all subjects/folders |

Tip: Run npx @zsmj/finebi-skill <command> --help for specific options.

License

ISC