# IADEOS, makineler için.

> IADEOS'u makineler için okuyun ve kullanın: llms.txt, Markdown sürümler, OpenAPI, ücretsiz hesap API'si ve MCP sunucusu; sınırlar ve örnekler.

Kaynak: https://av.iadeos.com/gelistiriciler/ · Güncelleme: 2026-10-12

Yapay zekâ yanıt motorları ve ajanlar için ayrı bir kapı: her sayfanın Markdown sürümü, llms.txt, OpenAPI ile tanımlı ücretsiz hesap API'si ve MCP sunucusu. Aynı kurallar, aynı kaynaklar; insan için sayfa, makine için uç.

## Makine kapısı

Bir ajan bu siteyi ekran görüntüsünden okumak zorunda değildir. Aşağıdaki dosyalar ve uçlar aynı içerik kaynağından üretilir; bir sayfa değiştiğinde Markdown sürümü, llms dosyaları ve site haritası da değişir.

| Adres | Ne verir | Biçim |
| --- | --- | --- |
| `/llms.txt` | Sitenin yapay zekâ için özeti: ne yapar, sayfalar, kurallar (llmstxt.org biçimi). | text/plain |
| `/llms-full.txt` | Bütün sayfaların Markdown metni tek dosyada. | text/plain |
| `/<sayfa>.md` | Her sayfanın Markdown sürümü; aynı adres `Accept: text/markdown` ile de istenebilir. | text/markdown |
| `/sitemap.xml` | Bütün dizine açık sayfalar, içerik değiştiğinde güncellenen lastmod ile. | application/xml |
| `/.well-known/api-catalog` | API kataloğu (RFC 9727): OpenAPI, belgeler, durum ucu ve MCP sunucusu. | application/linkset+json |
| `/openapi.json` | Hesap ve giriş uçlarının OpenAPI 3.1 tanımı. | application/json |
| `/mcp` | Model Context Protocol sunucusu (Streamable HTTP): beş deterministik araç. | application/json |
| `/robots.txt` | Tarama kuralları ve kullanım sinyali: search=yes, ai-input=yes, ai-train=no. | text/plain |
| `/.well-known/security.txt` | Güvenlik açığı bildirimi (RFC 9116). | text/plain |
| `/.well-known/gpc.json` | Global Privacy Control desteği. | application/json |

## Hesap API'si

Ücretsiz araçların hesapları bir API olarak da açıktır. Hesaplar deterministiktir: aynı girdi her zaman aynı sonucu verir; sonuç, girdi ve kuralıyla birlikte SHA-256 ile mühürlenir. Kimlik doğrulama gerekmez; dakikada 60 istekle sınırlıdır.

| Yöntem | Uç | Ne yapar |
| --- | --- | --- |
| POST | `/api/v1/hesap/fark` | İlave ücret tavanı, fazla, kanuni faiz ve toplam. Gövde: charged, sgk, paid, asOf, exemption. |
| POST | `/api/v1/hesap/faiz` | Dönemlere bölünmüş kanuni faiz. Gövde: principal, from, to. |
| GET | `/api/v1/basvuru-yolu?tutar=&yil=` | Tüketici hakem heyeti mi, arabulucu ve mahkeme mi. |
| GET | `/api/v1/istisnalar` | İlave ücret alınamayan hizmetler ve kişiler. |
| GET | `/api/v1/oranlar` | Kanuni faiz dönemleri ve hakem heyeti sınırları, kaynaklarıyla. |
| GET | `/api/v1/sozluk?q=` | Sözlük (DefinedTermSet); q ile arama. |

### Örnek: fark hesabı

```
curl -X POST https://av.iadeos.com/api/v1/hesap/fark \
  -H 'Content-Type: application/json' \
  -d '{"charged": 2400, "sgk": 800, "paid": "2026-03-14", "asOf": "2026-10-12"}'
```

```
{
  "cap": 1600,
  "excess": 800,
  "total": 922.87,
  "rule": "tavan",
  "interest": {
    "total": 122.87,
    "days": 212,
    "lines": [
      {
        "from": "2026-03-15",
        "to": "2026-07-30",
        "days": 138,
        "rate": 0.24,
        "amount": 72.59,
        "basis": "3095 s.K. m.1 · CB Kararı 8485 (RG 21.05.2024)"
      },
      {
        "from": "2026-07-31",
        "to": "2026-10-12",
        "days": 74,
        "rate": 0.31,
        "amount": 50.28,
        "basis": "3095 s.K. m.1 · 7589 s.K. (RG 31.07.2026), reeskont × %80"
      }
    ]
  },
  "seal": "sha256:…"
}
```

Örnekteki tutarlar gösterim amaçlıdır; sonuç, sitedeki fark tezgâhıyla aynı koddan çıkar.

## MCP sunucusu

Model Context Protocol destekleyen bir istemci, IADEOS'un hesap araçlarını doğrudan çağırabilir. Sunucu Streamable HTTP üzerinden JSON-RPC konuşur; araçların girdileri JSON Schema ile tanımlıdır.

| Araç | Ne yapar |
| --- | --- |
| `ilave_ucret_farki` | Tavan, fazla, faiz ve toplam |
| `kanuni_faiz` | Dönem dönem kanuni faiz |
| `basvuru_yolu` | Tutar ve yıla göre başvuru yolu |
| `istisnalar` | İlave ücret istisnaları |
| `sozluk` | Terim tanımı, dayanağı ve kaynağı |

```
{
  "mcpServers": {
    "iadeos": {
      "type": "http",
      "url": "https://av.iadeos.com/mcp"
    }
  }
}
```

## Kullanım

- **Kullanım sinyali.** robots.txt içinde `Content-Signal: search=yes, ai-input=yes, ai-train=no`: arama ve yanıt için okunabilir, model eğitimi için kullanılmasın.
- **Alıntı.** Bir tanımı ya da kuralı alıntılarken sayfanın bağlantısını verin; her sayfa kaynağını gösterir.
- **Hukuki görüş değildir.** API ve MCP çıktıları hesaptır; somut olay için avukatın değerlendirmesi gerekir.
- **Tarayıcı konsolu.** Her sayfa, hata ve uyarı olmadan yüklenir; bu her ölçümde denetlenir.

## Hazırlık ölçümü

Son ölçüm **2026-10-12**: Makine Hazırlık Endeksi **18/18** (ölçülebilen denetimler), genişletilmiş denetimler **40/40**. Kanıt dosyaları SHA-256 ile mühürlüdür; kayıt zinciri 6 çalıştırma uzunluğundadır.

Ölçüm, bir tez çalışmasındaki 18 denetimli Makine Hazırlık Endeksi'ni (ajanlar, arama, güven, hız) ve IADEOS'a özgü genişletilmiş denetimleri, dışarıdan ve kimlik bilgisi olmadan çalıştırır.

## Kaynaklar

1. [The /llms.txt file — a proposal to provide information to help LLMs use websites](https://llmstxt.org/) · J. Howard, 03.09.2024
2. [RFC 9727: api-catalog — a well-known URI and link relation to help discovery of APIs](https://www.rfc-editor.org/rfc/rfc9727) · IETF, 2025
3. [Model Context Protocol — specification](https://modelcontextprotocol.io/) · modelcontextprotocol.io
4. [Content Signals Policy (search, ai-input, ai-train)](https://contentsignals.org/) · Cloudflare, 2025
5. [RFC 9116: A File Format to Aid in Security Vulnerability Disclosure (security.txt)](https://www.rfc-editor.org/rfc/rfc9116) · IETF, 2022
6. [Global Privacy Control — specification and /.well-known/gpc.json](https://globalprivacycontrol.org/) · globalprivacycontrol.org