armut-mcp 0.1.0__tar.gz

armut_mcp-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,20 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags: ["v*"]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write # required for PyPI trusted publishing (OIDC)
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: pip install build
+      - run: python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1

armut_mcp-0.1.0/.github/workflows/registry.yml

@@ -0,0 +1,61 @@
+name: Publish to MCP Registry
+
+# Official MCP Registry (registry.modelcontextprotocol.io) via GitHub OIDC.
+# No secret, no interactive login: the runner's OIDC token proves ownership
+# of the io.github.mohammad-abbasi-sh/* namespace.
+# Refs: https://github.com/modelcontextprotocol/registry
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write # required for OIDC -> MCP Registry
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Sync server.json version to tag
+        # Only sync when running on a version tag (v*). On workflow_dispatch
+        # (ref = refs/heads/main) keep the version committed in server.json.
+        run: |
+          VER=""
+          if [[ "$GITHUB_REF" == refs/tags/* ]]; then
+            TAG="${GITHUB_REF#refs/tags/}"
+            VER="${TAG#v}"
+          fi
+          if [ -n "$VER" ]; then
+            python3 - "$VER" << 'EOF'
+          import json, sys
+          ver = sys.argv[1]
+          d = json.load(open('server.json'))
+          d['version'] = ver
+          for pkg in d.get('packages', []):
+              pkg['version'] = ver
+          json.dump(d, open('server.json', 'w'), indent=2, ensure_ascii=False)
+          print('server.json version ->', ver)
+          EOF
+          else
+            echo "No version tag ($GITHUB_REF); keeping server.json version as-is"
+          fi
+
+      - name: Install mcp-publisher
+        run: |
+          curl -sL "https://github.com/modelcontextprotocol/registry/releases/download/v1.8.7/mcp-publisher_linux_amd64.tar.gz" -o /tmp/mcp-publisher.tar.gz
+          tar -xzf /tmp/mcp-publisher.tar.gz -C /tmp
+          sudo mv /tmp/mcp-publisher /usr/local/bin/mcp-publisher
+          mcp-publisher --version
+
+      - name: Validate server.json
+        run: mcp-publisher validate server.json
+
+      - name: Publish to MCP Registry (OIDC)
+        run: |
+          mcp-publisher login github-oidc
+          mcp-publisher publish server.json
+        # A registry outage must never break the release; re-run from Actions if needed.
+        continue-on-error: true

armut_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mohammad Abbasi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

armut_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.5
+Name: armut-mcp
+Version: 0.1.0
+Summary: Unofficial read-only MCP server for armut.com local services (search, pros, FAQs, price guides)
+Author: Mohammad Abbasi
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp<2
+Description-Content-Type: text/markdown
+
+# armut-mcp 🇹🇷
+
+mcp-name: io.github.mohammad-abbasi-sh/armut-mcp
+
+Unofficial **read-only** MCP server for **armut.com**, Türkiye's local-services marketplace — search 6,759 services (cleaning, moving, repairs, lessons and more), browse top professionals with ratings and reviews, read service FAQs, and get price guides with 12 months of average prices and real quote examples.
+
+> Built by Mohammad Abbasi as part of the "Turkey MCP factory" (Sepehr-style pipeline). Not affiliated with armut.com.
+
+## For AI agents
+
+Add to your MCP client config (stdio):
+
+```json
+{
+  "mcpServers": {
+    "armut": {
+      "command": "uvx",
+      "args": ["armut-mcp"]
+    }
+  }
+}
+```
+
+Or run locally: `python -m armut_mcp.server` (needs `mcp<2`, `httpx`).
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `armut_search_services` | Search the 6,759-service catalogue by keyword — `query` ("temizlik", "nakliyat", "boyaci"), Turkish letters fine; returns slug, service_id, price-guide and service-page URLs |
+| `armut_service_detail` | Detail of one service (slug e.g. "ev-temizligi"): name, description, pro count, average rating, review count, service_id |
+| `armut_list_pros` | Top professionals for a service: name, city/district, member since, bio, rating, review count, profile URL; `city` ("istanbul") filters to that city; `limit` 1..40 |
+| `armut_service_faq` | Frequently asked questions for a service, with answers |
+| `armut_price_guide` | Price guide for a service: page-listed min/max price (TRY), 12 months of average/min/max prices with quote counts, total quotes, pro count, rating, real example jobs with winning prices, recent reviews; `city` ("adana") for that city's guide |
+| `armut_trending_services` | What's popular right now: service groups, trending/popular services with pro counts and ratings, most-searched city+service combos |
+
+Example output (`armut_search_services` / "temizlik"):
+
+```json
+{"query": "temizlik", "count": 10, "services": [
+  {"slug": "ev-temizligi", "name": "Ev Temizligi", "service_id": 191,
+   "price_url": "https://armut.com/fiyatlari/ev-temizligi_191",
+   "service_url": "https://armut.com/ev-temizligi"}, …]}
+```
+
+Example output (`armut_service_detail` / "ev-temizligi"):
+
+```json
+{"name": "Ev Temizliği", "service_id": 191, "pro_count": 10141,
+ "rating_average": 4.6, "review_count": 415591,
+ "description": "Güvenilir Ev Temizliği hizmeti al, zaman kazan, garantide ol. …",
+ "url": "https://armut.com/ev-temizligi"}
+```
+
+Example output (`armut_list_pros` / "ev-temizligi", istanbul, 1):
+
+```json
+{"service": "Ev Temizliği", "city": "istanbul", "count": 1, "pros": [
+  {"name": "Nermin K.", "location": "Şişli, İstanbul", "since": "…",
+   "bio": "…", "rating": 4.1, "review_count": 162,
+   "profile_url": "https://armut.com/hizmetveren/…"}]}
+```
+
+Example output (`armut_price_guide` / "ev-temizligi", adana):
+
+```json
+{"service": "Ev Temizliği", "service_id": 191, "city": "Adana",
+ "currency": "TRY", "min_price_try": 479, "max_price_try": 1024,
+ "quote_count": 790, "pro_count": 433, "rating_average": 4.6,
+ "monthly_average_try": [
+  {"month": "2025-11", "avg_try": 2756.39, "min_try": 1763,
+   "max_try": 3806, "quotes": 88}, …]}
+```
+
+Notes:
+- Data comes from armut.com's public server-rendered pages (schema.org Product/ItemList/FAQPage JSON-LD on service pages, `__NEXT_DATA__` on the homepage and price-guide pages, the public price sitemap) — no key, no login, read-only.
+- Turkish `-lik` nouns surface as `-ligi` in slugs ("temizlik" → "ev-temizligi"); the search handles that, so a plain "temizlik" query finds "ev-temizligi".
+- The page-listed min/max price and the 12 monthly averages come from different page fields; the monthly averages (with quote counts) are the more reliable price signal.
+- Requests are spaced ~0.8s apart to stay polite.
+- Environments behind an MITM proxy: set `SSL_CERT_FILE` to a CA bundle that trusts the proxy.
+
+## Development
+
+```bash
+python3 -m venv .venv && .venv/bin/pip install "mcp<2" httpx pytest
+.venv/bin/pip install -e .
+.venv/bin/python -m pytest tests/ -q
+```
+
+- `tests/test_services.py` — offline, parses real captured fixtures (29 tests)
+- `tests/test_live.py` — 8 cautious live requests against armut.com (needs `SSL_CERT_FILE` behind the lab proxy)
+
+## License
+
+MIT

armut_mcp-0.1.0/README-fa.md

@@ -0,0 +1,93 @@
+# armut-mcp 🇹🇷
+
+سرور MCP غیررسمی و **فقط‌خواندنی** برای **armut.com**، بازار خدمات محلی ترکیه — جست‌وجو در ۶٬۷۵۹ خدمت (نظافت، اسباب‌کشی، تعمیرات، تدریس خصوصی و بیشتر)، مرور بهترین متخصصان با امتیاز و نظر، پرسش‌های متداول هر خدمت و راهنمای قیمت با میانگین ۱۲ ماهه و نمونه‌های واقعی قیمت‌ها.
+
+> ساختهٔ محمد عباسی در قالب «کارخانهٔ Turkey MCP» (خط تولید به سبک سپهر). وابستگی به armut.com ندارد.
+
+## برای ایجنت‌های هوش مصنوعی
+
+به پیکربندی کلاینت MCP خود (stdio) اضافه کنید:
+
+```json
+{
+  "mcpServers": {
+    "armut": {
+      "command": "uvx",
+      "args": ["armut-mcp"]
+    }
+  }
+}
+```
+
+یا به‌صورت محلی اجرا کنید: `python -m armut_mcp.server` (نیازمند `mcp<2` و `httpx`).
+
+## ابزارها
+
+| ابزار | توضیح |
+|------|-------|
+| `armut_search_services` | جست‌وجو در کاتالوگ ۶٬۷۵۹ خدمتی با کلیدواژه — `query` مثل «temizlik» (نظافت)، «nakliyat» (اسباب‌کشی)، «boyaci» (نقاش)؛ حروف ترکی مشکلی ندارند؛ نام کوتاه، شناسهٔ خدمت، آدرس راهنمای قیمت و صفحهٔ خدمت را برمی‌گرداند |
+| `armut_service_detail` | جزئیات یک خدمت (نام کوتاه مثل «ev-temizligi»): نام، توضیح، تعداد متخصص، میانگین امتیاز، تعداد نظر، شناسهٔ خدمت |
+| `armut_list_pros` | بهترین متخصصان یک خدمت: نام، شهر/منطقه، تاریخ عضویت، معرفی، امتیاز، تعداد نظر، آدرس پروفایل؛ `city` (مثل «istanbul») به آن شهر محدود می‌کند؛ `limit` از ۱ تا ۴۰ |
+| `armut_service_faq` | پرسش‌های متداول یک خدمت با پاسخ‌ها |
+| `armut_price_guide` | راهنمای قیمت یک خدمت: کمینه/بیشینهٔ قیمت در صفحه (لیر)، میانگین/کمینه/بیشینهٔ ۱۲ ماهه با تعداد قیمت‌ها، مجموع قیمت‌ها و متخصصان، امتیاز، نمونه‌های واقعی کار با قیمت برنده و نظرات اخیر مشتریان؛ `city` (مثل «adana») راهنمای آن شهر را می‌دهد |
+| `armut_trending_services` | محبوب‌های الان: گروه‌های خدمت، خدمات ترند و محبوب با تعداد متخصص و امتیاز، پرجست‌وجوترین ترکیب‌های شهر+خدمت |
+
+خروجی نمونه (`armut_search_services` / «temizlik»):
+
+```json
+{"query": "temizlik", "count": 10, "services": [
+  {"slug": "ev-temizligi", "name": "Ev Temizligi", "service_id": 191,
+   "price_url": "https://armut.com/fiyatlari/ev-temizligi_191",
+   "service_url": "https://armut.com/ev-temizligi"}, …]}
+```
+
+خروجی نمونه (`armut_service_detail` / «ev-temizligi»):
+
+```json
+{"name": "Ev Temizliği", "service_id": 191, "pro_count": 10141,
+ "rating_average": 4.6, "review_count": 415591,
+ "description": "Güvenilir Ev Temizliği hizmeti al, zaman kazan, garantide ol. …",
+ "url": "https://armut.com/ev-temizligi"}
+```
+
+خروجی نمونه (`armut_list_pros` / «ev-temizligi»، استانبول، ۱):
+
+```json
+{"service": "Ev Temizliği", "city": "istanbul", "count": 1, "pros": [
+  {"name": "Nermin K.", "location": "Şişli, İstanbul", "since": "…",
+   "bio": "…", "rating": 4.1, "review_count": 162,
+   "profile_url": "https://armut.com/hizmetveren/…"}]}
+```
+
+خروجی نمونه (`armut_price_guide` / «ev-temizligi»، آدانا):
+
+```json
+{"service": "Ev Temizliği", "service_id": 191, "city": "Adana",
+ "currency": "TRY", "min_price_try": 479, "max_price_try": 1024,
+ "quote_count": 790, "pro_count": 433, "rating_average": 4.6,
+ "monthly_average_try": [
+  {"month": "2025-11", "avg_try": 2756.39, "min_try": 1763,
+   "max_try": 3806, "quotes": 88}, …]}
+```
+
+نکته‌ها:
+- داده‌ها از صفحات عمومی سمت‌سرور armut.com می‌آیند (JSON-LD از نوع Product/ItemList/FAQPage در schema.org در صفحات خدمت، `__NEXT_DATA__` در صفحهٔ اصلی و صفحات راهنمای قیمت، و نقشهٔ سایت عمومی قیمت) — بدون کلید، بدون ورود، فقط خواندنی.
+- در ترکی، اسم‌های پایان‌یافته به `-lik` در نام‌های کوتاه به `-ligi` تبدیل می‌شوند («temizlik» ← «ev-temizligi»)؛ جست‌وجو این را در نظر می‌گیرد، پس جست‌وجوی سادهٔ «temizlik»، «ev-temizligi» را هم پیدا می‌کند.
+- کمینه/بیشینهٔ قیمت صفحه و میانگین‌های ۱۲ ماهه از فیلدهای متفاوتی در صفحه می‌آیند؛ میانگین‌های ماهانه (همراه با تعداد قیمت‌ها) نشانهٔ قابل‌اعتمادتری برای قیمت‌اند.
+- بین درخواست‌ها حدود ۰٫۸ ثانیه فاصله گذاشته می‌شود تا به سایت فشار نیاید.
+- پشت پروکسی MITM: متغیر `SSL_CERT_FILE` را به بستهٔ CA مورد اعتماد پروکسی بدهید.
+
+## توسعه
+
+```bash
+python3 -m venv .venv && .venv/bin/pip install "mcp<2" httpx pytest
+.venv/bin/pip install -e .
+.venv/bin/python -m pytest tests/ -q
+```
+
+- `tests/test_services.py` — آفلاین، با نمونه‌های واقعی ذخیره‌شده (۲۹ تست)
+- `tests/test_live.py` — ۸ درخواست محتاطانهٔ زنده به armut.com
+
+## مجوز
+
+MIT

armut_mcp-0.1.0/README-tr.md

@@ -0,0 +1,93 @@
+# armut-mcp 🇹🇷
+
+Türkiye'nin yerel hizmetler pazaryeri **armut.com** için resmi olmayan, **salt okunur** MCP sunucusu — 6.759 hizmette arama (temizlik, nakliyat, tamir, özel ders ve daha fazlası), puan ve yorumlarıyla en iyi profesyoneller, hizmet SSS'leri ve 12 aylık ortalama fiyatlar ile gerçek teklif örnekleri içeren fiyat rehberleri.
+
+> Mohammad Abbasi tarafından "Turkey MCP factory" (Sepehr tarzı hat) kapsamında geliştirildi. armut.com ile bağlantısı yoktur.
+
+## Yapay zekâ ajanları için
+
+MCP istemci yapılandırmanıza (stdio) ekleyin:
+
+```json
+{
+  "mcpServers": {
+    "armut": {
+      "command": "uvx",
+      "args": ["armut-mcp"]
+    }
+  }
+}
+```
+
+Veya yerelde çalıştırın: `python -m armut_mcp.server` (`mcp<2`, `httpx` gerekir).
+
+## Araçlar
+
+| Araç | Açıklama |
+|------|----------|
+| `armut_search_services` | 6.759 hizmetlik katalogda anahtar kelimeyle arama — `query` ("temizlik", "nakliyat", "boyaci"), Türkçe harfler sorun değil; kısaltma, hizmet kimliği, fiyat rehberi ve hizmet sayfası adresini döndürür |
+| `armut_service_detail` | Tek hizmetin detayı (kısaltma, örn. "ev-temizligi"): ad, açıklama, profesyonel sayısı, ortalama puan, yorum sayısı, hizmet kimliği |
+| `armut_list_pros` | Bir hizmetin en iyi profesyonelleri: ad, şehir/ilçe, üyelik tarihi, tanıtım yazısı, puan, yorum sayısı, profil adresi; `city` ("istanbul") o şehre filtreler; `limit` 1..40 |
+| `armut_service_faq` | Bir hizmetin sık sorulan soruları ve cevapları |
+| `armut_price_guide` | Bir hizmetin fiyat rehberi: sayfadaki en düşük/en yüksek fiyat (TL), 12 aylık ortalama/en düşük/en yüksek fiyatlar ve teklif sayıları, toplam teklif ve profesyonel sayısı, puan, kazanan fiyatlarıyla gerçek iş örnekleri, son müşteri yorumları; `city` ("adana") o şehrin rehberini verir |
+| `armut_trending_services` | Şu an popüler olanlar: hizmet grupları, trend ve popüler hizmetler (profesyonel sayısı ve puanlarıyla), en çok aranan şehir+hizmet kombinasyonları |
+
+Örnek çıktı (`armut_search_services` / "temizlik"):
+
+```json
+{"query": "temizlik", "count": 10, "services": [
+  {"slug": "ev-temizligi", "name": "Ev Temizligi", "service_id": 191,
+   "price_url": "https://armut.com/fiyatlari/ev-temizligi_191",
+   "service_url": "https://armut.com/ev-temizligi"}, …]}
+```
+
+Örnek çıktı (`armut_service_detail` / "ev-temizligi"):
+
+```json
+{"name": "Ev Temizliği", "service_id": 191, "pro_count": 10141,
+ "rating_average": 4.6, "review_count": 415591,
+ "description": "Güvenilir Ev Temizliği hizmeti al, zaman kazan, garantide ol. …",
+ "url": "https://armut.com/ev-temizligi"}
+```
+
+Örnek çıktı (`armut_list_pros` / "ev-temizligi", İstanbul, 1):
+
+```json
+{"service": "Ev Temizliği", "city": "istanbul", "count": 1, "pros": [
+  {"name": "Nermin K.", "location": "Şişli, İstanbul", "since": "…",
+   "bio": "…", "rating": 4.1, "review_count": 162,
+   "profile_url": "https://armut.com/hizmetveren/…"}]}
+```
+
+Örnek çıktı (`armut_price_guide` / "ev-temizligi", Adana):
+
+```json
+{"service": "Ev Temizliği", "service_id": 191, "city": "Adana",
+ "currency": "TRY", "min_price_try": 479, "max_price_try": 1024,
+ "quote_count": 790, "pro_count": 433, "rating_average": 4.6,
+ "monthly_average_try": [
+  {"month": "2025-11", "avg_try": 2756.39, "min_try": 1763,
+   "max_try": 3806, "quotes": 88}, …]}
+```
+
+Notlar:
+- Veriler armut.com'un herkese açık sunucu taraflı sayfalarından gelir (hizmet sayfalarında schema.org Product/ItemList/FAQPage JSON-LD, ana sayfa ve fiyat rehberi sayfalarında `__NEXT_DATA__`, herkese açık fiyat site haritası) — anahtar yok, giriş yok, salt okunur.
+- Türkçede `-lik` ile biten isimler kısaltmalarda `-ligi` olur ("temizlik" → "ev-temizligi"); arama bunu dikkate alır, yani düz "temizlik" sorgusu "ev-temizligi"ni de bulur.
+- Sayfadaki en düşük/en yüksek fiyat ile 12 aylık ortalamalar sayfanın farklı alanlarından gelir; teklif sayılarıyla birlikte verilen aylık ortalamalar daha güvenilir fiyat göstergesidir.
+- İstekler arasında ~0,8 sn beklenir (nazik kullanım).
+- MITM proxy arkasındaki ortamlar: `SSL_CERT_FILE` ile proxy'ye güvenen bir CA paketi gösterin.
+
+## Geliştirme
+
+```bash
+python3 -m venv .venv && .venv/bin/pip install "mcp<2" httpx pytest
+.venv/bin/pip install -e .
+.venv/bin/python -m pytest tests/ -q
+```
+
+- `tests/test_services.py` — çevrimdışı, gerçek yakalanmış örneklerle (29 test)
+- `tests/test_live.py` — armut.com'a karşı 8 temkinli canlı istek
+
+## Lisans
+
+MIT

armut_mcp-0.1.0/README.md

@@ -0,0 +1,95 @@
+# armut-mcp 🇹🇷
+
+mcp-name: io.github.mohammad-abbasi-sh/armut-mcp
+
+Unofficial **read-only** MCP server for **armut.com**, Türkiye's local-services marketplace — search 6,759 services (cleaning, moving, repairs, lessons and more), browse top professionals with ratings and reviews, read service FAQs, and get price guides with 12 months of average prices and real quote examples.
+
+> Built by Mohammad Abbasi as part of the "Turkey MCP factory" (Sepehr-style pipeline). Not affiliated with armut.com.
+
+## For AI agents
+
+Add to your MCP client config (stdio):
+
+```json
+{
+  "mcpServers": {
+    "armut": {
+      "command": "uvx",
+      "args": ["armut-mcp"]
+    }
+  }
+}
+```
+
+Or run locally: `python -m armut_mcp.server` (needs `mcp<2`, `httpx`).
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `armut_search_services` | Search the 6,759-service catalogue by keyword — `query` ("temizlik", "nakliyat", "boyaci"), Turkish letters fine; returns slug, service_id, price-guide and service-page URLs |
+| `armut_service_detail` | Detail of one service (slug e.g. "ev-temizligi"): name, description, pro count, average rating, review count, service_id |
+| `armut_list_pros` | Top professionals for a service: name, city/district, member since, bio, rating, review count, profile URL; `city` ("istanbul") filters to that city; `limit` 1..40 |
+| `armut_service_faq` | Frequently asked questions for a service, with answers |
+| `armut_price_guide` | Price guide for a service: page-listed min/max price (TRY), 12 months of average/min/max prices with quote counts, total quotes, pro count, rating, real example jobs with winning prices, recent reviews; `city` ("adana") for that city's guide |
+| `armut_trending_services` | What's popular right now: service groups, trending/popular services with pro counts and ratings, most-searched city+service combos |
+
+Example output (`armut_search_services` / "temizlik"):
+
+```json
+{"query": "temizlik", "count": 10, "services": [
+  {"slug": "ev-temizligi", "name": "Ev Temizligi", "service_id": 191,
+   "price_url": "https://armut.com/fiyatlari/ev-temizligi_191",
+   "service_url": "https://armut.com/ev-temizligi"}, …]}
+```
+
+Example output (`armut_service_detail` / "ev-temizligi"):
+
+```json
+{"name": "Ev Temizliği", "service_id": 191, "pro_count": 10141,
+ "rating_average": 4.6, "review_count": 415591,
+ "description": "Güvenilir Ev Temizliği hizmeti al, zaman kazan, garantide ol. …",
+ "url": "https://armut.com/ev-temizligi"}
+```
+
+Example output (`armut_list_pros` / "ev-temizligi", istanbul, 1):
+
+```json
+{"service": "Ev Temizliği", "city": "istanbul", "count": 1, "pros": [
+  {"name": "Nermin K.", "location": "Şişli, İstanbul", "since": "…",
+   "bio": "…", "rating": 4.1, "review_count": 162,
+   "profile_url": "https://armut.com/hizmetveren/…"}]}
+```
+
+Example output (`armut_price_guide` / "ev-temizligi", adana):
+
+```json
+{"service": "Ev Temizliği", "service_id": 191, "city": "Adana",
+ "currency": "TRY", "min_price_try": 479, "max_price_try": 1024,
+ "quote_count": 790, "pro_count": 433, "rating_average": 4.6,
+ "monthly_average_try": [
+  {"month": "2025-11", "avg_try": 2756.39, "min_try": 1763,
+   "max_try": 3806, "quotes": 88}, …]}
+```
+
+Notes:
+- Data comes from armut.com's public server-rendered pages (schema.org Product/ItemList/FAQPage JSON-LD on service pages, `__NEXT_DATA__` on the homepage and price-guide pages, the public price sitemap) — no key, no login, read-only.
+- Turkish `-lik` nouns surface as `-ligi` in slugs ("temizlik" → "ev-temizligi"); the search handles that, so a plain "temizlik" query finds "ev-temizligi".
+- The page-listed min/max price and the 12 monthly averages come from different page fields; the monthly averages (with quote counts) are the more reliable price signal.
+- Requests are spaced ~0.8s apart to stay polite.
+- Environments behind an MITM proxy: set `SSL_CERT_FILE` to a CA bundle that trusts the proxy.
+
+## Development
+
+```bash
+python3 -m venv .venv && .venv/bin/pip install "mcp<2" httpx pytest
+.venv/bin/pip install -e .
+.venv/bin/python -m pytest tests/ -q
+```
+
+- `tests/test_services.py` — offline, parses real captured fixtures (29 tests)
+- `tests/test_live.py` — 8 cautious live requests against armut.com (needs `SSL_CERT_FILE` behind the lab proxy)
+
+## License
+
+MIT

armut_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "armut-mcp"
+version = "0.1.0"
+description = "Unofficial read-only MCP server for armut.com local services (search, pros, FAQs, price guides)"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+dependencies = [
+    "mcp<2",
+    "httpx>=0.27",
+]
+authors = [{ name = "Mohammad Abbasi" }]
+
+[project.scripts]
+armut-mcp = "armut_mcp.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/armut_mcp"]

armut_mcp-0.1.0/server.json

@@ -0,0 +1 @@
+{"$schema":"https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json","description":"Unofficial read-only MCP server for armut.com local services: search, pros, FAQs, price guides.","name":"io.github.mohammad-abbasi-sh/armut-mcp","packages":[{"identifier":"armut-mcp","registryBaseUrl":"https://pypi.org","registryType":"pypi","transport":{"type":"stdio"},"version":"0.1.0"}],"repository":{"source":"github","url":"https://github.com/mohammad-abbasi-sh/armut-mcp"},"title":"armut.com Local Services","version":"0.1.0","websiteUrl":"https://github.com/mohammad-abbasi-sh/armut-mcp"}