BirMakine sayfaları, tarayıcı AI ajanlarına WebMCP (document.modelContext, Chrome 149+ origin trial) ile read-only tool sunar. Aynı işlevler kimlik-doğrulamasız JSON API ve remote MCP sunucusu olarak da erişilebilir.
https://birmakine.com/mcp adresini ekleyin (streamable-http, JSON-RPC 2.0). initialize → tools/list → tools/call. Ayrıca resources/* ve prompts/* desteklenir. Tool yanıtları hem content[].text (JSON metin) hem de yapısal structuredContent (parse gerektirmeyen nesne) olarak döner.document.modelContext tool'ları otomatik kayıtlıdır.GET https://birmakine.com/api/v1/... (kimlik-doğrulamasız, JSON). OpenAPI: /api/v1/openapi.json./.well-known/mcp.json · plugin /.well-known/ai-plugin.json · bağlam /llms.txt.| Tool | Açıklama | Parametreler |
|---|---|---|
ilan_ara | İlan arar (anahtar kelime, kategori, fiyat aralığı, şehir). | q, kategori, fiyat_min, fiyat_max, sehir, sort, sayfa |
ilan_filtrele | İlanları facet'lerle filtreler (ilan_ara ile aynı). | q, kategori, fiyat_min, fiyat_max, sehir |
site_ara | Genel ilan araması. | q (zorunlu) |
kategori_ozet | Kategori pazar özeti (toplam ilan, satıcı sayısı, fiyat bandı, popüler markalar). | kategori (zorunlu) |
spec_secenekleri | Bir kategorinin teknik-özellik filtrelerini (Voltaj/Güç/Kapasite…) değer+adetleriyle döndürür. | kategori (zorunlu) |
spec_filtrele | İlanları teknik özelliklere göre filtreler. | kategori (zorunlu), ozellikler {ad:değer}, fiyat_min, fiyat_max, sehir, sort |
ilan_detay | Bir ilanın detayını döndürür. | slug (zorunlu) |
benzer_ilan | Bir ilana benzer ilanları getirir. | slug (zorunlu) |
en_yeni_ilan | En yeni eklenen ilanları getirir. | kategori, adet |
konum_ilanlari | Şehre göre ilanlar. | sehir (zorunlu), q |
kategori_gez | Tüm ilan kategorilerini listeler. | — |
populer_kategori | En çok ilanlı kategoriler. | — |
marka_listele | Üretici markalarını listeler/arar. | q (opsiyonel) |
marka_ilanlari | Bir markanın ilanları. | slug (zorunlu) |
satici_profil | Satıcı profilini döndürür. | slug (zorunlu) |
satici_ilanlari | Bir satıcının ilanları. | satici (zorunlu) |
pazar_istatistik | Pazar istatistiği (toplam ilan, fiyat aralığı, popüler kategoriler). | — |
blog_ara | Blog/rehber yazılarını arar. | q |
blog_getir | Blog yazısı içeriği. | slug (zorunlu) |
sss_getir | Sık sorulan sorular. | — |
yazar_getir | Blog yazarı uzmanlık/bilgi. | slug (zorunlu) |
finansman_hesapla | Leasing/taksit hesaplar (yerel). | tutar (zorunlu), vade_ay (zorunlu), pesinat, yillik_faiz |
Manifest (makine-okunur): /.well-known/mcp.json
Adım adım anlatım ve örnek çağrı için: BirMakine'yi AI ajanınıza bağlayın.
GET https://birmakine.com/api/v1/ara?q=&kategori=&fiyat_min=&fiyat_max=&sehir=&sort=&sayfa= — teknik filtre: &spec[Voltaj]=380VGET https://birmakine.com/api/v1/spec-facet?kategori={slug} — kategorinin teknik-özellik filtre seçenekleriGET https://birmakine.com/api/v1/ilan/{slug} · Markdown: https://birmakine.com/ilan/{slug}.mdGET https://birmakine.com/api/v1/kategoriler · Markdown: https://birmakine.com/kategori/{slug}.mdGET https://birmakine.com/api/v1/markalar?q= · Markdown: https://birmakine.com/marka/{slug}.mdGET https://birmakine.com/api/v1/satici/{slug} · Markdown: https://birmakine.com/satici/{slug}.mdGET https://birmakine.com/urun-feed — tüm aktif ilanlar (NDJSON, keyset sayfalama)Bir AI ajanı "İstanbul'da 220V bar tipi şişe soğutucu, 50 bin TL bütçe" isteğini şöyle çözebilir:
kategori_gez → uygun kategori slug'ını bul (buzdolaplari-sogutucular).spec_secenekleri {kategori} → filtrelenebilir özellikleri gör (Voltaj, Soğutucu Gaz…).spec_filtrele {kategori, ozellikler:{"Voltaj":"220V-50Hz"}} veya benzer_fiyatli {kategori, fiyat:50000} → sonuç listesi.ilan_detay {slug} → seçilen ilanın detayı; yanıttaki _links ile benzer/satici/markdown adımlarına geç.Aynı işlevler JSON API ile: GET /api/v1/spec-facet?kategori=buzdolaplari-sogutucular → GET /api/v1/ara?kategori=buzdolaplari-sogutucular&spec[Voltaj]=220V-50Hz
Tüm tool'lar read-only, kişisel veri (telefon/e-posta) döndürmez; satıcıyla iletişim ilan sayfasından yapılır. Hız sınırı: IP başına 240 istek/dk. Veri kullanım politikası.
Claude Desktop / ChatGPT connector için custom MCP sunucusu olarak https://birmakine.com/mcp ekleyin (auth yok). Tool'lar tools/list ile otomatik listelenir; ör. "İstanbul'da 500 bin TL bütçeyle forklift" sorusunda ajan benzer_fiyatli tool'unu çağırır.
AI bağlam: llms.txt · llms-full.txt · OpenAPI · mcp.json · /mcp (remote MCP)