# Nobel Kitap LLM Integration Guide

> Turkiye'nin online kitap magazasi. Programatik erisim icin once auth.md okuyun; acik uç noktalar kimlik dogrulama gerektirmez.

## Authentication & API

- [auth.md — Agent registration & JWT](https://nobelkitap.com/auth.md): Kayit, giris, token yenileme ve agent_auth kesfi
- [OpenAPI spec](https://api.nobelkitap.com/api/v1/openapi.json): Makine okunur API semasi
- [API Catalog RFC 9727](https://nobelkitap.com/.well-known/api-catalog): Otomatik API kesfi
- [OAuth Protected Resource](https://nobelkitap.com/.well-known/oauth-protected-resource): RFC 9728 kaynak metadata
- [OAuth Authorization Server](https://nobelkitap.com/.well-known/oauth-authorization-server): agent_auth blogu
- [MCP Server Card](https://nobelkitap.com/.well-known/mcp/server-card.json): MCP/a2a kesif karti
- [UCP Profile](https://nobelkitap.com/.well-known/ucp): Universal Commerce Protocol — odeme ve checkout kesfi
- [Agent Skills index](https://nobelkitap.com/.well-known/agent-skills/index.json): Yayinlanan agent skill dosyalari

## Primary endpoints (base: https://api.nobelkitap.com/api/v1)

- Search books: `GET https://api.nobelkitap.com/api/v1/products/search?q={query}`
- Search suggestions: `GET https://api.nobelkitap.com/api/v1/products/search/suggestions?q={query}`
- Book by slug: `GET https://api.nobelkitap.com/api/v1/products/slug/{slug}`
- Categories: `GET https://api.nobelkitap.com/api/v1/categories`
- Best sellers: `GET https://api.nobelkitap.com/api/v1/products/best-sellers`
- New arrivals: `GET https://api.nobelkitap.com/api/v1/products/new-arrivals`
- Health: `GET https://api.nobelkitap.com/api/v1/health`

## Human-readable site

- Homepage: https://nobelkitap.com/
- Categories: https://nobelkitap.com/kategoriler
- Search: https://nobelkitap.com/arama

## Optional

- Markdown pages: `Accept: text/markdown` ile HTML yerine markdown alin
- Full agent guide: https://nobelkitap.com/auth.md