AI-ügynökök és MCP

Építesz egy AI-ágenszt, amely valódi asztrológiai számításokat végez ahelyett, hogy hallucinálna? Az AstroWay csatlakozik a Claude (Anthropic), ChatGPT-4 (OpenAI), Llama 3.3 (Groq), DeepSeek, Google Gemini, Mistral modellekhez - MCP-n, llms.txt-en vagy közvetlen HTTP-hívásokon keresztül. Három integrációs módszer közül választhatsz az ágens típusától függően:

• llms.txt - discovery-fájlok olyan ágensek számára, amelyek olvasni tudják a dokumentációt (Cursor IDE, Windsurf, a böngészőben futó Claude, egyéni RAG-csövek LangChain/LlamaIndex használatával).
• MCP-szerver - zero-code megoldás a Claude Desktop, Cursor IDE, Windsurf, VS Code (llm CLI) és bármely MCP-kompatibilis kliens (beleértve a GPT-t is az OpenAI Realtime API-n keresztül).
• HTTP API - közvetlen hívás saját ágensből vagy keretrendszerből (LangChain, LlamaIndex, AutoGen, CrewAI).

llms.txt - discovery AI-ágensek számára

Az oldal két gépi olvasható fájlt szolgáltat llms.txt formátumban:

• /llms.txt - a dokumentáció összes oldalának indexe, csoportosítva szekciók szerint (API Reference, Use Cases, Examples, Products). Kicsi, belefér bármelyik context window-ba.
• /llms-full.txt - az összes dokumentáció egyetlen plain-text fájlban. Offline vektoradatbázis indexeléséhez vagy egyszeri context-be töltéshez alkalmas.

Mikor használd

Forgatókönyv	Fájl
Cursor/Windsurf „olvasd el az AstroWay docs-ot és segíts az integrációban”	/llms.txt (az ágens magától behozza a szükséges részeket)
Saját RAG-cső / vektoradatbázis FAQ-bot számára	/llms-full.txt (egy fetch - az egész corpus)
Böngészőben futó Claude/ChatGPT: „itt van az API-nk, építs egy klienst”	/llms-full.txt beillesztése a promptba
Termelési ágens, amely tényleges hívásokat hajt végre	MCP-szerver vagy HTTP API (lásd lent)

Példa: pull a saját ágensedbe

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.`;

Megjegyzés

A fájlok automatikusan regenerálódnak minden site-release alkalmával. A frissesség garantált: az API verziója a /llms.txt végén megegyezik a jelenlegi production deploy verziójával.

MCP-szerver (ajánlott a Claude Desktop számára)

A Model Context Protocol (MCP) nyílt szabvány eszközök csatlakoztatására AI-modellekhez. Az AstroWay MCP-szerver 25 eszközt biztosít számításokhoz és interpretációkhoz.

Beállítás a Claude Desktop számára

Add hozzá a claude_desktop_config.json fájlhoz:

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

A Claude Desktop újraindítása után 25 asztrológiai eszközt fog látni.

Mit tud az MCP-szerver

Eszköz	Mit csinál
natal_chart	Natális térkép számítása
synastry	Szinasztría két ember között
daily_horoscope	Napi horoszkóp
interpret_natal	Natális térkép AI-értelmezése
human_design	Teljes HD-térkép
transits	Aktuális tranzitok

A teljes lista 25 eszközt tartalmaz, amelyek lefedik a főbb számításokat és AI-értelmezéseket.

Példa párbeszéd a Claude-dal

Felhasználó: Készíts egy natális térképet annak a személynek, aki 1990. július 14-én született 14:30-kor Kijevben. Mit jelent a Nap Rákban a 10. házban?

Claude: Használja a natal_chart eszközt a számításhoz, majd az interpret_placement-et az értelmezéshez. Visszaadja a bolygók valós adatait és egy értelmes interpretációt.

HTTP API

AI-ágensek számára, amelyek nem támogatják az MCP-t - használd közvetlenül az HTTP API-t.

Tartalomgeneráláshoz

TypeScript

// AI-агент викликає /interpret/natal для інтерпретації
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 - готова AI-інтерпретація
// result.disclaimer - disclaimer для відображення

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'] - готова AI-інтерпретація
# result['disclaimer']     - disclaimer для відображення

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'] - готова AI-інтерпретація
// $result['disclaimer']     - disclaimer для відображення

Számításokhoz + saját LLM

// 1. Отримай сирі дані через /chart (дешевше - 20 кредитів)
const chart = await fetch('https://api.astroway.info/v1/chart', { ... });
const { data } = await chart.json();

// 2. Передай дані у свій LLM
const prompt = `Interpret this natal chart: ${JSON.stringify(data.planets)}`;
const llmResponse = await myLLM.generate(prompt);

Tipp

Ha csak az interpretációra van szükséged - használd az /interpret/* endpointokat (50 credit, kész szöveg). Ha szeretnéd kontrollálni a promptot - vedd a /chart endpointot (20 credit) és add át az adatokat a saját LLM-ednek.

Forgatókönyvek

Személyes asztrológiai asszisztens

MCP-szerver + Claude/ChatGPT. A felhasználó kérdez - az ágens számol és értelmez. Költség: Free tarif személyes használatra.

Tartalomalkotó bot közösségi média számára

Napi horoszkópok generálása 12 csillagjegy számára a /horoscope/daily endpointon keresztül. 12 kérés naponta = 240 credit. A Free tarif nagy tartalékkal rendelkezik.

AI-coaching platform

/interpret/natal + /interpret/transits minden ügyfél számára. 100 ügyfél/nap = 10 000 credit/nap. Pro tarif.

Gyors kezdés → Első kérés 5 perc alatt

Horoscope API AI-értelmezések és horoszkópok

Tarik Ingyenestől az Enterprise-ig