Ana Sayfa Geliştiriciler ve AI ajanları
GeliştiricilerDuyuSense içeriğine AI ajanlarından ve koddan erişin
Bu sitedeki her şey makine tarafından okunabilir biçimde de sunulur: açık ve salt okunur bir REST API, bir MCP sunucusu, bir A2A ajanı, her sayfanın Markdown sürümü ve llms.txt. Kayıt ya da API anahtarı gerekmez.
Ajanlar için Markdown
Herhangi bir sayfayı Accept: text/markdown başlığıyla isterseniz sade bir Markdown sürümü döner (x-markdown-tokens başlığıyla birlikte). Tarayıcılar HTML almaya devam eder. Her sayfa Markdown karşılığını rel="alternate" type="text/markdown" ile de bildirir.
llms.txt
/llms.txt en önemli sayfaları tek satırlık özetlerle listeler; /llms-full.txt tüm sayfaların tam metnini Markdown olarak içerir.
REST API (salt okunur)
Taban adres https://www.duyusense.com/api/v1. Uç noktalar: GET /pages, GET /pages/{id}, GET /search?q=...&lang=tr, GET /company, GET /health. OpenAPI 3.1 tanımı: /openapi.json; katalog: /.well-known/api-catalog (RFC 9727).
MCP sunucusu
Streamable HTTP uç noktası https://www.duyusense.com/mcp (durumsuz, JSON yanıt). Araçlar: search_duyusense, get_page, list_solutions, get_company_info. Sunucu kartı: /.well-known/mcp/server-card.json.
A2A ajanı
JSON-RPC uç noktası https://www.duyusense.com/a2a (message/send). Soruları ilgili DuyuSense rehberlerini bularak yanıtlar. Ajan kartı: /.well-known/agent-card.json.
Ajan becerileri
Ajanlar için beceri dizini: /.well-known/agent-skills/index.json (fiber algılama teknolojisi seçimi, DuyuSense bilgisini sorgulama, proje talebi hazırlama).
WebMCP
WebMCP destekleyen tarayıcılarda site, sayfa içi araçları (arama, sayfa getirme, iletişim bilgisi) document.modelContext üzerinden kaydeder.
Kimlik doğrulama ve kullanım
Tüm uç noktalar açık, anonim ve salt okunurdur; ayrıntı: /auth.md. İçerik, DuyuSense (www.duyusense.com) kaynak gösterilerek arama, AI yanıtları ve eğitim için kullanılabilir. Otomatik trafiği makul düzeyde tutmanızı rica ederiz.
Örnek
curl -s 'https://www.duyusense.com/api/v1/search?q=denizalt%C4%B1%20kablo&lang=tr'
curl -s -H 'Accept: text/markdown' https://www.duyusense.com/rehber/das-ve-fbg-farki