Skip to main content
Glama
sahibinden-car-mcp

sahibinden-car-mcp

by gkdgbilal

sahibinden-car-mcp

TR özet: Sahibinden.com otomobil ilanlarını, sizin kendi tarayıcınızda kaydettiğiniz HTML sayfalarından okuyup Claude'a (MCP üzerinden) filtreleme, ilan detayı ve karşılaştırma araçları sunan yerel bir MCP sunucusu. sahibinden.com'a hiçbir ağ isteği göndermez, bot korumasını atlatmaz, hesap/cookie istemez. sahibinden.com ile resmi bir ilişkisi yoktur.

A local Model Context Protocol (MCP) server that lets Claude search, inspect and compare used-car listings from sahibinden.com, working only from pages you saved yourself in your own browser.

Disclaimer / Yasal uyarı This project is not affiliated with, endorsed by, or officially connected to sahibinden.com in any way. It is intended for personal, non-commercial use only. sahibinden-car-mcp makes no network requests to sahibinden.com; it only parses, locally, pages you opened and saved to your own computer. It does not bypass bot protection and does not ask for or store any session information or cookies. Do not use it for bulk data collection, republishing or commercial purposes. Complying with sahibinden.com's terms of use is your own responsibility. Sellers' personal data (name, phone) is not processed. This is not legal advice.

Bu proje sahibinden.com ile bağlantılı değildir, onaylanmamıştır ve sahibinden.com ile resmi bir ilişkisi yoktur. Yalnızca kişisel, ticari olmayan kullanım içindir. sahibinden-car-mcp sahibinden.com'a hiçbir ağ isteği göndermez; yalnızca sizin kendi tarayıcınızda açıp bilgisayarınıza kaydettiğiniz sayfaları yerel olarak okur. Bot korumasını atlatmaz, oturum bilgisi/cookie istemez veya saklamaz. Toplu veri toplama, yeniden yayınlama ve ticari kullanım için kullanmayın. sahibinden.com kullanım koşullarına uymak kullanıcının sorumluluğundadır. Satıcıların kişisel verileri (ad, telefon) işlenmez. Bu bir hukuki görüş değildir.

Why it does not scrape directly

sahibinden.com is protected by Cloudflare's managed challenge (HTTP 403 with cf-mitigated: challenge, even for robots.txt). Plain HTTP requests cannot get listing data, and this project deliberately does not try to get around that: no proxies, no headless/stealth browsers, no captcha solvers, no fingerprint spoofing, and no copying of your browser cookies (such as cf_clearance) into the tool.

Instead it uses an inbox-based import flow: you view the page in your normal browser as any user would, save it with Cmd+S (Ctrl+S on Windows/Linux), and the MCP server parses the saved file locally. The server never touches the network.

Related MCP server: fbmarket-mcp

How it works

Your browser (Chrome/Firefox)                 sahibinden-car-mcp (local, stdio)
  open a search / listing page  ── Cmd+S ──▶  ~/.sahibinden-car-mcp/inbox/*.html
                                                       │  import_listing_html
                                                       ▼
                                        parser (label-based, cheerio) ──▶ local store.json
                                                       │
                                  search_cars · get_listing · compare_cars · ping
  1. Ask Claude for a search. search_cars returns matching listings from your local store plus ready-made sahibinden search URL(s) for you to open.

  2. Open the URL in your own browser.

  3. Save the page with Cmd+S (format: "Webpage, Complete" or "HTML only") into ~/.sahibinden-car-mcp/inbox/.

  4. Tell Claude to import it. import_listing_html parses the new files, then you can search, open details and compare.

Search result rows usually do not show transmission or fuel. Save the individual listing page to get the full details (damage, paint/replaced parts, tramer, description and more).

Requirements and installation

  • Node.js 20 or newer

  • npm

git clone https://github.com/gkdgbilal/sahibinden-car-mcp.git
cd sahibinden-car-mcp
npm install
npm run build

Demo

Demo output

The sample above comes from synthetic fixtures (no real listings) and is the actual output of the import_listing_html, search_cars and compare_cars tools. Regenerate it with npm run build && npm run demo.

Connecting to Claude Code

Use the absolute path of the built entry point:

claude mcp add sahibinden-car --scope user -- node /ABSOLUTE/PATH/TO/sahibinden-car-mcp/dist/index.js
claude mcp list   # sahibinden-car should show as connected

To use a different data directory:

claude mcp add sahibinden-car --scope user -e SAHIBINDEN_MCP_HOME=/path/to/data -- node /ABSOLUTE/PATH/TO/sahibinden-car-mcp/dist/index.js

For Claude Desktop, add this to claude_desktop_config.json:

{
  "mcpServers": {
    "sahibinden-car": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/sahibinden-car-mcp/dist/index.js"]
    }
  }
}

Tools

Tool

Purpose

Main parameters

search_cars

Filters and sorts imported listings; also returns sahibinden search URLs for you to open in your browser. Every filter is applied both locally and in the URL (only page is URL-only and limit local-only, by nature). Price filters are in priceCurrency (default TL); listings in another currency are excluded (no conversion) and counted in excludedOtherCurrency. Listings with a missing filter field are returned with an unknownFields marker (unknown: 'include', default) or dropped and counted in excludedUnknown (unknown: 'exclude'). The output also lists appliedFilters and urlOnlyFilters (empty). Audit table: docs/05-FILTER-AUDIT.md.

city, brand, models[] (max 10), priceMin, priceMax, transmission (manual/automatic/semi-automatic), fuel (gasoline/diesel/lpg/hybrid/electric), yearMin, yearMax, kmMin, kmMax, sort (price_asc default, price_desc, year_desc, year_asc, km_asc, km_desc, date_desc, date_asc), sellerType, bodyType, color, vehicleCondition, enginePower (up to 601+ hp), engineVolume, drivetrain, exchange, warranty, listedWithin (1day...30days), unpaintedOnly, noReplacedParts, noHeavyDamage, priceCurrency (TL default, USD, EUR, GBP), page (URL only), limit (1-100, default 20), unknown (include default / exclude; old includeUnknown: false = exclude)

get_listing

Full details of an imported listing (damage, paint/replaced parts, tramer, description, seller type). If only a search row is stored it returns a summary plus a hint to save the detail page.

ref (listing number or listing URL)

compare_cars

Puts 2-10 listings side by side with age, km per year and price difference versus the set median. Market interpretation is left to Claude.

refs[] (2-10 listing numbers or URLs)

import_listing_html

Imports saved sahibinden search/listing pages. Without path it processes new files in the inbox; path must be inside the inbox (relative paths resolve against it). Detects half-loaded or challenge pages and reports them as skipped.

path, html (small snippets only, max 5 MB), sourceUrl, force

ping

Health check: version, active provider, number of listings in the local store, inbox directory.

msg (optional)

The listing description field is free text written by the seller and is treated as untrusted; the tool descriptions tell the model not to follow instructions found in it.

Example prompts

  • "Find Golf/Astra/Focus/Megane in Samsun, 700-900k TL, automatic, 2015 or newer, under 150k km. Sort by price/km/year and flag the ones more than 10% below the market." (Turkish: "Samsun'da 700-900 bin TL, otomatik, 2015+, 150 bin km altı Golf/Astra/Focus/Megane bul; fiyat/km/yıl oranına göre sırala; piyasanın %10 altındakileri işaretle.")

  • "I saved two pages into the inbox, import them."

  • "Compare these three listings and tell me which one has the least damage history."

  • "Show the full details for listing 1234567890."

Configuration

Variable

Default

Meaning

SAHIBINDEN_MCP_HOME

~/.sahibinden-car-mcp

Data directory (contains inbox/ and store.json)

LOG_LEVEL

info

debug, info, warn or error. Logs go to stderr only; stdout is reserved for the MCP protocol

Built-in limits: saved files up to 10 MB, html argument up to 5 MB, descriptions truncated to 4000 characters.

Where your data is stored

Everything stays on your machine, under SAHIBINDEN_MCP_HOME:

  • inbox/ : the pages you saved

  • store.json : parsed listings, de-duplicated by listing number, with capture time and price history. Each imported file is remembered by content hash plus parser version: an unchanged file is skipped as duplicate, but a file read by an older parser version is re-parsed automatically after an upgrade (price history is kept); pass force: true to re-parse regardless.

Nothing is sent anywhere by this tool. (Note that whatever Claude reads through the tools is, of course, processed by the Claude client you use.) Delete the directory to remove all data.

Privacy (KVKK)

Seller name, phone number and profile links are not parsed and not stored. Only the seller type (owner / dealer / authorized dealer) is kept. Do not commit your inbox or store; both are in .gitignore.

Known limitations

  • Not fully automatic: you must open and save the pages yourself. This is the deliberate, legitimate way around the Cloudflare challenge.

  • URL filter parameters: mostly verified, a few assumptions remain (full table in docs/04-URL-SCHEMA.md, verified 2026-11-18 from the site's own filter links in a real browser session).

    • Verified: category path (/{brand}-{series}-{engine}, e.g. /opel-astra-1.3-cdti), price_min/price_max (+ price_currency), a5_min/a5_max (year), a4_min/a4_max (km), a6 (transmission), a17 (fuel), a706 (seller type), a8 (body type), a3 (color), a113987 (vehicle condition), a2320 (engine power ranges), a1864 (engine volume ranges), a9213 (drivetrain), exchange, date, unpaintedParts, unchangingTracks, sorting (8 values), pagingOffset (20 per page), and address_city for Samsun (55) and Istanbul (34) only. A combined filter URL was confirmed to return only matching listings.

    • Not verified: address_city plate codes for the other 79 provinces (assumed plate codes; the returned note warns when one is used), the semi-automatic transmission ID (unknown, never added to URLs), selecting several values of one filter at once, and which hybrid variant you want (hybrid maps to Benzin(Hibrit); the note lists the other IDs). All constants live in src/sahibinden/url-schema.ts with verified flags.

    • All search_cars filters (sellerType, bodyType, color, vehicleCondition, enginePower, engineVolume, drivetrain, exchange, warranty, listedWithin, unpaintedOnly, noReplacedParts, noHeavyDamage, priceCurrency) shape the URL and filter the local store. Detail-only fields (body type, drivetrain, condition, seller type, trade-in, warranty, heavy damage, engine, damage map) are only known for listings whose detail page you imported; for search-row-only listings they are "unknown" (marked, or excluded with unknown: 'exclude'). Details and rules: docs/05-FILTER-AUDIT.md.

  • Parser coverage: checked against one real saved search page and one real saved listing page (2026-11-18), plus synthetic fixtures that copy the real structure. It matches Turkish field labels rather than CSS classes, returns null for unknown fields and attaches warnings[]; other categories or layouts may still reveal gaps.

  • Location cell format depends on the page. Without a city filter the cell reads "Province District"; with a city filter it reads "District Neighborhood". The parser decides from cityHint (also accepted by import_listing_html), the page URL (city path segment or address_city) or a title starting with the city name. If signals conflict or cannot tell, city/district stay null, the raw text is kept in locationRaw and a warning is added; nothing is guessed. On city-filtered pages the first word is the district (a leading number joins the next word, e.g. "19 Mayıs") and the rest is neighborhood; locationRaw is kept there too because the split is heuristic.

  • Listing-page location is verified (2026-11-18) against a real page: city/district/neighborhood come from the Adres Breadcrumb links (first = province, second = district, last = neighborhood), with the #gmap data-* attributes as fallback. If neither exists, location stays null with a warning.

  • Search rows rarely include transmission/fuel; those become known after importing the listing page.

  • Safari .webarchive files are not supported. Use Chrome or Firefox ("Webpage, Complete" or "HTML only").

  • If the saved file loses its URL, the parser tries link[rel=canonical], og:url, Chrome's saved from url comment, a URL built from the listing number, and finally the sourceUrl argument.

  • Currency is never converted: with a price filter, listings in another currency than priceCurrency are excluded. listedWithin has day granularity. The semi-automatic transmission has no known sahibinden ID, so it is applied locally but not added to the URL.

  • Tramer is a seller claim: when the structured field is missing, the tramer amount is read from the listing description (tramerAmount = sum of the amounts near the word "tramer", plus tramerRecords and tramerStatus: none, amount, mentioned, unknown). It is unverified; always run the official tramer query.

  • Version 0.1.2 is early software.

Development

npm run build       # compile TypeScript to dist/
npm run typecheck
npm test            # vitest
npm run smoke       # end-to-end stdio check against dist/ with synthetic fixtures in a temp home
npm run demo        # regenerate docs/assets/demo.svg from real tool calls on synthetic fixtures

Parser and normalizer functions are pure (no I/O, no clock). Tests use only small, synthetic, anonymized fixtures; never commit real listing HTML (it contains third-party content and personal data). tests/fixtures/private/ is git-ignored for local experiments.

Roadmap

  • Validate the remaining 79 province codes and the parser against real saved pages

  • analyze_market_price and find_price_drops (price history is already recorded in the store)

  • Optional additional providers behind the existing Provider interface, only if sahibinden.com offers an official API or access policy changes

License

MIT (c) 2026 Bilal Gökdağ. sahibinden.com is a trademark of its respective owner; this project is unaffiliated with it.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to search and retrieve used and new car listings from carsales.com.au, with support for various filters and detailed listing information including images. It uses a real browser to bypass bot protection and integrates with MCP-compatible clients like Claude Desktop and Claude Code.
      19
      2
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables Claude to monitor Facebook Marketplace car and motorcycle listings, score them against custom criteria, and analyze accumulated listing history to reveal time-on-market, price trends, and sale triggers.
      9
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables Claude to full-text search, list, and read your exported ChatGPT and Claude conversations from a local conversations.json file, running locally with read-only file access and no network requests. Supports both official export formats with automatic detection.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables Claude to search and read the user's local document collection (PDF, Word, Excel, Markdown, plain text) during a conversation by subject, by file name/path, or by exact word, and to retrieve file contents page by page. It also supports finding folders relevant to a topic and checking indexing status, with everything running locally on the user's machine.
      MIT