⌨️

開發者專區

用程式碼構建 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 與程式代理自己完成儲存整合。
📄 文件 閱讀更多 →
🌐 靜態網站
給靜態網站加表單,無需後端
靜態網站收表單無需後端:把 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 →