AI ajanları ve MCP

Halüsinasyonlar yerine gerçek astrolojik hesaplamalar yapması gereken bir yapay zeka ajanı mı inşa ediyorsun? AstroWay, Claude (Anthropic), ChatGPT-4 (OpenAI), Llama 3.3 (Groq), DeepSeek, Google Gemini, Mistral’a MCP, llms.txt veya doğrudan HTTP çağrıları aracılığıyla bağlanır. Üç entegrasyon yöntemi - ajan tipine göre seç:

• llms.txt: dokümantasyonu okuyan ajanlar için keşif dosyaları (Cursor IDE, Windsurf, tarayıcıda Claude, LangChain/LlamaIndex üzerinde özel RAG işlem hatları).
• MCP sunucusu: Claude Desktop, Cursor IDE, Windsurf, VS Code (llm CLI) ve herhangi bir MCP uyumlu istemci (OpenAI Realtime API aracılığıyla MCP’li GPT dahil) için sıfır kod.
• HTTP API: kendi ajanından veya framework’ünden (LangChain, LlamaIndex, AutoGen, CrewAI) doğrudan çağrı.

llms.txt: Yapay Zeka Ajanları için Keşif

Site, llms.txt formatında iki makine tarafından okunabilir dosya sunar:

• /llms.txt: tüm dokümantasyon sayfalarının bölümlere göre gruplandırılmış indeksi (API Referansı, Kullanım Durumları, Örnekler, Ürünler). Küçük boyutlu, herhangi bir bağlam penceresine sığar.
• /llms-full.txt: tüm dokümantasyon içeriği tek bir düz metin dosyası olarak. Vektör veritabanında çevrimdışı indeksleme veya tek seferlik bağlama enjeksiyonu için uygundur.

Ne Zaman Kullanmalı

Senaryo	Dosya
Cursor/Windsurf “astroway belgelerini oku ve entegrasyonda yardımcı ol”	/llms.txt (ajan gerekli bölümleri kendi çeker)
Kendi RAG işlem hattın / SSS botu için vektör VT	/llms-full.txt (tek bir çekme - tüm içerik)
Tarayıcıda Claude/ChatGPT: “işte API’mız, bir istemci oluştur”	/llms-full.txt isteme yapıştır
Çağrıları yürüten üretim ajanı	MCP sunucusu veya HTTP API (aşağıya bakınız)

Örnek: Kendi Ajanına Çekme

const docs = await fetch('https://api.astroway.info/llms-full.txt').then(r => r.text());

const systemPrompt = `You are an integration assistant for AstroWay API.
Documentation:
${docs}

When the user asks how to do X, return a working code snippet using their API key.`;

Not

Dosyalar, sitenin her sürümünde otomatik olarak yeniden oluşturulur. Güncellik garantilidir: /llms.txt dosyasının sonundaki API sürümü, mevcut üretim dağıtımıyla eşleşir.

MCP Sunucusu (Claude Desktop için Önerilir)

Model Context Protocol (MCP) - araçları yapay zeka modellerine bağlamak için açık bir standarttır. AstroWay MCP sunucusu, her API işlemi için birer tane olmak üzere 783 araç, ayrıca 12 istem ve 14 kaynak sağlar.

Claude Desktop için Ayarlar

claude_desktop_config.json dosyasına ekle:

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["@astroway/mcp"],
      "env": {
        "ASTROWAY_API_KEY": "aw_live_your_key_here"
      }
    }
  }
}

Claude Desktop yeniden başlatıldıktan sonra tüm 783 aracı görecektir. Listeyi kısaltmak için ASTROWAY_TOOL_GROUPS’u ayarlayın veya bir alan sunucusu bağlayın, bkz. MCP ayarları.

MCP Sunucusu Neler Yapabilir

Araç	Ne Yapar
astroway_western_chart	Natal harita hesaplaması
astroway_relational_synastry	İki kişinin sinastrisi
astroway_horoscope_daily	Günlük burç yorumu
astroway_ai_interpret_natal	Yapay zeka ile natal harita yorumu
astroway_hd_human_design	Tam HD haritası
astroway_prognostics_transits	Mevcut transitler

Tam liste: 783 araç, tüm API, her biri tiplendirilmiş yanıt şemasıyla.

Claude ile Diyalog Örneği

Kullanıcı: 14 Temmuz 1990’da saat 14:30’da Kiev’de doğan bir kişi için natal harita oluştur. Yengeç burcundaki Güneş’in 10. evde olması ne anlama geliyor?

Claude: Hesaplama için astroway_western_chart’ı, ardından yorumlama için astroway_ai_interpret_placement’ı kullanır. Gerçek verilerle gezegen konumlarını ve anlamlı bir yorumu döndürür.

HTTP API

MCP desteği olmayan yapay zeka ajanları için - HTTP API’yi doğrudan kullan.

İçerik Oluşturma için

TypeScript

// The AI agent calls /interpret/natal for an interpretation
const r = await fetch('https://api.astroway.info/v1/interpret/natal', {
  method: 'POST',
  headers: {
    'X-Api-Key': process.env.ASTROWAY_API_KEY!,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    date: '1990-07-14',
    time: '14:30:00',
    timezoneOffset: 3,
    latitude: 50.4501,
    longitude: 30.5234,
  }),
});

const { data: result } = await r.json();
// result.interpretation - ready AI interpretation
// result.disclaimer - disclaimer to display

Python

import os, requests

r = requests.post(
    'https://api.astroway.info/v1/interpret/natal',
    headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY']},
    json={
        'date': '1990-07-14',
        'time': '14:30:00',
        'timezoneOffset': 3,
        'latitude': 50.4501,
        'longitude': 30.5234,
    },
)
result = r.json()['data']
# result['interpretation'] - ready AI interpretation
# result['disclaimer']     - disclaimer to display

cURL

curl -X POST https://api.astroway.info/v1/interpret/natal \
  -H "X-Api-Key: $ASTROWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234
  }'

PHP

<?php
use GuzzleHttp\Client;

$aw = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
$r = $aw->post('interpret/natal', [
    'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
    'json' => [
        'date' => '1990-07-14',
        'time' => '14:30:00',
        'timezoneOffset' => 3,
        'latitude' => 50.4501,
        'longitude' => 30.5234,
    ],
]);

$result = json_decode($r->getBody(), true)['data'];
// $result['interpretation'] - ready AI interpretation
// $result['disclaimer']     - disclaimer to display

Hesaplamalar + Kendi LLM’in için

// 1. Get raw data from /chart (cheaper - 20 credits)
const chart = await fetch('https://api.astroway.info/v1/chart', { ... });
const { data } = await chart.json();

// 2. Pass the data to your own LLM
const prompt = `Interpret this natal chart: ${JSON.stringify(data.planets)}`;
const llmResponse = await myLLM.generate(prompt);

İpucu

Sadece yorumlamaya ihtiyacın varsa - /interpret/* kullan (50 kredi, metin hazır). İstem üzerinde kontrol sahibi olmak istiyorsan - /chart’ı al (20 kredi) ve verileri kendi LLM’ine ilet.

Senaryolar

Kişisel Astroloji Asistanı

MCP sunucusu + Claude/ChatGPT. Kullanıcı sorar - ajan hesaplar ve yorumlar. Bütçe: Kişisel kullanım için Ücretsiz plan.

Sosyal Medya İçerik Botu

/horoscope/daily aracılığıyla 12 burç için günlük burç yorumu oluşturma. Günde 12 istek = 240 kredi. Geniş bir marjla Ücretsiz plan.

Yapay Zeka Koçluk Platformu

Her müşteri için /interpret/natal + /interpret/transits. Günde 100 müşteri = günde 10.000 kredi. Pro plan.

Hızlı Başlangıç → 5 dakikada ilk istek

Horoscope API Yapay zeka yorumları ve burç yorumları

Fiyatlandırma Ücretsizden Kurumsala