eleman-net-mcp 0.1.0__tar.gz

eleman_net_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

eleman_net_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

eleman_net_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.

eleman_net_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,89 @@
+Metadata-Version: 2.5
+Name: eleman-net-mcp
+Version: 0.1.0
+Summary: Unofficial read-only MCP server for eleman.net jobs (search, job detail, sectors, cities, newest listings)
+Author: Mohammad Abbasi
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: curl-cffi>=0.7
+Requires-Dist: mcp<2
+Description-Content-Type: text/markdown
+
+# eleman-net-mcp 🇹🇷
+
+mcp-name: io.github.mohammad-abbasi-sh/eleman-net-mcp
+
+Unofficial **read-only** MCP server for eleman.net, Türkiye's blue-collar job board (#2 jobs site in Türkiye, ~4.4–5.1M visits/month per SimilarWeb) — search jobs by position or city, read full job details, list all 93 sectors and all 81 provinces, and fetch the newest listings.
+
+> Built by Mohammad Abbasi as part of the "Turkey MCP factory" (Sepehr-style pipeline). Not affiliated with eleman.net.
+
+## For AI agents
+
+Add to your MCP client config (stdio):
+
+```json
+{
+  "mcpServers": {
+    "eleman-net": {
+      "command": "uvx",
+      "args": ["eleman-net-mcp"]
+    }
+  }
+}
+```
+
+Or run locally: `python -m eleman_net_mcp.server` (needs `mcp<2`, `curl-cffi`).
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `eleman_search_jobs` | Search jobs — `keyword` (position, e.g. "garson", "şoför", "muhasebe"), `city` (e.g. "İstanbul", "Ankara"), `page` 1.., `limit` 1..30; returns jobs (id, title, company, location, snippet, URL) + pagination (197 pages on 2026-11-07) |
+| `eleman_get_job` | Full detail for one job — `job_url` (the `…/is-ilani/<slug>-i<id>` URL from a search result); returns title, date posted, employment type, full description, company (+ URL), location, region, education requirements |
+| `eleman_list_sectors` | All 93 job sectors on eleman.net (name + sector id), parsed from the site's own listing sidebar |
+| `eleman_list_cities` | All 81 Turkish provinces (+ the two İstanbul sides) with the eleman.net listing URL for each |
+| `eleman_new_listings` | The newest listings (first page, newest first), `limit` 1..30 |
+
+Example output (`eleman_search_jobs` / keyword "garson"):
+
+```json
+{"keyword": "garson", "count": 2, "jobs": [
+  {"title": "Garson", "company": "TAVUK DÜNYASI",
+   "location": "İstanbul Anadolu - Ataşehir",
+   "url": "https://www.eleman.net/is-ilani/…"}, …]}
+```
+
+## How it works
+
+eleman.net serves its listings fully server-rendered — no login, no API key, no session cookies. Listing pages carry 30 job cards each (`ilan_id_<id>` blocks: title, company, "City - District", snippet; urgent jobs carry an "ACİL İLAN" badge inside the title block and some cards carry a benefits chip span before the description — the parser handles both). Position and city pages share one slug namespace (`/is-ilanlari/<slug>`: garson, istanbul, ankara …); city + keyword combines the city slug with `?aranan=<keyword>&arandi=e`. Job detail pages carry a schema.org JobPosting JSON-LD block (title, datePosted, description, employmentType, location, company). A bare numeric id is not a valid detail URL — pass the full job URL from a search result (unknown slugs 301-redirect to the homepage, which the parser rejects). Transport uses Chrome TLS impersonation (`curl-cffi`, `chrome120`); requests are spaced ~0.8s apart; everything is read-only.
+
+Note: the site's own `/ara` search and the forum-style search are token-gated, so keyword search goes through the slug/param paths above, which are verified live. The autocomplete endpoint (`/arama_complete.php`) is disallowed in robots.txt and is not used.
+
+## Install
+
+```bash
+uvx eleman-net-mcp        # run directly (needs uv)
+# or
+pip install eleman-net-mcp
+eleman-net-mcp    # starts the MCP server on stdio
+```
+
+## Tests
+
+```bash
+python -m venv .venv && .venv/bin/pip install -e .
+.venv/bin/python -m unittest discover -s tests -v
+```
+
+Offline tests run on recorded fixtures (real pages fetched 2026-11-07); live tests hit eleman.net. 28/28 green at build time (15 offline + 13 live) plus an MCP stdio smoke test.
+
+## Roadmap
+
+- Sector-filtered search (`?sek[]=<id>` filter)
+- Company pages (`/firma/<slug>`: company jobs + profile)
+- Salary info where the site publishes it (rare in the JobPosting data)
+
+## License
+
+MIT — see [LICENSE](LICENSE).

eleman_net_mcp-0.1.0/README-fa.md

@@ -0,0 +1,77 @@
+# eleman-net-mcp 🇹🇷
+
+mcp-name: io.github.mohammad-abbasi-sh/eleman-net-mcp
+
+سرور MCP غیررسمی و **فقط-خواندنی** برای eleman.net، سایت کاریابی یقه‌آبی ترکیه (رتبهٔ ۲ دستهٔ مشاغل ترکیه، ‎~۴٫۴ تا ۵٫۱ میلیون بازدید در ماه طبق SimilarWeb) — جست‌وجوی شغل بر اساس سمت یا شهر، خواندن جزئیات کامل آگهی، فهرست هر ۹۳ بخش و هر ۸۱ استان، و دریافت تازه‌ترین آگهی‌ها.
+
+> ساخته‌شده توسط محمد عباسی در چارچوب «کارخانهٔ MCP ترکیه» (خط تولید به سبک سپهر). وابسته به eleman.net نیست.
+
+## برای ایجنت‌های هوش مصنوعی
+
+به پیکربندی MCP client خود اضافه کنید (stdio):
+
+```json
+{
+  "mcpServers": {
+    "eleman-net": {
+      "command": "uvx",
+      "args": ["eleman-net-mcp"]
+    }
+  }
+}
+```
+
+یا به‌صورت محلی اجرا کنید: `python -m eleman_net_mcp.server` (نیازمند `mcp<2` و `curl-cffi`).
+
+## ابزارها
+
+| ابزار | توضیح |
+|------|-------|
+| `eleman_search_jobs` | جست‌وجوی شغل — `keyword` (سمت، مثلاً «garson»، «şoför»، «muhasebe»)، `city` (مثلاً «İstanbul»، «Ankara»)، `page` از ۱، `limit` ۱ تا ۳۰؛ آگهی‌ها (شناسه، عنوان، شرکت، مکان، خلاصه، URL) + صفحه‌بندی (۱۹۷ صفحه در ۲۰۲۶-۱۱-۰۷) |
+| `eleman_get_job` | جزئیات کامل یک آگهی — `job_url` (نشانی `…/is-ilani/<slug>-i<id>` از نتیجهٔ جست‌وجو)؛ عنوان، تاریخ انتشار، نوع اشتغال، توضیح کامل، شرکت (+ URL)، مکان، منطقه، شرایط تحصیلی |
+| `eleman_list_sectors` | هر ۹۳ بخش شغلی eleman.net (نام + شناسهٔ بخش)، از نوار کناری خود سایت |
+| `eleman_list_cities` | هر ۸۱ استان ترکیه (+ دو سمت استانبول) با URL فهرست eleman.net برای هر یک |
+| `eleman_new_listings` | تازه‌ترین آگهی‌ها (صفحهٔ اول، از جدید به قدیم)، `limit` ۱ تا ۳۰ |
+
+خروجی نمونه (`eleman_search_jobs` / «garson»):
+
+```json
+{"keyword": "garson", "count": 2, "jobs": [
+  {"title": "Garson", "company": "TAVUK DÜNYASI",
+   "location": "İstanbul Anadolu - Ataşehir",
+   "url": "https://www.eleman.net/is-ilani/…"}, …]}
+```
+
+## نحوهٔ کار
+
+eleman.net آگهی‌ها را کاملاً سمت سرور رندر می‌کند — بدون ورود، کلید API و کوکی نشست. هر صفحهٔ فهرست ۳۰ کارت شغلی دارد (بلوک‌های `ilan_id_<id>`: عنوان، شرکت، «شهر - ناحیه»، خلاصه؛ آگهی‌های فوری نشان «ACİL İLAN» در بلوک عنوان دارند و بعضی کارت‌ها پیش از توضیح، برچسب مزایا دارند — تجزیه‌کننده هر دو را مدیریت می‌کند). صفحه‌های سمت و شهر یک فضای slug مشترک دارند (`/is-ilanlari/<slug>`: garson، istanbul، ankara و…)؛ ترکیب شهر + کلیدواژه، slug شهر را با `?aranan=<keyword>&arandi=e` ترکیب می‌کند. صفحه‌های جزئیات آگهی بلوک JobPosting از نوع JSON-LD از schema.org دارند (عنوان، datePosted، توضیح، employmentType، مکان، شرکت). شناسهٔ عددی تنها، URL معتبر جزئیات نیست — نشانی کامل آگهی را از نتیجهٔ جست‌وجو بدهید (slugهای ناشناخته با ۳۰۱ به صفحهٔ اصلی هدایت می‌شوند و تجزیه‌کننده آن را رد می‌کند). انتقال با جعل TLS کروم انجام می‌شود (`curl-cffi`، `chrome120`)؛ درخواست‌ها با فاصلهٔ ‎~۰٫۸ ثانیه فرستاده می‌شوند؛ همه‌چیز فقط-خواندنی است.
+
+توجه: جست‌وجوی `/ara` خود سایت و جست‌وجوی انجمن نیازمند توکن‌اند؛ پس جست‌وجوی کلیدواژه از مسیرهای slug/پارامتر بالا که به‌صورت زنده تأیید شده‌اند استفاده می‌کند. نقطهٔ پایانی تکمیل خودکار (`/arama_complete.php`) در robots.txt ممنوع است و استفاده نمی‌شود.
+
+## نصب
+
+```bash
+uvx eleman-net-mcp        # اجرای مستقیم (نیازمند uv)
+# یا
+pip install eleman-net-mcp
+eleman-net-mcp    # سرور MCP را روی stdio راه می‌اندازد
+```
+
+## تست‌ها
+
+```bash
+python -m venv .venv && .venv/bin/pip install -e .
+.venv/bin/python -m unittest discover -s tests -v
+```
+
+تست‌های آفلاین روی صفحات ضبط‌شده اجرا می‌شوند (صفحات واقعی دریافت‌شده در ۲۰۲۶-۱۱-۰۷)؛ تست‌های زنده به eleman.net وصل می‌شوند. در زمان ساخت ۲۸ از ۲۸ سبز بود (۱۵ آفلاین + ۱۳ زنده) به‌همراه یک تست دود MCP روی stdio.
+
+## نقشهٔ راه
+
+- جست‌وجوی فیلترشده بر اساس بخش (فیلتر `?sek[]=<id>`)
+- صفحه‌های شرکت (`/firma/<slug>`: آگهی‌ها + پروفایل شرکت)
+- اطلاعات حقوق در جاهایی که سایت منتشر می‌کند (در دادهٔ JobPosting نادر است)
+
+## مجوز
+
+MIT — ببینید [LICENSE](LICENSE).

eleman_net_mcp-0.1.0/README-tr.md

@@ -0,0 +1,77 @@
+# eleman-net-mcp 🇹🇷
+
+mcp-name: io.github.mohammad-abbasi-sh/eleman-net-mcp
+
+eleman.net için resmi olmayan **salt okunur** MCP sunucusu — Türkiye'nin mavi yaka iş ilanı sitesi (Türkiye'de iş kategorisinde 2. sırada, SimilarWeb'e göre ayda ~4,4–5,1 milyon ziyaret): pozisyona veya şehre göre iş arama, iş detaylarını okuma, 93 sektörün ve 81 ilin tamamını listeleme ve en yeni ilanları getirme.
+
+> Mohammad Abbasi tarafından "Turkey MCP factory" (Sepehr tarzı hat) kapsamında geliştirildi. eleman.net ile bağlantısı yoktur.
+
+## Yapay zekâ ajanları için
+
+MCP istemci yapılandırmanıza ekleyin (stdio):
+
+```json
+{
+  "mcpServers": {
+    "eleman-net": {
+      "command": "uvx",
+      "args": ["eleman-net-mcp"]
+    }
+  }
+}
+```
+
+Veya yerel çalıştırın: `python -m eleman_net_mcp.server` (`mcp<2`, `curl-cffi` gerekir).
+
+## Araçlar
+
+| Araç | Açıklama |
+|------|----------|
+| `eleman_search_jobs` | İş arama — `keyword` (pozisyon, örn. "garson", "şoför", "muhasebe"), `city` (örn. "İstanbul", "Ankara"), `page` 1.., `limit` 1..30; işler (id, başlık, firma, konum, özet, URL) + sayfalama (2026-11-07'de 197 sayfa) |
+| `eleman_get_job` | Tek bir işin tüm detayı — `job_url` (arama sonucundaki `…/is-ilani/<slug>-i<id>` URL'si); başlık, yayın tarihi, çalışma şekli, tam açıklama, firma (+ URL), konum, bölge, eğitim şartları |
+| `eleman_list_sectors` | eleman.net'teki 93 sektörün tamamı (ad + sektör id), sitenin kendi listeleme kenar çubuğundan |
+| `eleman_list_cities` | 81 ilin tamamı (+ İstanbul'un iki yakası) ve her biri için eleman.net listeleme URL'si |
+| `eleman_new_listings` | En yeni ilanlar (ilk sayfa, en yeniden), `limit` 1..30 |
+
+Örnek çıktı (`eleman_search_jobs` / "garson"):
+
+```json
+{"keyword": "garson", "count": 2, "jobs": [
+  {"title": "Garson", "company": "TAVUK DÜNYASI",
+   "location": "İstanbul Anadolu - Ataşehir",
+   "url": "https://www.eleman.net/is-ilani/…"}, …]}
+```
+
+## Nasıl çalışıyor?
+
+eleman.net ilanları tamamen sunucu taraflı render ediyor — giriş, API anahtarı ve oturum çerezi gerekmiyor. Listeleme sayfalarında sayfa başına 30 iş kartı var (`ilan_id_<id>` blokları: başlık, firma, "Şehir - İlçe", özet; acil işlerde başlık bloğunda "ACİL İLAN" rozeti, bazı kartlarda açıklama öncesinde yan hak rozeti bulunur — ayrıştırıcı ikisini de işler). Pozisyon ve şehir sayfaları tek bir slug alanını paylaşır (`/is-ilanlari/<slug>`: garson, istanbul, ankara …); şehir + anahtar kelime, şehir slug'ını `?aranan=<keyword>&arandi=e` ile birleştirir. İş detay sayfalarında schema.org JobPosting JSON-LD bloğu bulunur (başlık, datePosted, açıklama, employmentType, konum, firma). Yalın sayısal id geçerli bir detay URL'si değildir — arama sonucundaki tam iş URL'sini verin (bilinmeyen slug'lar ana sayfaya 301 yönlenir, ayrıştırıcı bunu reddeder). Aktarım Chrome TLS kimliğine bürünme kullanır (`curl-cffi`, `chrome120`); istekler ~0,8 sn arayla yapılır; her şey salt okunurdur.
+
+Not: Sitenin kendi `/ara` araması ve forum araması token gerektirir; anahtar kelime araması bu nedenle yukarıdaki, canlı doğrulanan slug/parametre yollarını kullanır. Otomatik tamamlama uç noktası (`/arama_complete.php`) robots.txt'de yasaklıdır ve kullanılmaz.
+
+## Kurulum
+
+```bash
+uvx eleman-net-mcp        # doğrudan çalıştır (uv gerekir)
+# veya
+pip install eleman-net-mcp
+eleman-net-mcp    # MCP sunucusunu stdio üzerinde başlatır
+```
+
+## Testler
+
+```bash
+python -m venv .venv && .venv/bin/pip install -e .
+.venv/bin/python -m unittest discover -s tests -v
+```
+
+Çevrimdışı testler kayıtlı örnek sayfalarla çalışır (2026-11-07'de çekilen gerçek sayfalar); canlı testler eleman.net'e bağlanır. Derleme anında 28/28 yeşil (15 çevrimdışı + 13 canlı) ve bir MCP stdio duman testi.
+
+## Yol haritası
+
+- Sektöre göre filtreli arama (`?sek[]=<id>` filtresi)
+- Firma sayfaları (`/firma/<slug>`: firmanın işleri + profili)
+- Sitenin yayınladığı yerlerde maaş bilgisi (JobPosting verisinde nadir)
+
+## Lisans
+
+MIT — bkz. [LICENSE](LICENSE).

eleman_net_mcp-0.1.0/README.md

@@ -0,0 +1,77 @@
+# eleman-net-mcp 🇹🇷
+
+mcp-name: io.github.mohammad-abbasi-sh/eleman-net-mcp
+
+Unofficial **read-only** MCP server for eleman.net, Türkiye's blue-collar job board (#2 jobs site in Türkiye, ~4.4–5.1M visits/month per SimilarWeb) — search jobs by position or city, read full job details, list all 93 sectors and all 81 provinces, and fetch the newest listings.
+
+> Built by Mohammad Abbasi as part of the "Turkey MCP factory" (Sepehr-style pipeline). Not affiliated with eleman.net.
+
+## For AI agents
+
+Add to your MCP client config (stdio):
+
+```json
+{
+  "mcpServers": {
+    "eleman-net": {
+      "command": "uvx",
+      "args": ["eleman-net-mcp"]
+    }
+  }
+}
+```
+
+Or run locally: `python -m eleman_net_mcp.server` (needs `mcp<2`, `curl-cffi`).
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `eleman_search_jobs` | Search jobs — `keyword` (position, e.g. "garson", "şoför", "muhasebe"), `city` (e.g. "İstanbul", "Ankara"), `page` 1.., `limit` 1..30; returns jobs (id, title, company, location, snippet, URL) + pagination (197 pages on 2026-11-07) |
+| `eleman_get_job` | Full detail for one job — `job_url` (the `…/is-ilani/<slug>-i<id>` URL from a search result); returns title, date posted, employment type, full description, company (+ URL), location, region, education requirements |
+| `eleman_list_sectors` | All 93 job sectors on eleman.net (name + sector id), parsed from the site's own listing sidebar |
+| `eleman_list_cities` | All 81 Turkish provinces (+ the two İstanbul sides) with the eleman.net listing URL for each |
+| `eleman_new_listings` | The newest listings (first page, newest first), `limit` 1..30 |
+
+Example output (`eleman_search_jobs` / keyword "garson"):
+
+```json
+{"keyword": "garson", "count": 2, "jobs": [
+  {"title": "Garson", "company": "TAVUK DÜNYASI",
+   "location": "İstanbul Anadolu - Ataşehir",
+   "url": "https://www.eleman.net/is-ilani/…"}, …]}
+```
+
+## How it works
+
+eleman.net serves its listings fully server-rendered — no login, no API key, no session cookies. Listing pages carry 30 job cards each (`ilan_id_<id>` blocks: title, company, "City - District", snippet; urgent jobs carry an "ACİL İLAN" badge inside the title block and some cards carry a benefits chip span before the description — the parser handles both). Position and city pages share one slug namespace (`/is-ilanlari/<slug>`: garson, istanbul, ankara …); city + keyword combines the city slug with `?aranan=<keyword>&arandi=e`. Job detail pages carry a schema.org JobPosting JSON-LD block (title, datePosted, description, employmentType, location, company). A bare numeric id is not a valid detail URL — pass the full job URL from a search result (unknown slugs 301-redirect to the homepage, which the parser rejects). Transport uses Chrome TLS impersonation (`curl-cffi`, `chrome120`); requests are spaced ~0.8s apart; everything is read-only.
+
+Note: the site's own `/ara` search and the forum-style search are token-gated, so keyword search goes through the slug/param paths above, which are verified live. The autocomplete endpoint (`/arama_complete.php`) is disallowed in robots.txt and is not used.
+
+## Install
+
+```bash
+uvx eleman-net-mcp        # run directly (needs uv)
+# or
+pip install eleman-net-mcp
+eleman-net-mcp    # starts the MCP server on stdio
+```
+
+## Tests
+
+```bash
+python -m venv .venv && .venv/bin/pip install -e .
+.venv/bin/python -m unittest discover -s tests -v
+```
+
+Offline tests run on recorded fixtures (real pages fetched 2026-11-07); live tests hit eleman.net. 28/28 green at build time (15 offline + 13 live) plus an MCP stdio smoke test.
+
+## Roadmap
+
+- Sector-filtered search (`?sek[]=<id>` filter)
+- Company pages (`/firma/<slug>`: company jobs + profile)
+- Salary info where the site publishes it (rare in the JobPosting data)
+
+## License
+
+MIT — see [LICENSE](LICENSE).

eleman_net_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "eleman-net-mcp"
+version = "0.1.0"
+description = "Unofficial read-only MCP server for eleman.net jobs (search, job detail, sectors, cities, newest listings)"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+dependencies = [
+    "mcp<2",
+    "curl-cffi>=0.7",
+]
+authors = [{ name = "Mohammad Abbasi" }]
+
+[project.scripts]
+eleman-net-mcp = "eleman_net_mcp.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/eleman_net_mcp"]

eleman_net_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 eleman.net jobs: search, detail, sectors, cities.","name":"io.github.mohammad-abbasi-sh/eleman-net-mcp","packages":[{"identifier":"eleman-net-mcp","registryBaseUrl":"https://pypi.org","registryType":"pypi","transport":{"type":"stdio"},"version":"0.1.0"}],"repository":{"source":"github","url":"https://github.com/mohammad-abbasi-sh/eleman-net-mcp"},"title":"eleman.net Jobs","version":"0.1.0","websiteUrl":"https://github.com/mohammad-abbasi-sh/eleman-net-mcp"}

eleman_net_mcp-0.1.0/src/eleman_net_mcp/__init__.py

@@ -0,0 +1 @@
+"""eleman_net_mcp — unofficial read-only MCP server for eleman.net."""

eleman_net_mcp-0.1.0/src/eleman_net_mcp/cities.py

@@ -0,0 +1,31 @@
+"""Turkish provinces for eleman_net_mcp.
+
+PROVINCES: the 81 provinces of Türkiye with the slug eleman.net
+uses for city listing pages (/is-ilanlari/<slug>). Slugs follow the
+site's deterministic pattern (Turkish-aware lowercase, ASCII fold,
+spaces -> hyphens); the pattern is verified live for İstanbul,
+Ankara, İzmir, Bursa, Antalya, Şanlıurfa and Diyarbakır. The two
+İstanbul sides are extra entries — the site lists them separately.
+"""
+from __future__ import annotations
+
+PROVINCES = [
+    "Adana", "Adıyaman", "Afyonkarahisar", "Ağrı", "Aksaray",
+    "Amasya", "Ankara", "Antalya", "Ardahan", "Artvin", "Aydın",
+    "Balıkesir", "Bartın", "Batman", "Bayburt", "Bilecik",
+    "Bingöl", "Bitlis", "Bolu", "Burdur", "Bursa", "Çanakkale",
+    "Çankırı", "Çorum", "Denizli", "Diyarbakır", "Düzce",
+    "Edirne", "Elazığ", "Erzincan", "Erzurum", "Eskişehir",
+    "Gaziantep", "Giresun", "Gümüşhane", "Hakkari", "Hatay",
+    "Iğdır", "Isparta", "İstanbul", "İzmir", "Kahramanmaraş",
+    "Karabük", "Karaman", "Kars", "Kastamonu", "Kayseri",
+    "Kırıkkale", "Kırklareli", "Kırşehir", "Kilis", "Kocaeli",
+    "Konya", "Kütahya", "Malatya", "Manisa", "Mardin", "Mersin",
+    "Muğla", "Muş", "Nevşehir", "Niğde", "Ordu", "Osmaniye",
+    "Rize", "Sakarya", "Samsun", "Siirt", "Sinop", "Sivas",
+    "Şanlıurfa", "Şırnak", "Tekirdağ", "Tokat", "Trabzon",
+    "Tunceli", "Uşak", "Van", "Yalova", "Yozgat", "Zonguldak",
+]
+
+# Extra site entries (not provinces): the two İstanbul sides.
+ISTANBUL_SIDES = ["İstanbul Anadolu", "İstanbul Avrupa"]

eleman_net_mcp-0.1.0/src/eleman_net_mcp/http.py

@@ -0,0 +1,89 @@
+"""HTTP layer for eleman_net_mcp.
+
+eleman.net serves its job listings fully server-rendered — no login,
+no API key, no session cookies. Plain HTTP 200 with a browser UA
+(verified live 2026-11-07: /is-ilanlari, /is-ilanlari/garson,
+/is-ilani/<slug>-i<id>, city+keyword combos). The transport still
+uses curl-cffi chrome120 impersonation, the same proven pattern as
+the other Turkey-factory servers. Requests are kept gentle (one at
+a time, ~0.8s apart) and read-only.
+
+Search paths (all verified live):
+- /is-ilanlari — newest listings, ?sy=N pages (30 cards/page)
+- /is-ilanlari/<slug> — position or city slug (garson, istanbul, ...)
+- /is-ilanlari/<city-slug>?aranan=<keyword>&arandi=e — city + keyword
+- /is-ilani/<slug>-i<id> — job detail (JobPosting JSON-LD)
+"""
+from __future__ import annotations
+
+import time
+from urllib.parse import quote, urlencode
+
+from curl_cffi import requests as _r
+
+BASE = "https://www.eleman.net"
+TIMEOUT = 30.0
+MIN_INTERVAL = 0.8  # seconds between requests — be polite
+
+_HEADERS = {
+    "Accept-Language": "tr-TR,tr;q=0.9,en;q=0.8",
+    "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8",
+}
+
+_last_fetch = 0.0
+
+
+class ElemanError(RuntimeError):
+    pass
+
+
+def _get(url: str) -> str:
+    global _last_fetch
+    wait = MIN_INTERVAL - (time.monotonic() - _last_fetch)
+    if wait > 0:
+        time.sleep(wait)
+    try:
+        resp = _r.get(url, impersonate="chrome120", headers=_HEADERS, timeout=TIMEOUT)
+    except Exception as e:
+        raise ElemanError(f"network error fetching {url}: {e}") from e
+    finally:
+        _last_fetch = time.monotonic()
+    if resp.status_code == 403:
+        raise ElemanError(
+            "eleman.net refused the request (HTTP 403, bot wall) — try again later"
+        )
+    if resp.status_code == 429:
+        raise ElemanError(
+            "eleman.net rate-limited the request (HTTP 429) — try again later"
+        )
+    if resp.status_code == 404:
+        raise ElemanError(f"page not found (HTTP 404): {url}")
+    if resp.status_code != 200:
+        raise ElemanError(f"unexpected HTTP {resp.status_code} fetching {url}")
+    return resp.text
+
+
+def fetch_listings(path: str = "", page: int = 1, keyword: str | None = None) -> str:
+    """Listing page. path: '' or a position/city slug; keyword adds
+    ?aranan=<keyword>&arandi=e (used together with a city slug)."""
+    url = f"{BASE}/is-ilanlari"
+    if path:
+        url += f"/{quote(path)}"
+    params: dict[str, str] = {}
+    if keyword:
+        params["aranan"] = keyword
+        params["arandi"] = "e"
+    if page and page > 1:
+        params["sy"] = str(page)
+    if params:
+        url += "?" + urlencode(params)
+    return _get(url)
+
+
+def fetch_job_page(path: str) -> str:
+    """Job detail page: /is-ilani/<slug>-i<id> (full path or URL)."""
+    if path.startswith("http"):
+        url = path
+    else:
+        url = f"{BASE}/{path.lstrip('/')}"
+    return _get(url)