⌨️

开发者专区

用代码构建 FormLM:一个接收任何静态页面或 AI 应用提交的表单 Data API,外加让 AI Agent 搭建、管理表单的开源 CLI + MCP 服务器。

🔌 Data API
⌨️ formlm-cli
🤖 MCP 服务器
🔓 开源(MIT)

🧰 开发者工具箱

2 件核心工具
🔌

Data API——跑在 HTTP 上的表单后端

发布任何 FormLM 表单,就能得到一个接收 JSON 或原生 HTML 表单 POST 的接口。CORS 完全开启,未知字段可自动创建各自的列,每个接口都在 ?help 用 Markdown 自我描述——人和 AI Agent 都读得懂。

⌨️

formlm-cli——终端 + MCP 服务器

一个 MIT 许可证的 npm 包,从终端操控 FormLM:用自然语言生成完整评估应用,管理字段、量表、报告与发布。运行 formlm-cli mcp,它就变成任何 AI Agent 都能接入的 MCP 服务器。

Data API:POST 数据,得到存储

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

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

Data API 操作演示
Data API 实操演示——发布、POST、读回数据
# 从任何地方写一条记录——curl、fetch 或 AI Agent
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"
接口方法作用
/{token}POST存储一条记录——JSON 体,规范形态 {"data":{...},"meta":{...}} 或扁平对象
/{token}/formPOST存储原生 HTML 表单提交(application/x-www-form-urlencoded)
/{token}?helpGET返回接口自己的 Markdown API 文档——AI Agent 可读
/{token}/queryGET以 JSON 分页翻阅存储记录
/{token}/summaryGET对已收集记录做聚合统计

生产环境的实证: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 打印让生成内容保持规范的领域规则文档,以及 doctor 对建好的应用做只读体检(发布口径、空壳专家、报告覆盖、语言一致性)。

MCP 服务器:让 AI Agent 驾驭 FormLM

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

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

工具层级Agent 能做什么
auth_login / auth_email_code / auth_status0用访问令牌(推荐)、邮箱验证码、或邮箱 + 密码认证
formlm_generate1从自然语言生成执行计划(AssessAgent 管线)
formlm_execute1按计划逐个执行模块(form → scale → connect → report → expert → share)
formlm_doctor2只读体检应用:发布口径、空壳专家、报告覆盖、语言一致性
formlm_snapshot2一次调用读取所有模块的聚合状态
formlm_skill2拉取任意模块的 SKILL.md 领域规则
formlm_exec3直接执行任何白名单内的 CLI 命令

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

📖 指南与文档

16 篇已上线
🧩 框架接入
在 Next.js、Astro 和 Hugo 里放一个可用的表单——不用写后端
Next.js 客户端组件、Astro 孤岛、Hugo 纯静态页面,都能用一个托管接口存下每一条表单提交——不写 API 路由、不维护服务器。
📖 11 分钟阅读 阅读更多 →
🤖 MCP 工作流
在 Claude Desktop 里搭一份完整测评:MCP 全流程实操
把 formlm-cli 配成 MCP 服务器,在对话里登录、生成、审查、发布一整份测评应用——题目、维度、报告、样式,全程不打开网页编辑器。
📖 10 分钟阅读 阅读更多 →
🔄 数据管道
把表单数据交给程序:Query、Summary 与 CSV 工作流
经 HTTP 分页取回每一条提交,用汇总接口代替原始行,导出 CSV——把表单数据接进表格、仪表盘和 AI Agent 的上下文。
📖 10 分钟阅读 阅读更多 →
🔌 接口总览
FormLM Data API — 静态站点免费表单后端
60 秒为静态站点、本地页面或 AI 应用加上数据层。一个 URL 接收 JSON 或 HTML 表单 POST,存下每一条提交——无需服务器。
📄 文档 阅读更多 →
🤖 面向 AI Agent
FormLM Data API for AI Agents — Agent 可读的数据存储
AI Agent 几分钟建好页面——数据却丢了。FormLM 自文档化的 Data API,让 Claude、ChatGPT 与编程 Agent 自己完成存储集成。
📄 文档 阅读更多 →
🌐 静态站点
给静态站点加表单,无需后端
静态站点收表单无需后端:把 HTML 表单指向 FormLM 接口即可。GitHub Pages、Netlify 与任何静态托管都适用。
📄 文档 阅读更多 →
📮 联系表单
静态网站免费联系表单后端
几分钟为你的网站配上可用的联系表单——免费。把 action 指向 FormLM 接口;提交即被存储、可查询。无需服务器、无需 JavaScript。
📄 文档 阅读更多 →
📄 纯 HTML
HTML 表单 POST,无需服务器与 JavaScript
纯 HTML 表单也能存下提交:把 action 指向 FormLM 接口,原生 POST。无需服务器、无需 JavaScript、无需构建。
📄 文档 阅读更多 →
🧱 JSON 存储
JSON API 存数据:无服务器、无数据库
把 JSON POST 到一个 URL,它就存下来了——这就是整个 API。面向脚本、自动化、IoT 与 AI 应用的免费数据接口,记录可经 HTTP 查询。
📄 文档 阅读更多 →
💾 本地页面
本地 HTML 页面或 AI 应用也能存数据
本地 HTML 文件——从磁盘打开或由 AI 生成——也能把数据存到云端。FormLM 开启 CORS 的 API 接收来自 file:// 页面的 POST,无需部署。
📄 文档 阅读更多 →
🛠 Claude
Claude + FormLM Data API:MCP 数据存储配置
让 Claude 存储和查询数据——走 MCP 或一个普通 URL。一个接口,?help 自带文档,Claude 自己就能读懂。免费,五分钟配好。
📄 文档 阅读更多 →
🛠 Cursor
Cursor + FormLM Data API:MCP 存储配置
Cursor 的 agent 写的打卡器和表单一刷新就丢数据。在 .cursor/mcp.json 里加一个 FormLM 接口——或者直接把 ?help URL 贴进对话。
📄 文档 阅读更多 →
🛠 Codex CLI
Codex CLI + FormLM Data API:Agent 数据存储
Codex CLI 写代码很快,但沙箱文件留不住。给 Codex 一个 FormLM 接口——它自己读 ?help 文档,或在 config.toml 里接入 formlm-cli。
📄 文档 阅读更多 →
🛠 Windsurf
Windsurf + FormLM Data API:MCP 存储配置
Windsurf 的 Cascade 几分钟搭好工具——然后数据就没了。在 mcp_config.json 里接入 FormLM MCP 服务器,或递给 Cascade 一个自带文档的 URL。
📄 文档 阅读更多 →
🛠 Cline
Cline + FormLM Data API:VS Code 的 MCP 存储
Cline 在 VS Code 里规划、写码、执行——但产出随工作区一起消亡。把 formlm-cli 加进 cline_mcp_settings.json,每个任务的结果都能留存。
📄 文档 阅读更多 →
🛠 WorkBuddy
WorkBuddy + FormLM Data API:保存 Agent 产出
WorkBuddy 自动完成调研和文档——结果却停在对话里。给它一个 FormLM 接口 URL,每个任务的产出都变成存下来、可查询的记录。
📄 文档 阅读更多 →
🗺️ 开发者快速上手路径
1
创建并发布一个表单
在网页界面里搭一个,或用 formlm-cli smart generate 生成一个,然后发布。
2
拿到 Data API 接口
打开发布页,复制接口 URL。加上 ?help 即可阅读它的自述文档。
3
从页面、脚本或 Agent 发 POST
把 form action 或 fetch 调用指向接口——CORS 已开,未知字段自动建列。
4
查询、导出或规模化自动化
经 HTTP 读回记录、在数据界面导出 CSV,或用 formlm-cli 把整个生命周期接进脚本。

开发者常见问题

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

FormLM 提供哪些开发者工具?

两件核心工具。Data API 是一个 HTTP 接口,接收来自任何页面——静态站点、本地文件或 AI 生成的应用——的提交,并支持把记录查询回来。formlm-cli 是开源命令行工具兼 MCP 服务器,让你或 AI Agent 从终端搭建、管理表单。

怎么让我的 AI Agent 用上 FormLM?

两条路。读写数据:给你的 Agent 一个 Data API 接口——它给 URL 加上 ?help 就能读到接口自带的文档,然后直接 POST 记录。搭建与管理表单:安装 formlm-cli 并运行 `formlm-cli mcp`,再连接任何兼容 MCP 的客户端,比如 Claude Desktop、Cursor、Codex CLI、Windsurf、Cline 或 WorkBuddy。

Data API 免费吗?

可以。发布表单、经 Data API 接收提交在免费版即可使用;付费版增加更高量级与团队功能。免费版不按 API 调用收费。

formlm-cli 是开源的吗?

是——formlm-cli 采用 MIT 许可证,以 @formlm/cli 之名发布在 npm 上。源码在 GitHub(github.com/formlm/cli),兼容任何 FormLM 账户,免费付费都能用。

AI Agent 能通过 MCP 服务器做什么?

MCP 服务器暴露八个工具:auth_login、auth_email_code 与 auth_status 负责认证,formlm_generate 从自然语言创建完整评估应用,formlm_execute 逐个执行计划模块,formlm_snapshot 读取所有模块状态,formlm_skill 拉取领域规则文档,formlm_exec 执行任何白名单内的 CLI 命令。另有六个 MCP 资源把技能文档直接暴露给 Agent。

自己的 HTML 页面能用 Data API 吗?

能。在 FormLM 里发布一个表单,复制它的 Data API 接口,让你的页面指向它——原生 HTML form action POST 或 fetch 调用都行。CORS 已开启,静态托管可用,甚至直接从磁盘打开的文件也能用。

← 返回学院首页 探索 Data API →