sahibinden-car-mcp
Parses locally saved sahibinden.com car search and listing pages to let you filter and sort used-car listings, view full details (damage, paint/replaced parts, tramer, description, seller type) and compare 2-10 listings side by side, while also generating sahibinden search URLs to open in your own browser.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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 · pingAsk Claude for a search.
search_carsreturns matching listings from your local store plus ready-made sahibinden search URL(s) for you to open.Open the URL in your own browser.
Save the page with
Cmd+S(format: "Webpage, Complete" or "HTML only") into~/.sahibinden-car-mcp/inbox/.Tell Claude to import it.
import_listing_htmlparses 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 buildDemo
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 connectedTo 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.jsFor 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 |
| 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 |
|
| 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. |
|
| 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. |
|
| Imports saved sahibinden search/listing pages. Without |
|
| Health check: version, active provider, number of listings in the local store, inbox directory. |
|
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 |
|
| Data directory (contains |
|
|
|
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 savedstore.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 asduplicate, but a file read by an older parser version is re-parsed automatically after an upgrade (price history is kept); passforce: trueto 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), andaddress_cityfor Samsun (55) and Istanbul (34) only. A combined filter URL was confirmed to return only matching listings.Not verified:
address_cityplate codes for the other 79 provinces (assumed plate codes; the returnednotewarns 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 (hybridmaps to Benzin(Hibrit); thenotelists the other IDs). All constants live insrc/sahibinden/url-schema.tswithverifiedflags.All
search_carsfilters (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 withunknown: '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
nullfor unknown fields and attacheswarnings[]; 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 byimport_listing_html), the page URL (city path segment oraddress_city) or a title starting with the city name. If signals conflict or cannot tell,city/districtstaynull, the raw text is kept inlocationRawand 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 isneighborhood;locationRawis 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 Breadcrumblinks (first = province, second = district, last = neighborhood), with the#gmapdata-*attributes as fallback. If neither exists, location staysnullwith a warning.Search rows rarely include transmission/fuel; those become known after importing the listing page.
Safari
.webarchivefiles 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'ssaved from urlcomment, a URL built from the listing number, and finally thesourceUrlargument.Currency is never converted: with a price filter, listings in another currency than
priceCurrencyare excluded.listedWithinhas 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", plustramerRecordsandtramerStatus: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 fixturesParser 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_priceandfind_price_drops(price history is already recorded in the store)Optional additional providers behind the existing
Providerinterface, 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…
This server cannot be deployed
Maintenance
Related MCP Connectors
Car-listing search and used-car market analysis as agent tools.
Read and search folders on your own computer with explicit consent. Files are never uploaded.
Open, inspect, filter, edit and convert xlsx and csv files from your AI chat. Processing is local.
Open, inspect, filter, edit and convert xlsx and csv files from your AI chat. Processing is local.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables 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.192MIT
- AlicenseBqualityCmaintenanceEnables 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.9MIT
- AlicenseNot gradedqualityCmaintenanceEnables 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
- AlicenseNot gradedqualityCmaintenanceEnables 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