Overview
การเชื่อมต่อ AI (MCP)
Connect the official esimoa MCP server so AI assistants can search and compare eSIMs and share purchase links.
Server URL#
เซิร์ฟเวอร์ MCP อย่างเป็นทางการของ esimoa https://api.esimoa.com/mcp ช่วยให้ผู้ช่วย AI ค้นหาและเปรียบเทียบ eSIM รวมถึงแชร์ลิงก์ซื้อได้ ใช้ Streamable HTTP (JSON แบบ stateless) และใช้งานได้โดยไม่ต้องมีคีย์ (120 คำขอ/นาทีต่อ IP)
https://api.esimoa.com/mcpทิป
Adding your partner key#
ทิป
https://api.esimoa.com/mcp?key=esk_live_your_key_hereไคลเอนต์ที่รองรับเฮดเดอร์สามารถส่ง X-API-Key หรือ Authorization: Bearer แทนได้ คีย์ที่ไม่ถูกต้องจะถูกปฏิเสธด้วย 401 — หากต้องการใช้เซิร์ฟเวอร์โดยไม่มีคีย์ ให้ละคีย์ออกทั้งหมด
Available tools#
| ฟิลด์ | ประเภท | คำอธิบาย |
|---|---|---|
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 | รายละเอียด eSIM — id, lang |
compare_esims | tool | เปรียบเทียบแพ็กเกจ 2–5 รายการแบบเคียงข้างกัน — ids (จาก search_esims), 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.com และการ์ดจะไม่รับชำระเงิน
Rate limits#
หมายเหตุ
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 เป็นวินาที การเรียกที่ถูกปฏิเสธจากขีดจำกัดต่อนาทีจะไม่นับรวมในโควตารายชั่วโมง
หากไม่มีคีย์ จำกัด 120 คำขอต่อนาทีต่อ IP หากใช้คีย์พาร์ทเนอร์ จำกัด 600 คำขอต่อนาทีต่อคีย์ การเรียกที่ Claude และ ChatGPT ส่งจากเซิร์ฟเวอร์ของตนจะนับตามแพลตฟอร์ม ไม่ใช่ตาม IP หากเกินจะได้รับข้อผิดพลาด JSON-RPC (-32002) พร้อม HTTP 429
