Ajanını kataloğa bağla

02Endpoint'ler

• GET /api/mcp/turler — Katalogtaki içerik türlerini döndürür: tur, başlık, liste yolu ve öğe adedi.
• GET /api/mcp/ogeler?tur=&kategori=&etiket= — Öğe künyelerini listeler (tam içerik yok): tur, slug, ad, özet, kategori, seviye, pro, etiketler. Üç filtre de isteğe bağlıdır ve birlikte uygulanır.
• GET /api/mcp/oge/{tur}/{slug}?format= — Tek öğe. format verilirse o formatın içeriği düz metin döner (doğrudan dosyaya yazılır); verilmezse JSON künye + format listesi + ham içerik kaydı döner. PRO öğelerde geçerli Bearer anahtarı gerekir.

?format= parametresi türe göre değişir; öğeyi format vermeden çektiğinde yanıttaki formatlar alanı o öğenin geçerli anahtarlarını listeler:

• ajanclaude-code | cursor | api
• skillclaude-code
• promptsistem | gorev | degiskenler
• mcpconfig | kurulum
• workflowscript
• sablonclaude-md | cursorrules
• hooksettings | aciklama

03Keşif: türler ve künyeler

Künye listesi bilinçli olarak hafiftir — tam içerik yoktur. Ajan önce künyelerle arar, sonra yalnız seçtiği öğeyi çeker; bağlam bütçesi boşa harcanmaz.

# Türleri ve adetleri gör
curl -s https://agents.talkdedsec.com/api/mcp/turler
 
# Kod kalitesi kategorisindeki ajan künyelerini listele
curl -s "https://agents.talkdedsec.com/api/mcp/ogeler?tur=ajan&kategori=kod-kalite"
 
# Etikete göre filtrele (ör. güvenlik)
curl -s "https://agents.talkdedsec.com/api/mcp/ogeler?etiket=g%C3%BCvenlik"

04Öğe çekme

format parametresi verildiğinde yanıt düz metindir ve doğrudan dosyaya yazılabilir. Format vermezsen JSON döner: künye, geçerli format anahtarları (önerilen dosya yollarıyla) ve ham içerik kaydı.

# Öğenin künyesini + kullanılabilir formatlarını gör (format vermeden)
curl -s https://agents.talkdedsec.com/api/mcp/oge/ajan/kod-inceleme-uzmani
 
# Claude Code formatını çek, doğrudan projene yaz
curl -s --create-dirs -o .claude/agents/kod-inceleme-uzmani.md \
  "https://agents.talkdedsec.com/api/mcp/oge/ajan/kod-inceleme-uzmani?format=claude-code"
 
# Aynı öğenin Cursor kuralını al
curl -s --create-dirs -o .cursor/rules/kod-inceleme-uzmani.mdc \
  "https://agents.talkdedsec.com/api/mcp/oge/ajan/kod-inceleme-uzmani?format=cursor"

05PRO öğeler ve Bearer anahtarı

Ücretsiz öğeler anahtarsız gelir. PRO işaretli öğelerin tam içeriği içinse isteğe Authorization: Bearer <lisans-anahtarı> başlığı eklenir; geçersiz veya eksik anahtarda API 402 döner. Anahtar, PRO abonelikle edinilir ve sitedeki lisans girişinde kullandığın anahtarın kendisidir. Anahtarını script'lere gömme; ortam değişkeninde tut.

# PRO öğede anahtarsız istek 402 döner:
#   { "hata": "pro-gerekli", "mesaj": "... Authorization: Bearer <lisans-anahtarı> gönder ..." }
 
# Lisans anahtarını Bearer başlığıyla gönder — tam içerik açılır
curl -s -H "Authorization: Bearer $TLK_AGENTS_KEY" \
  "https://agents.talkdedsec.com/api/mcp/oge/ajan/refactor-plancisi?format=claude-code"

06Ajana yönerge

Ajanın kataloğu kendiliğinden kullanması için CLAUDE.md'ye (ya da Cursor rules'a) kısa bir yönerge eklemen yeter:

## talkdedsec agents kataloğu
 
- Yeni bir subagent, skill veya prompt gerektiğinde önce katalogdan hazır
  öğe ara: https://agents.talkdedsec.com/api/mcp/ogeler?tur=<tur>
- Uygun öğeyi https://agents.talkdedsec.com/api/mcp/oge/<tur>/<slug>?format=claude-code
  adresinden çek ve künyedeki dosyaAdi yoluna kaydet
  (örn. .claude/agents/<slug>.md).
- Çektiğin içeriği değiştirme; sürüm ve güncelleme bilgisi katalogdan gelir.

Aynı API'yi bir kurulum betiğinde ya da CI hattında insan eliyle kullanmak istersen CLI ile kullan sayfasındaki curl/jq/PowerShell örneklerine bak.