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 分