台灣 SMS API · for developers

簡訊 API,
3 行 code 接完。

REST + SDK (Node / Python / CLI) · 送達率 99.7% · 每月 100 封永久免費 · Webhook + NCC 合規自動 · 15 分鐘從註冊到 production。

Node 18+ SDK Python 3.9+ SDK Webhook HMAC Zero config
send-otp.js · Node.js main
import { Maacgo } from '@maacgo/sms';

const sms = new Maacgo(process.env.MAACGO_API_KEY);

// OTP · 秒送達 · 含 NCC 合規檢查
await sms.send({
  to:   '+886912345678',
  body: `【MAAC GO】驗證碼 ${otp},5 分鐘內有效`,
  type: 'otp',
});
✓ 200 OK { "message_id": "sms_abc123", "status": "delivered", "segments": 1, "cost_cents": 78, "balance_cents": 4922 }
30-SECOND QUICKSTART

從 signup 到 production · 15 分鐘

註冊帶你 auto-generate test API key、給 curl 範例複製到 terminal。正式 API key 在 dashboard 自己開。

# 1. Install SDK
$npm install @maacgo/sms
+ @maacgo/sms@0.1.0

# 2. Set key (from signup response)
$export MAACGO_API_KEY=sk_live_...

# 3. Send
$node -e "import('@maacgo/sms').then(({Maacgo}) => new Maacgo(process.env.MAACGO_API_KEY).send({to:'+886912345678',body:'【demo】hi'}).then(console.log))"
{ status: 'delivered', message_id: 'sms_K8f...', segments: 1, cost_cents: 78 }
✓ 手機收到「【demo】hi」 ✓ Logs 頁即時跳新 row ✓ Webhook 打 sms.delivered
SDKs

你的語言應該有

官方維護 · 同一套 REST API 包好 · 每個 release 都 smoke-test。

Node.js

@maacgo/sms

npm install @maacgo/sms
Python

maacgo-sms

pip install maacgo-sms
CLI

maacgo · beta

npm i -g ./sdk/cli
curl

REST · any language

curl $MAACGO_API_BASE/sms/send
PHP

maacgo/sms · 零相依

require 'sdk/php/src/Maacgo.php';
Go Soon

github.com/maacgo/sms-go

go get github.com/maacgo/sms-go
Ruby Soon

maacgo-sms

gem install maacgo-sms
Rust Soon

maacgo-sms

cargo add maacgo-sms
CLI

Terminal 愛好者看這裡

從 CI/CD 腳本送 OTP、debug 時 maacgo tail live-stream、pipe 到 jq 處理。

# Install
$npm install -g ./sdk/cli
$export MAACGO_API_KEY=sk_live_...

# Send from CI
$maacgo send +886912345678 "【demo】deploy succeeded 🚀"
✓ delivered sms_K8fQx32Lm 1 seg NT$0.78

# Live-tail all outgoing messages
$maacgo tail
Tailing logs... (Ctrl-C to stop)
09:41:02 delivered +886912...637 【demo】deploy succeeded 🚀
09:41:23 delivered +886912...981 【demo】alert: CPU > 90%

# Metrics for billing reconciliation
$maacgo metrics --days 30 --json | jq '.totals'
{ "total": 4312, "delivered": 4289, "failed": 23, "cost_cents": 323400 }
完整 commands:send · broadcast · logs · tail · balance · metrics · whoami
Features

台灣在地 SMS API

三大電信直連、中文 NCC 合規、台北 team 工作日 4h 回信。

Webhook with retry

送達 / 失敗事件自動 POST 你的 endpoint · HMAC-SHA256 簽章 · 失敗指數退避 3 次 0s → 2s → 8s

NCC 合規自動

URL 白名單、禁用縮網址(bit.ly / reurl.cc...)、詐騙關鍵字、實名簽檔自動插入。ncc_blocked error 告訴你哪裡違規。

Live logs + metrics

Dashboard 每 3s poll 新訊息 · 7 天送達率 / 失敗原因 / 成本 breakdown · GET /sms/metrics?days=30

Rate limit 清楚

新帳號 24h 內 200 則、穩定帳號 1000/hr。超量回 429retry_after。不是黑箱。

Atomic wallet debit

送成功才扣 · 電信商失敗自動 refund · wallet_events 完整 ledger · 對帳 API 查得到每一筆。

中文客服

info@cresclab.com 工作日 4h 內回信 · 有 bug 直接 email source repro · 不是外包 ticket system。

For AI agents

Cursor / Claude / Windsurf / Codex 直接串

OpenAPI 3.0 spec、llms.txt 索引、MCP server(stdio + HTTP)、Codex skill — 四種入口挑一種。

OPENAPI
https://sms.cresclab.com/openapi.yaml
LLMS.TXT
https://sms.cresclab.com/llms.txt
CODEX
https://sms.cresclab.com/codex.html 開啟
MCP
9 個工具 · stdio (@maacgo/mcp) 或 HTTP JSON-RPC 都行
{ "mcpServers": { "maacgo": { "command": "npx", "args": ["-y", "@maacgo/mcp"], "env": { "MAACGO_API_KEY": "sk_..." } } } }
Scopes 由 API key 決定:sms.read-only 的 key 無法呼叫 send_sms
API surface

9 個 endpoint,全 REST

完整欄位說明到 app.html#docs

POST/api/sms/send送一封
GET/api/sms/:id查一封
GET/api/sms/list查 log 列表
GET/api/sms/metrics統計資料
POST/api/broadcast1:N 廣播
GET/api/broadcast廣播列表
GET/api/wallet/balance餘額
GET/api/wallet/events交易紀錄
PUT/api/webhooks設 webhook

Free for developers · 上 production 再付錢

沒有時限、沒有信用卡綁定、沒有 email 騷擾。用到上限再開單。

NT$0/月 · 前 100 封 NT$0.78/則 · 超過後按量 議價 · 月量 > 50k

15 分鐘後你應該
已經送出 第一封 SMS

不信?現在試。不用信用卡、送你 NT$50 credit、失敗 email 我們回 4 小時內。

用 GitHub 開通 → Full API docs