ต้นแบบ · รุ่นทดลอง: มีทุก server ในทะเบียนทางการ อัปเดตทุก 30 นาที เข้าสู่ระบบด้วย Google เพื่อเขียนรีวิวได้แล้วต้นแบบ · อัปเดตทุก 30 นาที
PopNx MCPที่รวม MCP สำหรับคนใช้ AI · วิธีติดตั้งภาษาไทยทุกตัว

Ikman.lk Marketplace

โดย seyone22รุ่น 1.0.0i★ 1iรันบนคลาวด์เว็บทางการ ↗
ชื่อใน registryio.github.seyone22/ikman-gateway

วิธีติดตั้ง

ใช้ทำอะไรได้

ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ

  • ต่อแบบ คลาวด์ (ต่อผ่านอินเทอร์เน็ต)
  • บัญชีหรือคีย์ ไม่ต้องใส่คีย์
  • หมวด ร้านค้าออนไลน์และรับเงิน
คำอธิบายต้นฉบับจากผู้ทำ (อังกฤษ)
Search Sri Lanka's ikman.lk classifieds with true price sorting, spam filtering & ad details.

ทำไมอยู่อันดับนี้

หน้ารายการเรียงด้วยคะแนนการใช้งาน (เต็ม 100) จากส่วนเหล่านี้

ความนิยม4/80ดาว GitHub หรือยอดดาวน์โหลดต่อสัปดาห์ ค่ามากนับ 60 ค่าน้อยนับ 20
ความสด12/12ออกรุ่นหรือแก้โค้ดใน 30 วัน ได้เต็ม
ระบบยังตอบ8/8endpoint บนคลาวด์ตอบตอนตรวจล่าสุด
คะแนนการใช้งาน24/100

คุณภาพ: ผลตรวจเบื้องต้นผ่าน 4/4 ข้อ (แสดงให้ดู ไม่ได้ใช้เรียง) · ความมาแรง: ยังไม่มีข้อมูล (ใช้เรียงเฉพาะแท็บมาแรง)

ติดตั้ง

เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง

ให้ AI ติดตั้งให้ด้วยประโยคเดียว

ติดตั้ง Ikman.lk Marketplace ให้หน่อย ทำตาม https://mcp.popnx.com/i/seyone22-ikman-gateway.md แสดงคำสั่งให้ฉันดูและรอฉันตกลงก่อนรัน

คัดลอกไปวางในแชตของ AI ที่ทำงานในเครื่องคุณได้ (เช่น Claude Code, Cursor) · AI จะอ่านขั้นตอนจากเรา แสดงคำสั่งให้ดู และรอคุณตกลงก่อน · ไม่ต้องใช้คีย์ ไม่ต้องสมัคร · ดูข้อความเต็มที่ AI จะอ่าน

ผลตรวจผ่าน 4/4 · สิ่งที่คุณถามผ่านเซิร์ฟเวอร์ของผู้ทำ (ikman-gateway-production.up.railway.app) · ✓ ตรวจคำสั่งแล้ว 14 พ.ย. 2569

ขั้นแรก: คุณใช้ AI ตัวไหน

เลือกแอปที่คุณใช้ ขั้นตอนจะขึ้นด้านล่าง

ต่อกับ Claude ได้ · ประมาณ 2 นาที

ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม · ตั้งครั้งเดียวที่ claude.ai หรือแอปบนคอม แล้วใช้ในแชตได้ · บัญชีฟรีเพิ่มได้ 1 ตัว · แผน Team/Enterprise ให้เจ้าของ (Owner) เป็นคนเพิ่ม

  1. เปิดหน้า Connectors ของ Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. กด “Add” → “Custom” → “Web” แล้วกรอก 2 ช่องนี้

    คัดลอกจากที่นี่ไปวางในช่องชื่อเดียวกันบนหน้าจอของ Claude แล้วกด Continue

    Name · ชื่อIkman.lk Marketplace
    Remote MCP server URL · ที่อยู่https://ikman-gateway-production.up.railway.app/mcp/sse

    กด Continue ผ่านหน้าตรวจการล็อกอินที่ Claude ตรวจเจอ · หัวข้อ Authentication เลือกตามที่ผู้ทำบอก (Sign in now, Sign in when needed หรือ No sign in) แล้วกด Add

  3. เปิดใช้ในแชต

    +ConnectorsIkman.lk Marketplace

  4. ลองเลย

    ใช้ Ikman.lk Marketplace บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า Claude บอกว่ากำลังใช้ Ikman.lk Marketplace หรือมีชื่อเครื่องมือของ Ikman.lk Marketplace ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ ChatGPT ได้ ขึ้นกับแผน

MCP แบบเต็ม: ChatGPT Business, Enterprise หรือ Edu บนเว็บ · Pro: ต่อได้ด้วยสิทธิ์อ่านและดึงข้อมูล เครื่องมือที่แก้ข้อมูลอาจใช้ไม่ได้ · Plus: เอกสารยังไม่ยืนยัน ถ้าเห็นเมนูเพิ่ม MCP แบบกำหนดเองในหน้าปลั๊กอิน ลองตามขั้นตอนได้ · ใช้บนเว็บเท่านั้น

  1. เปิดหน้าเพิ่ม MCP ของ ChatGPT บนเว็บ

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. กรอกชื่อและที่อยู่

    ใส่ชื่อ แล้ววางที่อยู่ใต้ Connection ติ๊กยอมรับคำเตือน แล้วกด Create as a plugin

    Name · ชื่อIkman.lk Marketplace
    Connection · ที่อยู่https://ikman-gateway-production.up.railway.app/mcp/sse
  3. เลือก Ikman.lk Marketplace ในแชต

    เปิดแชตใหม่แล้วเลือก Ikman.lk Marketplace จากรายการปลั๊กอินก่อนพิมพ์

  4. ลองเลย

    ใช้ Ikman.lk Marketplace บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า ChatGPT บอกว่ากำลังใช้ Ikman.lk Marketplace หรือมีชื่อเครื่องมือของ Ikman.lk Marketplace ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ OpenAI เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ Claude Code ได้ · ประมาณ 2 นาที

ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม

  1. เปิด Terminal

    Mac: กด Command+Space พิมพ์ Terminal · Windows: เปิด PowerShell

  2. วางคำสั่งนี้แล้วกด Enter

    claude mcp add --transport sse --scope user ikman-gateway https://ikman-gateway-production.up.railway.app/mcp/sse
  3. พิมพ์ /mcp ใน Claude Code

    ต้องเห็น Ikman.lk Marketplace ในรายการและขึ้นว่าเชื่อมต่อแล้ว

  4. ลองเลย

    ใช้ Ikman.lk Marketplace บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า Claude Code บอกว่ากำลังใช้ Ikman.lk Marketplace หรือมีชื่อเครื่องมือของ Ikman.lk Marketplace ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ Cursor ได้ · ประมาณ 2 นาที

ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม

  1. กดปุ่มนี้เพื่อเปิด Cursor

    เปิดใน Cursor

    Cursor จะถามยืนยันการติดตั้ง ให้กด Install

  2. เปิดแชตของ AI ใน Cursor โหมด Agent

  3. ลองเลย

    ใช้ Ikman.lk Marketplace บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า Cursor บอกว่ากำลังใช้ Ikman.lk Marketplace หรือมีชื่อเครื่องมือของ Ikman.lk Marketplace ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Cursor เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

ต่อกับ VS Code ได้ · ประมาณ 2 นาที

ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม

  1. กดปุ่มนี้เพื่อเปิด VS Code

    เปิดใน VS Code

    VS Code จะถามยืนยันการติดตั้ง ให้กด Install

  2. เปิดแชตของ AI ใน VS Code โหมด Agent

  3. ลองเลย

    ใช้ Ikman.lk Marketplace บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง

    ✓ ถ้า VS Code บอกว่ากำลังใช้ Ikman.lk Marketplace หรือมีชื่อเครื่องมือของ Ikman.lk Marketplace ขึ้นในคำตอบ แปลว่าต่อสำเร็จ

ชื่อเมนูตรวจกับหน้าช่วยเหลือของ VS Code เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป

โปรแกรมอื่นที่ใช้ MCP ได้ เช่น Windsurf, Zed หรือ Gemini CLI มีวิธีเพิ่มต่างกัน ดูวิธีของแต่ละตัวในหน้ารวมโปรแกรม

ดูโปรแกรมที่ใช้ MCP ทั้งหมด →

ที่อยู่สำหรับโปรแกรมที่ต่อผ่านเว็บ

ที่อยู่https://ikman-gateway-production.up.railway.app/mcp/sse

ค่าตั้งแบบไฟล์ JSON อยู่ในหัวข้อ “สำหรับคนเขียนโค้ด” ด้านล่าง

ติดตรงไหน? ถามคนที่ใช้ Ikman.lk Marketplace อยู่💬 พูดคุย →
สำหรับคนเขียนโค้ด: คำสั่ง Terminal และค่าตั้ง JSON

ต่อผ่านเว็บ

Claude Code

claude mcp add --transport sse --scope user ikman-gateway https://ikman-gateway-production.up.railway.app/mcp/sse

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "ikman-gateway": {
      "url": "https://ikman-gateway-production.up.railway.app/mcp/sse"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "ikman-gateway": {
      "type": "sse",
      "url": "https://ikman-gateway-production.up.railway.app/mcp/sse"
    }
  }
}

ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README

สรุป

ดาวน์โหลดต่อสัปดาห์i
ไม่มียอดใน npm/PyPI
การเชื่อมต่อ
รันบนคลาวด์
รุ่นล่าสุดi
1.0.0
ส่งเข้า registryi
14 พ.ย. 2569
แก้โค้ดล่าสุดi
14 พ.ย. 2569
ตรวจล่าสุดเมื่อ
14 พ.ย. 2569
ผู้ทำ
seyone22
เว็บผู้ทำ
ikman-gateway-production.up.railway.app
สถานะใน registry
ใช้งานอยู่

ใช้กับโปรแกรมไหนได้

ดูจากแบบการต่อของ server ตัวนี้ และเอกสารของผู้ทำโปรแกรมแต่ละตัว ตรวจเมื่อ 10 พ.ย. 2569

ต่อผ่านคลาวด์ได้ใน

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

ดูโปรแกรมทั้งหมดพร้อมข้อดีข้อเสีย →

คู่มือที่เกี่ยวข้อง

ทำอะไรได้บ้าง

ยังไม่ได้อ่านรายการเครื่องมือของตัวนี้ เราตรวจ endpoint ทีละชุดวนไป

ผลตรวจเบื้องต้นi

เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 19 พ.ย. 2569

  • ✓ ผ่าน

    ตัวตนผู้ทำตรงกับ repo

    ชื่อใน registry ยืนยันด้วยบัญชี GitHub seyone22 ซึ่งเป็นเจ้าของ repo

  • ✓ ผ่าน

    ยังมีคนดูแล

    มีการแก้โค้ดล่าสุด 5 วันที่ผ่านมา

  • ✓ ผ่าน

    มีสัญญาอนุญาต (license)

    ใช้ MIT

  • ✓ ผ่าน

    endpoint ตอบ

    ตอบกลับใน 238 ms (HTTP 200)

  • – ไม่เกี่ยว

    ล็อกอินแบบ OAuth

    ไม่ต้องล็อกอิน

  • … ยังไม่ตรวจ

    คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง

    ยังไม่ได้ตรวจ เราอ่านรายการเครื่องมือตอนตรวจ endpoint

เราตรวจอะไรบ้าง → · JSON

ผู้ทำ: ขอให้ตรวจใหม่ หรือแจ้งข้อมูลผิด
สำหรับผู้ทำ: ติดป้ายใน README

ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้

[![แนะนำบน PopNx MCP](https://mcp.popnx.com/badge/seyone22-ikman-gateway.svg?lang=th)](https://mcp.popnx.com/th/servers/seyone22-ikman-gateway)

พูดคุย

ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์

ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย

ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx

เข้าสู่ระบบเพื่อโพสต์

รีวิวจากผู้ใช้

ยังไม่มีรีวิว

เข้าสู่ระบบเพื่อเขียนรีวิว

เทียบกับตัวอื่นในหมวด ร้านค้าออนไลน์และรับเงินi

  • ดาวมากกว่า 89% ของอีก 2947 ตัวในหมวดนี้
  • ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 84% ของอีก 2947 ตัวในหมวดนี้
  • ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 99% ของอีก 2947 ตัวในหมวดนี้

เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo

คำถามที่พบบ่อย

Ikman.lk Marketplace ปลอดภัยไหม?

จากการตรวจเบื้องต้นของเรา ผ่าน 4 จาก 4 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น

ต้องใช้กุญแจหรือรหัสอะไรบ้าง?

registry ไม่ได้ระบุว่าต้องใช้กุญแจ แต่บางตัวจะขอให้ล็อกอินตอนใช้ครั้งแรก

ตัวนี้รันบนเครื่องหรือบนคลาวด์?

รันบนคลาวด์ของผู้ทำ ต่อผ่านอินเทอร์เน็ตได้เลย ไม่ต้องลงโปรแกรม แต่ข้อมูลที่ส่งให้จะผ่านเซิร์ฟเวอร์ของผู้ทำ

ยังมีคนดูแลอยู่ไหม?

repo บน GitHub มีการแก้โค้ดล่าสุด 5 วันที่ผ่านมา และส่งรุ่นล่าสุด (1.0.0) เข้า registry 5 วันที่ผ่านมา

ใช้กับโปรแกรมไหนได้บ้าง?

โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต่อผ่าน URL จึงใช้กับโปรแกรมที่รับ remote MCP ได้ เช่น ChatGPT บนเว็บ (แบบเต็มในแผน Business ขึ้นไป · Pro แบบอ่านอย่างเดียว)

มีตัวไหนใช้แทนได้บ้าง?

ในหมวดเดียวกันมี Stripe MCP, flightclaw, Trade It, Marketplace Ad Pros: Amazon Ads & Seller Central, idealo MCP Server

ตัวอื่นที่ทำงานคล้ายกัน

หมวดเดียวกันจากผู้ทำคนอื่น ผ่านตัวตรวจคำสั่งแล้ว ตัวทางการขึ้นก่อน แล้วเรียงตามดาว

อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi

Stripe MCP

server ทางการของ Stripe ให้ AI ดูและจัดการลูกค้า สินค้า การชำระเงิน และใบแจ้งหนี้ ต่อผ่านคลาวด์ของ Stripe และล็อกอินแบบ OAuth

โดย stripeใช้กันมาก★ 2.1Kอัปเดต 13 เดือนที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · stripe.com

flightclaw

Search ~300 airlines and book flights with a checkout link. OAuth sign-in by email code.

โดย flightclawกำลังโต★ 86อัปเดต 2 เดือนที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · flightclaw.com

Trade It

Connect brokerage accounts to AI assistants: holdings, orders, asset lookup, and approved trading.

โดย trade-it-incเริ่มต้น★ 62อัปเดต 34 วันที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · tradeit.app

idealo MCP Server

Search products, compare prices and discover deals across 6 European markets with your AI assistant.

โดย idealoเริ่มต้น★ 28อัปเดต 6 เดือนที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · mcp.idealo.com
เทียบกับตัวที่คล้ายกัน
ตัวนี้
Ikman.lk Marketplace
Stripe MCPflightclawTrade ItMarketplace Ad Pros: Amazon Ads & Seller Centralidealo MCP Server
ทำงานที่ไหนใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่องใช้บนคลาวด์ ไม่ต้องลงเครื่อง
ต้องใส่คีย์ไม่ไม่ไม่ไม่ไม่ไม่
กด + ใน Claude ได้ไม่ใช่ไม่ไม่ไม่ไม่
ผลตรวจเบื้องต้น4/44/44/45/54/44/4
สัญญาอนุญาตMITMITMITCC0-1.0MITMIT
ราคาไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียนไม่พบค่าใช้จ่ายในทะเบียน

README จากผู้ทำ

เปิดอ่าน README

ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ

Ikman Gateway & Headless MCP Server

A clean, production-grade RESTful API Gateway and Model Context Protocol (MCP) Server for Sri Lanka's largest marketplace (ikman.lk).

Live API Docs • MCP SSE Endpoint • Architecture • Getting Started • MCP Setup


Why This Exists

*"I just wanted to buy a tablet online, but the user experience on ikman.lk was so frustratingly bad that I had to reverse-engineer their platform and build a proper API gateway for it."*

ikman.lk is Sri Lanka’s dominant online classifieds marketplace. Despite having high listing volume, the site is notoriously painful to use:

The Problem on ikman.lkHow Ikman Gateway Solves It
No "Sort by Cheapest" Option: The UI dropdown only shows Date: Newest on top. You cannot sort low-to-high to find bargains.Unlocks Native Price Sorting: Reverse-engineers the search backend's hidden sort=price&order=asc parameter.
Rampant Dummy Price Spam: Sellers post Rs. 0, Rs. 1, or Rs. 20 listings to manipulate searches.Automatic Spam Sanitization: Automatically detects and filters out placeholder prices when sorting by cheapest.
Hidden Seller Phone Numbers: Buying requires navigating through ads, solving captchas, or expanding contact forms.Direct Contact Extraction: Directly extracts verified seller phone numbers, shop names, and physical addresses.
Bloated Payloads: ikman injects ~500 KB of raw, chaotic JSON into tags on every HTML page load.Normalized, Typed DTOs: Transforms chaotic upstream payloads into clean, camelCase, strongly-typed JSON.
No Developer or AI Tooling: No public API exists for developers or AI assistants.Dual REST + Headless MCP Server: Exposes Swagger-documented REST endpoints and tools for Claude, Cursor, & Antigravity.
Aggressive Cloudflare Blocks: Scraping HTML triggers IP bans and challenge pages.Resilient HTTP Engine with In-Memory Caching: Smart browser fingerprinting and TTL caching to keep upstream happy.

Live Production Deployment (Railway)

The service is deployed live on Railway in the Southeast Asia (Singapore) region:


Architecture

flowchart TD

subgraph Clients["Clients"] WebClient["Web & Mobile Applications"] AIDesktop["Claude Desktop / Cursor (Stdio)"] AIRemote["Antigravity / Remote Agents (SSE)"] end

subgraph Gateway["Ikman Gateway (NestJS)"] RESTCtrl["REST Controllers (/api/v1)"] MCPSse["MCP SSE Server (/mcp/sse)"] MCPStdio["MCP Stdio Runner"] Swagger["Swagger UI (/api/docs)"] Validation["DTO Validation Pipes"] Cache["In-Memory Cache (TTL)"] Client["IkmanClientService"] Normalizer["IkmanNormalizerService"] end

subgraph Upstream["ikman.lk Backend"] SerpAPI["Search SERP API"] DetailAPI["Listing Details API"] TaxonomyAPI["Categories & Locations API"] end

WebClient --> RESTCtrl AIRemote --> MCPSse AIDesktop --> MCPStdio

RESTCtrl --> Validation MCPSse --> Validation Validation --> Cache Cache --> Client MCPStdio --> Client

Client --> Upstream Client --> Normalizer

Technical Highlights
  • Framework: NestJS 10 with Fastify/Express engine & Modular Architecture.
  • Typing & Validation: TypeScript 5, class-validator, class-transformer with runtime DTO coercion.
  • MCP Specification: Built on official @modelcontextprotocol/sdk supporting both stateful SSE (Server-Sent Events) and Stdio transports.
  • Taxonomy Engine: Self-hydrating in-memory taxonomy map translating human-friendly slugs (mobile-phones, colombo) to ikman internal numeric IDs (2003, 1506).
  • Caching Strategy: In-memory TTL caching (2 minutes for search queries, 1 hour for categories/locations).

Using as an MCP Server

The server provides 4 specialized MCP tools:

  1. `ikman_search_ads`: Search classifieds with keyword, category, location, min/max price, condition, and sorting (cheapest, expensive, newest).
  2. `ikman_get_ad_details`: Retrieve full specifications, high-res photos, verified seller phone numbers, and shop details.
  3. `ikman_list_categories`: Explore 296 category and subcategory slugs.
  4. `ikman_list_locations`: Explore 27 districts and 332 cities/suburbs.
A. Claude Desktop Integration (via npx)

Add to your claude_desktop_config.json:

{

"mcpServers": { "ikman": { "command": "npx", "args": ["-y", "ikman-gateway"] } } }

*(Or from a local build: "command": "node", "args": [" /dist/bin/mcp-stdio.js"])*

B. Cursor Integration
  1. Go to Settings -> Features -> MCP -> Add New MCP Server.
  2. Name: ikman
  3. Type: command
  4. Command: npx -y ikman-gateway
C. Antigravity / Remote SSE Integration

In your ~/.gemini/config/mcp_config.json:

{

"mcpServers": { "ikman": { "command": "node", "args": [ "path/to/mcp-bridge.js", "--url", "https://ikman-gateway-production.up.railway.app/mcp/sse" ] } } }


REST API Reference

1. Search Listings with True Price Sorting
GET /api/v1/ads?category=mobile-phones&location=colombo&sortBy=cheapest&minPrice=5000 HTTP/1.1

Host: ikman-gateway-production.up.railway.app

Query Parameters:
ParameterTypeDefaultDescription
querystring-Keyword (e.g. Galaxy Tab S11, Civic, MacBook)
categorystring-Category slug or ID (e.g. mobile-phones, computers-tablets)
locationstring-District or city slug (e.g. colombo, kandy, gampaha)
sortBystringnewestcheapest *(price asc)*, expensive *(price desc)*, newest *(date desc)*
minPricenumber-Minimum price in LKR
maxPricenumber-Maximum price in LKR
conditionstring-new, used, refurbished
cleanSpambooleantrueAutomatically discards Rs. 0/1 placeholder spam ads
pagenumber1Pagination page number
Sample Response:
{

"data": [ { "id": "6a80014f6693d235047d9b65", "slug": "samsung-galaxy-tab-s11-8-128gb-for-sale-colombo", "title": "Samsung Galaxy TAB S11 8/128GB", "price": { "amount": 235935, "currency": "LKR", "formatted": "Rs 235,935", "isNegotiable": false, "isSpamOrDummy": false }, "thumbnailUrl": "https://i.ikman-st.com/.../620/465/cropped.jpg", "location": { "name": "Colombo" }, "category": { "id": 898, "name": "Computers & Tablets" }, "isPromoted": false, "isMember": true, "isVerified": true, "postedAt": "2 months", "shopName": "Mobile Care", "url": "https://ikman.lk/en/ad/samsung-galaxy-tab-s11-8-128gb-for-sale-colombo" } ], "meta": { "total": 38, "page": 1, "pageSize": 25, "totalPages": 2, "hasNext": true, "hasPrev": false } }


2. Single Ad Detail (with Direct Seller Phones)
GET /api/v1/ads/samsung-galaxy-tab-s11-12gb-128gb-for-sale-colombo-35 HTTP/1.1

Host: ikman-gateway-production.up.railway.app

Sample Response:
{

"title": "Samsung Galaxy Tab S11 12GB 128GB", "price": { "amount": 232990, "currency": "LKR", "formatted": "Rs 232,990" }, "description": "Brand New Sealed Pack...", "images": [ "https://i.ikman-st.com/.../620/465/cropped.jpg" ], "specs": { "Condition": "Brand New", "Device type": "Tablet", "Brand": "Samsung", "Model": "GALAXY TAB S11 12GB" }, "seller": { "name": "X Mobile - Liberty", "phoneNumbers": [ "0705775555", "0722745842" ], "isMember": true, "isVerified": true, "shop": { "name": "X Mobile - Liberty", "slug": "x-mobileliberty" } } }


3. Categories & Locations Taxonomy
GET /api/v1/categories

GET /api/v1/locations


Local Development

Prerequisites
  • Node.js >= 18.x
  • npm >= 9.x
Setup & Run
# Clone the repository

git clone https://github.com/seyone22/ikman-gateway.git cd ikman-gateway

Install dependencies

npm install

Start development server

npm run start:dev

Run unit & integration tests

npm test

Build for production

npm run build

Start production server

npm run start:prod

Run MCP server locally via Stdio

npm run mcp:stdio


Testing

The repository includes a comprehensive Jest test suite:

npm test
  • `ikman-normalizer.service.spec.ts`: Verifies price parsing, dummy spam identification, image URL resolution, spec dictionary mapping, and contact extraction.
  • `ads.service.spec.ts`: Verifies cheapest price sorting, pagination calculation, and automatic spam price purging.

License

This project is licensed under the MIT License.