プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Ikman.lk Marketplace

作者:seyone22バージョン 1.0.0i★ 1iクラウドで動く公式サイト ↗
レジストリ名io.github.seyone22/ikman-gateway

インストール方法

What it does

Search Sri Lanka's ikman.lk classifieds with true price sorting, spam filtering & ad details.

  • Connects クラウドで動く
  • Account or key No key needed
  • Category ネットショップ・決済

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気4/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中8/8前回の確認でクラウドのエンドポイントが応答
利用スコア24/100

品質: 基本チェック 4/4 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Ikman.lk Marketplace をインストールして。https://mcp.popnx.com/i/seyone22-ikman-gateway.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 4/4 合格 · 質問内容は提供元のサーバー(ikman-gateway-production.up.railway.app)を通ります · ✓ コマンド確認済み 2026年11月14日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげます · 約 2 分

キー不要、インストール不要 · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加

  1. Claude の Connectors ページを開く

    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

    Claude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します

  3. チャットで有効にする

    +ConnectorsIkman.lk Marketplace

  4. 試してみる

    Ikman.lk Marketplace を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Ikman.lk Marketplace を使っていると言うか、回答に Ikman.lk Marketplace のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT との接続はプランしだい

フル MCP:Web 版 ChatGPT の Business・Enterprise・Edu · Pro:読み取り/取得の権限で接続、データを変えるツールは使えないことがあります · Plus:公式ドキュメントで未確認。プラグイン画面にカスタム MCP を追加する項目があれば試せます · Web のみ

  1. Web 版 ChatGPT で MCP の追加ページを開く

    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 を使って、私に何ができるか教えて、1 つやってみせて

    ✓ ChatGPT が Ikman.lk Marketplace を使っていると言うか、回答に Ikman.lk Marketplace のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に OpenAI のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Claude Code につなげます · 約 2 分

キー不要、インストール不要

  1. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  2. このコマンドを貼り付けて Enter

    claude mcp add --transport sse --scope user ikman-gateway https://ikman-gateway-production.up.railway.app/mcp/sse
  3. Claude Code で /mcp と入力

    Ikman.lk Marketplace が一覧にあり、接続済みと表示されれば OK です

  4. 試してみる

    Ikman.lk Marketplace を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Ikman.lk Marketplace を使っていると言うか、回答に Ikman.lk Marketplace のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  2. Cursor の AI チャットを Agent モードで開く

  3. 試してみる

    Ikman.lk Marketplace を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Ikman.lk Marketplace を使っていると言うか、回答に Ikman.lk Marketplace のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげます · 約 2 分

キー不要、インストール不要

  1. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  2. VS Code の AI チャットを Agent モードで開く

  3. 試してみる

    Ikman.lk Marketplace を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Ikman.lk Marketplace を使っていると言うか、回答に Ikman.lk Marketplace のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

Web 経由でつなぐアプリ用のアドレス

アドレスhttps://ikman-gateway-production.up.railway.app/mcp/sse

JSON 設定は下の「開発者向け」にあります

つまずいたら?Ikman.lk Marketplace を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

Web 経由

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"
    }
  }
}

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
npm/PyPIにない
接続方法
クラウドで動く
最新バージョンi
1.0.0
レジストリ公開日i
2026年11月14日
コードの最終更新i
2026年11月14日
最終確認
2026年11月14日
作者
seyone22
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

インターネット経由でつなげるアプリ

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

すべてのアプリと長所・短所 →

できること

このサーバーのツール一覧はまだ読み取っていません。エンドポイントは順番にチェックしています。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント seyone22 で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:5 日前

  • ✓ 合格

    ライセンスがある

    MITを使用

  • ✓ 合格

    エンドポイントが応答する

    238ミリ秒で応答(HTTP 200)

  • – 対象外

    OAuthでサインイン

    サインイン不要

  • … 未チェック

    ツールの説明に隠れた指示がない

    まだチェックしていません。エンドポイントをチェックするときにツール一覧を読み取ります

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/seyone22-ikman-gateway.svg)](https://mcp.popnx.com/en/servers/seyone22-ikman-gateway)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

ネットショップ・決済のほかのサーバーとの比較i

  • このカテゴリのほかの2947件のうち89%よりスターが多い
  • このカテゴリのほかの2947件のうち84%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの2947件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Ikman.lk Marketplaceは安全ですか?

当てはまる基本チェック4項目のうち4項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

作者のクラウドで動きます。インストール不要でインターネット経由でつながりますが、送った内容は作者のサーバーを通ります。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は5 日前、最新バージョン(1.0.0)がレジストリに届いたのは5 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。

代わりに使えるものは?

同じカテゴリには:Stripe MCP, flightclaw, Trade It, Marketplace Ad Pros: Amazon Ads & Seller Central, idealo MCP Server

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Stripe MCP

MCP server integrating with Stripe - tools for customers, products, payments, and more.

作者:stripe広く使われている★ 207213 か月前更新

クラウドで動く✓ 提供元 · stripe.com

flightclaw

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

作者:flightclaw成長中★ 862 か月前更新

クラウドで動く✓ 提供元 · flightclaw.com

Trade It

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

作者:trade-it-inc初期★ 6234 日前更新

クラウドで動く✓ 提供元 · tradeit.app

idealo MCP Server

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

作者:idealo初期★ 286 か月前更新

クラウドで動く✓ 提供元 · 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を開く

作者のリポジトリから書かれたとおりにコピーしたものです。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.