⌨️

開發者專區

用程式碼構建 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 列印讓產生內容保持規範的領域規則文件。

MCP 伺服器:讓 AI Agent 駕馭 FormLM

stdio 傳輸 · 8 個工具 · 6 個資源 · 相容任何 MCP 用戶端。

執行 formlm-cli mcp,CLI 就成為標準MCP 伺服器。接上 Claude Desktop、Cursor、Codex CLI、Windsurf、Cline——或任何相容 MCP 的用戶端——Agent 便能以對話方式搭建、檢視、發布你的表單;平台的 P0 約束嵌在每個工具描述裡,讓它不跑偏。

工具層級Agent 能做什麼
auth_login / auth_email_code / auth_status0用存取權杖(推薦)、信箱驗證碼、或信箱 + 密碼認證
formlm_generate1從自然語言產生完整應用(AssessAgent 管線)
formlm_snapshot2一次呼叫讀取所有模組的彙總狀態
formlm_skill2擷取任意模組的 SKILL.md 領域規則
formlm_exec3直接執行任何白名單內的 CLI 命令

六個 MCP 資源(formlm://skills/form、scale、connect、report、expert、share)開放的正是平台自家 Agent 在用的領域知識——你的 AI 先讀規則,再寫設定。完整的設定說明——含 macOS 桌面用戶端的 PATH 修正與各平台設定檔位置——見 GitHub 上的 INSTALL 指南。

🗺️ 開發者快速入門路徑
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。

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 →