İçeriğe geç
  • 0540 200 07 24
  • bilgi@birmakine.com

BirMakine'yi AI Ajanınıza Bağlayın (MCP / WebMCP)

Kısaca: BirMakine, yapay zeka ajanlarına (Claude, ChatGPT ve MCP destekli tüm istemciler) doğrudan bağlanabilen bir remote MCP sunucusu sunar. Ajan; kimlik doğrulaması olmadan 20'den fazla salt-okunur araçla canlı ilan, fiyat, kategori ve satıcı verisine erişebilir. Türkiye makine pazaryerleri arasında bu yetkinliği sunan ilk platformdur.

Neden BirMakine'yi AI ajanınıza bağlamalısınız?

Yapay zeka asistanları giderek daha çok "araştır, karşılaştır, öner" görevlerini üstleniyor. Bir ajan, kullanıcı adına "İstanbul'da 500 bin TL altı ikinci el fırın bul" ya da "ekskavatör fiyatları ne durumda" gibi sorulara gerçek, güncel veriyle yanıt verebilmek için yapılandırılmış bir kaynağa ihtiyaç duyar. BirMakine bu kaynağı standart Model Context Protocol (MCP) üzerinden hazır sunar; ajan sayfaları kazımak (scraping) zorunda kalmaz.

Nasıl bağlanır?

  1. MCP istemcinizi açın: Claude Desktop, ChatGPT ya da MCP destekli bir ajan çerçevesi kullanın.
  2. Sunucu adresini ekleyin: Remote MCP sunucusu olarak https://birmakine.com/mcp adresini tanımlayın (streamable-http, JSON-RPC 2.0).
  3. Araçları keşfedin: İstemci otomatik olarak initialize → tools/list çağrısı yapar; 20+ araç listelenir.
  4. Kullanın: Ajan, doğal dildeki isteğe göre uygun aracı tools/call ile çağırır ve yapılandırılmış yanıt alır.

Örnek: bir aracı çağırmak

Aşağıdaki istek, "Fırınlar" kategorisinin özetini (ilan sayısı, fiyat aralığı, popüler markalar) döndürür:

curl -X POST https://birmakine.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"kategori_ozet","arguments":{"kategori":"firinlar"}}}'

Yanıt hem insan-okunur content[].text hem de ajanın doğrudan işleyebileceği yapısal structuredContent nesnesi olarak döner.

Ajan hangi verilere erişir?

  • İlan arama ve detay: anahtar kelime, kategori, fiyat, şehir ve satıcıya göre arama; ilan detayı ve benzer ilanlar.
  • Fiyat zekâsı: kategori fiyat dağılımı (medyan, çeyreklik), fiyat geçmişi, bütçeye en yakın ilanlar.
  • Kategori ve marka: kategori ağacı, özet, marka ilanları ve modelleri.
  • Satıcı ve pazar: satıcı profili, satıcı kategorileri, genel pazar istatistiği.
  • Sektör sözlüğü ve blog: terim tanımları ve içerik araması.

Keşif uçları

Ajanlar ve geliştiriciler için makine-okunur giriş noktaları:

  • MCP manifesti: /.well-known/mcp.json
  • AI eklenti bildirimi: /.well-known/ai-plugin.json
  • Bağlam dosyaları: /llms.txt ve /llms-full.txt
  • AI alışveriş feed'i: /urun-feed (NDJSON, keyset sayfalama)
  • Doğrudan JSON API: /api/v1/... (OpenAPI: /api/v1/openapi.json)

Tarayıcı ajanları için WebMCP

BirMakine sayfaları, tarayıcı tabanlı AI ajanlarına WebMCP (document.modelContext) ile de araç sunar; sayfa açıldığında araçlar otomatik olarak kayıtlıdır. Tüm ayrıntılar ve araç tablosu için WebMCP geliştirici sayfamıza bakın.

Sorular ve entegrasyon için bize ulaşın. Ajanınızı bağlayın; BirMakine'nin güncel makine pazarı verisi asistanınızın parmaklarının ucunda olsun.