Eymex Content Discovery API

AI ajanları, LLM tabanlı araçlar ve crawler'lar için Eymex tanıtım sitesinin sunduğu salt-okunur içerik keşif endpoint'leri. Kimlik doğrulama gerekmez. Tüm cevaplar deterministik ve cache'lenebilir.

OpenAPI 3.1RFC 9727 — API Catalogllms.txtAgent Skills v0.2.0MCP (SEP-1649)

Hızlı Başlangıç

  1. GET https://www.eymex.app/.well-known/api-catalog — tüm hizmet linklerini keşfedin.
  2. GET https://www.eymex.app/api/openapi.json — makine-okunur OpenAPI spec'ini alın.
  3. İçerik keşfi için /llms.txt veya /llms-full.txt'i tarayın.

Endpoint'ler

GET/.well-known/api-catalog→ application/linkset+json

API Catalog (RFC 9727)

Bu API'ye ait service-desc, service-doc, status ve describedby linklerini içeren linkset.

{
  "linkset": [{
    "anchor": "https://www.eymex.app/api",
    "links": [
      { "rel": "service-desc", "href": "https://www.eymex.app/api/openapi.json" },
      { "rel": "service-doc",  "href": "https://www.eymex.app/docs/api" },
      { "rel": "status",       "href": "https://www.eymex.app/api/health" }
    ]
  }]
}
GET/api/openapi.json→ application/openapi+json

OpenAPI 3.1 Spesifikasyonu

Tüm content discovery endpoint'lerini ve şemalarını tanımlayan OpenAPI 3.1 dokümanı.

{
  "openapi": "3.1.0",
  "info": { "title": "Eymex Content Discovery API", "version": "1.0.0" },
  "paths": { "/sitemap.xml": { "get": { ... } }, ... }
}
GET/api/health→ application/json

Sağlık Kontrolü

Servis sağlık raporu. Cache'lenmez; her istekte güncel timestamp döner.

{
  "status": "ok",
  "service": "eymex-content-discovery",
  "version": "1.0.0",
  "timestamp": "2026-04-20T10:00:00.000Z"
}
GET/sitemap.xml→ application/xml

XML Sitemap

Tüm public sayfaların URL listesi (sektör, blog, pillar dahil).

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
  <url><loc>https://www.eymex.app/</loc>...</url>
  ...
</urlset>
GET/robots.txt→ text/plain

Robots Policy + Content Signals

Tarayıcı kuralları ve `Content-Signal` direktifi (ai-train=yes, search=yes, ai-input=yes).

User-agent: *
Allow: /
Disallow: /api/
Content-Signal: ai-train=yes, search=yes, ai-input=yes

Sitemap: https://www.eymex.app/sitemap.xml
GET/llms.txt→ text/plain

llms.txt — Kanonik Kısa İndeks

LLM'ler için optimize edilmiş kısa içerik indeksi (llmstxt.org standardı).

# Eymex

> Halı, koltuk ve kuru temizleme işletmeleri için ...

## Kanonik Cevaplar
- ...
GET/llms-full.txt→ text/plain

llms-full.txt — Tüm İçerik Tek Dosyada

Sektör sayfaları, pillar rehber ve tüm blog yazılarının tek dosyada toplanmış markdown sürümü.

# Eymex — Tam İçerik (LLM'ler için)

## Eymex Ürün Özeti
...
GET/.well-known/agent-skills/index.json→ application/json

Agent Skills İndeksi

Agent Skills Discovery RFC v0.2.0 uyumlu skill listesi (sha256 dijestleriyle).

{
  "$schema": "https://agentskills.io/schemas/v0.2.0/index.json",
  "skills": [
    { "name": "eymex-product-overview", "type": "markdown", "url": "...", "sha256": "..." }
  ]
}
GET/.well-known/mcp/server-card.json→ application/json

MCP Server Card (SEP-1649)

Model Context Protocol sunucu kartı: serverInfo, transport endpoint ve capabilities. Ajanlar bunu okuyup /api/mcp üzerinden tools/call yapabilir.

{
  "serverInfo": { "name": "eymex-content-discovery", "version": "1.0.0" },
  "protocol": { "name": "mcp", "version": "2025-06-18" },
  "transport": { "type": "http", "subtype": "streamable-http", "endpoint": "https://www.eymex.app/api/mcp" },
  "capabilities": { "tools": { "listChanged": false } },
  "tools": ["list_sectors", "get_sector", "list_blog_posts", "get_blog_post", "get_pillar_guide", "get_product_overview"]
}

Markdown İçerik Müzakeresi

Aşağıdaki sayfalar Accept: text/markdown başlığı ile istendiğinde HTML yerine kanonik markdown sürümünü döner. Cevap Content-Type: text/markdown, Content-Location, Vary: Accept ve X-Markdown-Tokens başlıkları ile gelir.

  • /
  • /blog
  • /blog/{slug}
  • /sektorler/{slug}
  • /en-iyi-hali-yikama-programi
curl -H 'Accept: text/markdown' https://www.eymex.app/blog/qr-kodlu-siparis-takibi

MCP — Model Context Protocol

Eymex, salt-okunur içerik için bir Model Context Protocol sunucusu yayınlar. Ajanlar önce /.well-known/mcp/server-card.json (SEP-1649) kartını okur, ardından /api/mcp uç noktasına JSON-RPC 2.0 isteği yapar.

Araçlar

  • list_sectors — desteklenen sektörlerin listesi
  • get_sector(slug) — sektör sayfasının markdown sürümü
  • list_blog_posts(category?) — blog yazıları listesi
  • get_blog_post(slug) — blog yazısının markdown içeriği
  • get_pillar_guide — "En İyi Halı Yıkama Programı" pillar rehberi
  • get_product_overview — Eymex ürün özeti

Örnek: tools/list

curl -s -X POST https://www.eymex.app/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Örnek: tools/call

curl -s -X POST https://www.eymex.app/api/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_sector","arguments":{"slug":"hali-yikama"}}}'

Lisans ve Kullanım

Bu endpoint'ler kamuya açıktır ve AI eğitimi, arama indeksleme, agent input olarak kullanım için açıkça izin verilmiştir (bkz. /robots.txt içindeki Content-Signal: ai-train=yes, search=yes, ai-input=yes).

İletişim: [email protected]