开发者专区

Data API：POST 数据，得到存储

一个接口、两种格式、零服务器要运维。

每个已发布的表单都暴露一个 Data API 接口。向它 POST JSON，每个请求都成为一条可查询的存储记录——数据管理界面、CSV 导出、聚合统计全部免费附带。静态站点、本地 HTML 文件、脚本、IoT 设备、AI 生成的页面都能用，因为读写两个方向都开启了 CORS。

Data API 实操演示——发布、POST、读回数据

curl -X POST https://formlm.me/api/v3/share/<your-token> \
  -H "Content-Type: application/json" \
  -d '{"data":{"name":"Ada","score":92}}'

# 读回来——分页 JSON，每页最多 1000 条记录
curl "https://formlm.me/api/v3/share/<your-token>/query?page=1&size=20"

# 接口用 Markdown 自我描述——给你或你的 Agent 看
curl "https://formlm.me/api/v3/share/<your-token>?help"

生产环境的实证：FormLM 自己联系页上的反馈表单就是一个直接 POST 到 Data API 接口的静态表单——正是上文记录的那个模式，今天就跑在我们的官网上。

深入符合你技术栈的场景：

formlm-cli：终端也是一等公民客户端

npm 包、MIT 许可证、Node.js ≥ 18。

安装它、登录一次——从 formlm.me 的「账号设置」页复制访问令牌（无需密码），或用终端里的邮箱验证码方式登录——整个平台即可脚本化。亮点是智能生成：一句自然语言指令跑通服务端 Agent 管线，产出一个完整的评估应用——表单设计、计分维度、报告页面、视觉样式全包含。

npm install -g @formlm/cli

formlm-cli auth login --token <your-token>
# 令牌获取：formlm.me → 账号设置 → 访问令牌 → 复制
# 没有令牌？跑 formlm-cli auth login 选「邮箱验证码」方式

# 表单 + 量表 + 报告 + 样式，一条命令全搞定（60–300 秒）
formlm-cli smart generate \
  --input "创建一个职场压力评估，10 道题、3 个维度、附详细的分数解读"

# 拿到填写页、编辑器与数据管理 URL
formlm-cli app urls --app <appId>

# 发布它
formlm-cli share publish --app <appId>

要精细控制，还有八个模块的 50+ 条命令：app、field、scale、connect（页面样式）、report、expert、share、profile——另有 snapshot 把所有模块状态导出为 JSON 或 Markdown，skill 打印让生成内容保持规范的领域规则文档。

MCP 服务器：让 AI Agent 驾驭 FormLM

stdio 传输 · 8 个工具 · 6 个资源 · 兼容任何 MCP 客户端。

运行 formlm-cli mcp，CLI 就成为标准MCP 服务器。接上 Claude Desktop、Cursor、Codex CLI、Windsurf、Cline——或任何兼容 MCP 的客户端——Agent 便能以对话方式搭建、检视、发布你的表单；平台的 P0 约束嵌在每个工具描述里，让它不跑偏。

六个 MCP 资源（formlm://skills/form、scale、connect、report、expert、share）暴露的正是平台自家 Agent 在用的领域知识——你的 AI 先读规则，再写配置。完整的设置说明——含 macOS 桌面客户端的 PATH 修正与各平台配置文件位置——见 GitHub 上的 INSTALL 指南。

开发者常见问题

开发者们最常问我们的问题。