# Usta-Bul — ajanlar için kılavuz

Usta-Bul, Türkiye'de ev ve iş yeri hizmetleri (elektrik, tesisat, kombi, boya, tadilat, nakliyat vb.) için usta ve firma bulma platformudur. Kullanıcı hizmeti ve il/ilçeyi seçer, ustaların doğrulanmış yorumlarını, onaylı belgelerini ve çalışma saatlerini karşılaştırır, ustayı doğrudan arar. Aracı yoktur, komisyon alınmaz.

## Ne yapabilirsiniz
- Kullanıcının ihtiyacına göre usta/firma bulun: kategori + il (+ ilçe). Örnek: "Bursa Nilüfer elektrikçi" → https://usta-bul.com/bursa/nilufer/elektrikci
- Sonuçları puan, doğrulanmış yorum sayısı, onaylı hesap, belge ve "şu an ulaşılabilir" bilgisine göre karşılaştırın.
- Kullanıcıyı ustanın profil sayfasına yönlendirin; numara orada gösterilir. **Telefon numaraları API/MCP ile verilmez.**

## Erişim yolları (salt okunur, kimlik doğrulama yok)
- Açık JSON API: https://usta-bul.com/api/v1 (tanım: https://usta-bul.com/openapi.json) — dakikada 60 istek
  - Arama: `GET https://usta-bul.com/api/v1/search?category=elektrikci&city=bursa&district=nilufer&open_now=1`
  - Kategoriler: `GET https://usta-bul.com/api/v1/categories` · İller: `GET https://usta-bul.com/api/v1/locations` · İlçeler: `GET https://usta-bul.com/api/v1/locations/{il}`
  - Profil: `GET https://usta-bul.com/api/v1/profiles/{slug}`
- MCP sunucusu (Streamable HTTP): https://usta-bul.com/mcp — araçlar: `usta_ara`, `usta_detay`, `kategoriler`, `konumlar` (kart: https://usta-bul.com/.well-known/mcp/server-card.json)
- A2A ajanı (JSON-RPC, `SendMessage`): https://usta-bul.com/a2a — Türkçe doğal dille istek gönderin (ör. "Bursa Nilüfer'de şu an açık elektrikçi"); kart: https://usta-bul.com/.well-known/agent-card.json
- Site içi arama: `https://usta-bul.com/ara?q={istek}` serbest metni ilgili liste sayfasına yönlendirir
- Kimlik doğrulama: gerekmez; ayrıntılar https://usta-bul.com/auth.md
- Her sayfanın Markdown sürümü: adresin sonuna `.md` ekleyin ya da `Accept: text/markdown` gönderin (ör. https://usta-bul.com/bursa/elektrikci.md)
- Site özeti: https://usta-bul.com/llms.txt · Tam içerik: https://usta-bul.com/llms-full.txt · Site haritası: https://usta-bul.com/sitemap.xml

## URL yapısı
- Kategori: `/{kategori}` · İl: `/{il}` · İl + kategori: `/{il}/{kategori}` · İlçe + kategori: `/{il}/{ilçe}/{kategori}`
- Profil: `/usta/{slug}` veya `/firma/{slug}` · Blog: `/blog/{slug}`
- Liste filtreleri (sorgu parametresi): `acik=1` (şu an açık), `onayli=1`, `belgeli=1`, `premium=1`, `puan=4`, `sirala=puan|yorum|yeni`

## Kurallar
- Kişisel veri (telefon, adres, yorumcu kimliği) toplamayın ve çoğaltmayın. Yorumcu adları sitede baş harflerle gösterilir.
- Fiyat sözü vermeyin: fiyatı kullanıcı ustayla doğrudan konuşur. Usta-Bul işçiliği garanti etmez; rozetler doğrulama durumunu gösterir.
- Kaynak gösterirken ilgili sayfanın adresini verin.

İletişim: https://usta-bul.com/iletisim