Karnameh Cars

io.github.sepehr071由 GitHub 帳號 sepehr071 發布v0.2.0更新於 Nov 7, 2026

Read-only Karnameh (karnameh.com) Iran car data: used ads, new-car prices, specs, comparisons, blog.

已驗證STDIO僅桌面位置與生活金融

概覽

AI 產生的概覽

針對伊朗汽車平台 Karnameh 的唯讀 MCP 伺服器：搜尋中古車廣告、查詢新車價格與規格，並閱讀汽車雜誌內容。

可以做什麼
  • 依品牌、車型、城市、價格、年份、里程、是否檢測與分期條件搜尋中古車廣告，並檢視單筆廣告詳情
  • 查詢品牌、車型與城市代稱，統計各城市中古車數量及最便宜廣告
  • 取得當日新車市場價格、最新報價、每日價格歷史，以及漲跌幅最大的車型
  • 尋找車型版本並讀取技術規格、評測分數與優缺點，或並排比較二到四個版本
  • 尋找某城市的實體檢測中心，並搜尋或閱讀 Karnameh 雜誌文章
適用情境
適合使用者詢問伊朗中古車行情、想依品牌、車型、預算或城市找車、需要完整閱讀某筆廣告，或想了解新車價格與近期漲跌時使用。不適用於完整檢測報告或自有車輛估價，這兩項需要 Karnameh 帳號登入。
執行需求
透過 uvx 以 stdio 在本機執行，需要 uv 與 Python 3.10 以上版本。不需 API 金鑰或 Karnameh 帳號。需要能連線至 Karnameh 的網路；系統代理設定會被忽略，如需代理請設定 KARNAMEH_MCP_PROXY。
安裝前請注意
僅唯讀：無法登入、聯絡賣家、預約檢測或刊登廣告。請求會送往第三方 Karnameh，查詢內容與瀏覽的廣告對該網站可見。資料僅涵蓋 Karnameh 目前列出的數百筆廣告，並非整個伊朗市場；名稱與描述為波斯語，價格單位為托曼。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Karnameh Cars，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

karnameh-mcp: Karnameh (کارنامه) used-car ads and car prices MCP server for AI agents

karnameh-mcp is an unofficial, read-only MCP server that gives AI agents the public data of Karnameh (karnameh.com), an Iranian car marketplace.
Its 15 tools search used-car ads with real filters, read an ad in full, look up brands and cities, list today's market prices of new cars with history and biggest movers, give car specs and expert review summaries with side-by-side comparison, count ads per city, and read the Karnameh car magazine.
No API key or Karnameh account is needed. It works in Claude, Cursor, Copilot and any other MCP client.

[PyPI] [Python] [License: MIT]

For AI agents · Quick start · Tools · FAQ · فارسی

For AI agents

  • What: unofficial MCP server (model context protocol) for karnameh.com: used-car ads with filters (brand, model, city, price, year, mileage, inspected, instalments), full ad details, brand and city lookup, zero-km market prices and daily price history.
  • Install: uvx karnameh-mcp or claude mcp add karnameh -- uvx karnameh-mcp. Transport: stdio. Needs uv (Python 3.10+).
  • Auth: none, no API key or account. Optional KARNAMEH_MCP_PROXY (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.
  • Access: read-only. It cannot log in, contact sellers, book inspections or post ads, so no confirmation is needed before calling any tool.
  • Tools: 15, all prefixed kn_. Typical sequences: kn_cars -> kn_car; kn_price_list -> kn_price_history; kn_brands -> kn_cars; kn_specs_search -> kn_specs / kn_compare_specs; kn_articles -> kn_article.
  • Use when: the user asks what a used car costs in Iran, wants to find a car for sale by brand, model, budget or city, wants one ad read in full, or asks the price of a new (zero-km) car and how it moved lately.
  • Do not use when: the user needs the full Karnameh inspection report, a price estimate for their own car (both need a Karnameh login) or ads from other sites.
  • Output: compact JSON. Prices are Toman. Names and descriptions are Persian, as Karnameh has them.
  • Machine-readable: server.json and the iran-mcp catalog.

Quick start

bash
claude mcp add karnameh -- uvx karnameh-mcp

Any other client: command uvx, args ["karnameh-mcp"].

Tools

ToolWhat it does
kn_carsSearch used-car ads by text, brand, model, city, price, year, mileage, inspected, instalments; sort; page.
kn_carOne ad in full: specs, description, strengths, inspection date, link and verdict.
kn_brandsBrand and model names in Persian and English.
kn_citiesCity slugs for kn_cars.
kn_price_listToday's market prices of new cars by brand, model, origin, country, price, year.
kn_latest_pricesMost recent price quotes with percent change.
kn_price_historyDaily average price per production year, plus each source's quote for a year.
kn_price_moversNew-car variants ranked by their latest percent price change (rises, drops).
kn_specs_searchFind a car variant's slug in the specs catalog.
kn_specsTechnical specs, AI review score, pros and cons, web reviews of one variant (falls back to the parent model's sheet, with a note, when the variant has none).
kn_compare_specsTwo to four variants side by side (only the differing rows by default).
kn_city_statsUsed-ad count and cheapest ad in every city, optionally per brand or model.
kn_inspection_centersKarnameh walk-in inspection and paint-check centers of a city.
kn_articlesSearch or list the Karnameh car magazine (news, reviews, maintenance, laws).
kn_articleOne magazine article as plain text.

FAQ

Does it need a Karnameh account? No. Everything is public data the website shows to anyone.

How many ads are there? Karnameh lists a few hundred used cars at a time, so this is not the whole Iranian market.

Why is there no price estimator or inspection report? Both need a Karnameh login on the website.

Proxy? The server ignores system proxies. Set KARNAMEH_MCP_PROXY if you need one.

فارسی

سرور MCP غیررسمی و فقط‌خواندنی برای کارنامه (karnameh.com): جستجوی آگهی خودروی کارکرده با فیلتر برند، مدل، شهر، قیمت، سال و کارکرد، خواندن کامل یک آگهی، قیمت روز خودروی صفر و روند قیمت. بدون کلید API و بدون حساب کاربری.

نصب: claude mcp add karnameh -- uvx karnameh-mcp

ساخته‌شده توسط سپهر رادمرد: github.com/sepehr071 · linkedin.com/in/sepehr-radmard

來源：README.md，提交 7a53fa6

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

3
  1. v0.2.0最新Nov 7, 2026
  2. v0.1.1Nov 3, 2026
  3. v0.1.0Nov 1, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分