电子表格API交互

技能简介

Moltsheet 是一个面向 AI 代理的 Web 端类 Excel API，支持程序化创建、修改和查询电子表格数据，可处理大规模数据集的批量操作。

业务背景

Moltsheet 让 AI 代理能像操作 Excel 一样处理在线表格，无需人工干预即可完成数据录入、批量更新和跨表查询。适合需要自动化处理大量结构化数据的场景，如报表生成、数据清洗和多系统数据同步，显著降低重复性手工操作成本。

落地案例：财务团队每月需汇总各区域销售数据并生成统一报表。通过 Moltsheet API，AI 代理自动创建标准格式表格，按区域批量写入数据，遇到格式错误时根据返回示例即时修正，最终输出完整分析表。协作人员凭 Slug 即可查看，全程无需打开 Excel 手动复制粘贴。

能做什么

• 通过 API 创建带自定义列结构的电子表格
• 以多种格式（计数、数据数组、行对象）批量写入数据
• 根据错误响应中的示例自动修正请求格式
• 查看自己拥有或被邀请协作的所有表格
• 使用实际列名生成针对性错误提示，减少猜测

使用说明

1. 注册获取 API Key

curl -X POST https://www.moltsheet.com/api/v1/agents/register \
  -H "Content-Type: application/json" \
  -d '{
    "displayName": "数据处理代理",
    "slug": "data.processor",
    "description": "处理电子表格数据"
  }'

Slug 要求：3-30 字符，仅小写字母、数字和中间点号，大小写不敏感唯一。

2. 认证方式

所有请求需在 Header 中加入：Authorization: Bearer YOUR_API_KEY

3. 创建表格

curl -X POST https://www.moltsheet.com/api/v1/sheets \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "销售数据", "schema": [{"name": "产品", "type": "string"}, {"name": "销量", "type": "number"}]}'

4. 写入数据

POST /rows 端点支持三种输入格式，错误返回会附带正确示例。

输入与输出

见下方输入与输出表格。

风险提示

• API Key 仅首次注册时返回，无法再次获取，务必安全保存
• 切勿向非 moltsheet.com 域名发送包含 API Key 的请求
• Slug 全局唯一且大小写不敏感，命名前建议检查可用性
• 生产环境必须使用 HTTPS 协议

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/youssefbm2008/moltsheet/SKILL.md
来源类型：开源社区技能