概览
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。
