概覽
AI 整合(MCP)
連接 esimoa 官方 MCP 伺服器,AI 即可搜尋、比較 eSIM 並提供購買連結。
伺服器網址#
esimoa 官方 MCP 伺服器 https://api.esimoa.com/mcp,AI 即可搜尋、比較 eSIM 並提供購買連結。採用 Streamable HTTP(無狀態 JSON),無需金鑰也可使用(每個 IP 每分鐘 120 次)。
https://api.esimoa.com/mcp提示
填入合作夥伴金鑰#
提示
https://api.esimoa.com/mcp?key=esk_live_your_key_here支援標頭的用戶端也可以透過 X-API-Key 或 Authorization: Bearer 傳送。錯誤的金鑰會被 401 拒絕,若不使用金鑰請完全移除。
可用工具#
| 欄位 | 類型 | 說明 |
|---|---|---|
search_esims | tool | 搜尋 eSIM — country(ISO 代碼或任何語言的國家名)·countries(多國同時)、days、data_gb·max_data_gb、unlimited、data_type(daily|total)、local_number(當地號碼)、network(local|roaming)、multi_country、min_price_krw·max_price_krw、provider、hotspot·five_g、sort、limit(≤10)、lang |
get_esim | tool | 商品詳情 — id、lang |
compare_esims | tool | 並排比較 2–5 個方案 — ids(來自 search_esims 的 id)、lang。指出價格最低、流量最多、效期最長和每 GB 價格最低的方案 |
list_countries | tool | 販售國家 — query、lang |
search / fetch | tool | ChatGPT 相容工具 — search {query}(自由文字:可辨識無限流量、每日、當地號碼、當地網路、熱點和 5G),fetch {id} |
在支援 MCP Apps 的應用程式(如 Claude、ChatGPT、VS Code)中,search_esims、get_esim、compare_esims 的結果會以方案卡片顯示。點擊「查看方案」會開啟 esimoa 的商品頁面,卡片本身不進行付款。
速率限制#
注意
公開 API 與已驗證 MCP 共用每個夥伴的每小時配額(預設 20,000 次),新增或輪替金鑰不會增加配額。
從首次請求起計 3,600 秒,並同時套用每分鐘限制。計算呼叫次數而非傳輸 MB,實際配額可由營運設定調整。
MCP 批次請求最多 100 則訊息,每則計為一次呼叫。超出剩餘配額時,在執行前回傳 429。
X-RateLimit-Hour-Limit · X-RateLimit-Hour-Remaining · X-RateLimit-Hour-Reset
這些標頭表示每小時上限、剩餘次數及重設時間(Unix 秒)。超限回傳 HTTP 429 和 Retry-After 秒數。每分鐘限制拒絕的請求不計入小時配額。
不使用金鑰時每個 IP 每分鐘 120 次,使用合作夥伴金鑰時每組金鑰每分鐘 600 次。Claude、ChatGPT 從自己的伺服器發出的呼叫按平台而非 IP 計算。超出後回傳 JSON-RPC 錯誤(-32002)與 HTTP 429。
