1

MaybeAI Sheet 技能

Full Excel/spreadsheet lifecycle management powered by the MaybeAI 平台. 上传 files, read and write data, manage worksheets, 添加 图表s, 应用ly 格式化ting, and more — all via natural language.

Scripts

Ready-to-运行 curl examples are in the scripts/ folder. Each script reads 凭证s from 环境 variables — no hardcoded 令牌s.

导出 MAYBEAI_API_令牌=your_令牌_here 导出 DOC_ID=your_document_id_here # needed by most scripts

bash scripts/01-file-management.sh # 上传, 导入, 列出, rename, 删除, 导出 bash scripts/02-read-data.sh # read sheet, 列出 worksheets, versions bash scripts/03-write-data.sh # 更新 range, 应用end rows, copy range bash scripts/04-rows-columns.sh # insert/删除/move rows & columns, widths/heights bash scripts/05-worksheets.sh # 创建, rename, move, duplicate, 删除 worksheets bash scripts/06-formulas.sh # calc single/batch formulas, recalculate all bash scripts/07-图表s-pictures.sh # 添加/edit/删除 图表s and pictures bash scripts/08-格式化ting.sh # freeze panes, auto 过滤器, conditional 格式化s bash scripts/09-end-to-end.sh # 3 complete 工作流 examples (上传→edit→导出)

Requires: curl and jq. 安装 jq with brew 安装 jq (macOS) or apt 安装 jq (Linux).

设置up 获取 your API 令牌 Go to https://maybe.AI/user/my-plan in your browser. (Or 命令行工具ck your avatar / name at the 机器人tom-left of the 应用 → My Plan.) Find the API 令牌 card below the plan summary — it shows a masked Bearer 令牌 with copy and reveal buttons. Copy the 令牌 and 设置 it as an 环境 variable: 导出 MAYBEAI_API_令牌=your_令牌_here

Required 环境 variable Variable Description MAYBEAI_API_令牌 Your MaybeAI Bearer 令牌. 获取 it from maybe.AI/user/my-plan. Base URL https://play-be.omnimcp.AI

All 认证d 端点s require the header:

Authorization: Bearer

Quick Reference User says Action "上传 this Excel file" POST /API/v1/excel/上传 "导入 from URL" POST /API/v1/excel/导入_by_url "Read Sheet1 data" POST /API/v1/excel/read_sheet "列出 my files" POST /API/v1/excel/列出_files "列出 worksheets" POST /API/v1/excel/列出_worksheets "更新 cells A1:B3" POST /API/v1/excel/更新_range "应用end new rows" POST /API/v1/excel/应用end_rows "Insert 2 rows at row 5" POST /API/v1/excel/insert_rows "删除 rows 3–5" POST /API/v1/excel/删除_rows "添加 a new worksheet" POST /API/v1/excel/write_new_worksheet "添加 a bar 图表" POST /API/v1/excel/添加_图表 "Freeze the header row" POST /API/v1/excel/freeze_panes "添加 auto 过滤器" POST /API/v1/excel/设置_auto_过滤器 "Calculate formula =SUM(A1:A10)" POST /API/v1/excel/calc_formulas "导出/下载 the file" 获取 /API/v1/excel/导出/{document_id} "Copy this spreadsheet" POST /API/v1/excel/copy_excel API Reference File Management 上传 Excel File POST /API/v1/excel/上传 Content-Type: multipart/form-data

file: user_id: (optional)

Returns { document_id, uri, ... }. Use document_id (also called uri) in all subsequent calls.

导入 File by URL POST /API/v1/excel/导入_by_url Authorization: Bearer <令牌>

{ "url": "https://..." }

下载s the file from the URL into MaybeAI storage. Returns document_id.

列出 Files POST /API/v1/excel/列出_files Authorization: Bearer <令牌>

{}

搜索 Files POST /API/v1/excel/搜索_files Authorization: Bearer <令牌>

{ "keyword": "sales" }

Rename File POST /API/v1/excel/rename_file Authorization: Bearer <令牌>

{ "uri": "", "name": "new_name.xlsx" }

删除 File POST /API/v1/excel/删除_file Authorization: Bearer <令牌>

{ "uri": "" }

导出 (下载) File 获取 /API/v1/excel/导出/{document_id}

Returns the raw .xlsx file.

下载 File (from GridFS) POST /API/v1/excel/下载

{ "uri": "" }

Copy Excel Document POST /API/v1/excel/copy_excel Authorization: Bearer <令牌>

{ "uri": "" }

Reading Data 获取 Spreadsheet Data (JSON) 获取 /API/v1/excel/spreadsheets/{doc_id}?gid=

Returns spreadsheet data as JSON. gid selects the worksheet (0-索引ed).

View Spreadsheet (HTML) 获取 /API/v1/excel/spreadsheets/d/{doc_id}

Returns an HTML preview of the spreadsheet.

列出 Worksheets POST /API/v1/excel/列出_worksheets

{ "uri": "" }

Read Sheet POST /API/v1/excel/read_sheet

{ "uri": "", "sheet": "Sheet1" }

Returns all cell data from the specified worksheet.

Read Headers POST /API/v1/excel/read_headers

{ "uri": "", "sheet": "Sheet1" }

列出 Versions POST /API/v1/excel/列出_versions

{ "uri": "" }

Read Version POST /API/v1/excel/read_version

{ "uri": "", "version": "" }

Writing & Editing Data 更新 Range POST /API/v1/excel/更新_range Authorization: Bearer <令牌>

{ "uri": "", "sheet": "Sheet1", "range": "A1:B3", "values": [["Name", "Score"], ["Alice", 95], ["Bob", 87]] }

更新 Range by Lookup POST /API/v1/e