AI astrology readings with any LLM

// reading.mjs: one helper for every domain
import { GoogleGenAI } from '@google/genai';

const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });

export async function roxy(path, body, lang = 'en') {
  const res = await fetch(`https://roxyapi.com/api/v2${path}?lang=${lang}`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json', 'X-API-Key': process.env.ROXY_API_KEY },
    body: JSON.stringify(body),
  });
  const data = await res.json();
  if (!res.ok) throw new Error(`${data.code}: ${data.error}`);
  return data;
}

export async function interpret(data, brief, lang = 'en') {
  const { text } = await ai.models.generateContent({
    model: 'gemini-flash-latest',
    contents: JSON.stringify(data),
    config: {
      systemInstruction: [
        'You write readings for a professional astrology product.',
        'Every claim must trace to a value in the JSON. Build on its interpretation text, never invent placements, cards or dates.',
        `Write in language "${lang}". ${brief}`,
      ].join(' '),
    },
  });
  return text;
}

import { roxy, interpret } from './reading.mjs';

const me = { date: '1990-07-15', time: '14:30:00', latitude: 40.7128, longitude: -74.006, timezone: 'America/New_York' };

const chart = await roxy('/astrology/natal-chart', me);
console.log(await interpret(chart, 'Open with the Sun, Moon and Ascendant together, then the strongest aspects. 600 words of prose.'));

import { GoogleGenAI } from '@google/genai';

const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });

const getNatalChart = {
  name: 'get_natal_chart',
  description: 'Western natal chart with planets, houses, aspects, patterns and interpretation text for each.',
  parametersJsonSchema: {
    type: 'object',
    properties: {
      date: { type: 'string', description: 'Birth date, YYYY-MM-DD' },
      time: { type: 'string', description: 'Birth time, HH:MM:SS, 24 hour' },
      latitude: { type: 'number' },
      longitude: { type: 'number' },
      timezone: { type: 'string', description: 'IANA zone, for example Europe/Istanbul' },
    },
    required: ['date', 'time', 'latitude', 'longitude', 'timezone'],
  },
};

async function callRoxy(args) {
  const res = await fetch('https://roxyapi.com/api/v2/astrology/natal-chart', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json', 'X-API-Key': process.env.ROXY_API_KEY },
    body: JSON.stringify(args),
  });
  return res.json();
}

const chat = ai.chats.create({
  model: 'gemini-flash-latest',
  config: {
    tools: [{ functionDeclarations: [getNatalChart] }],
    systemInstruction: 'You are a professional astrologer. For any chart question, call get_natal_chart and read from its result. Never invent placements.',
  },
});

let response = await chat.sendMessage({
  message: 'I was born on 15 July 1990 at 14:30 in Istanbul. What does my Moon say about me?',
});
while (response.functionCalls?.length) {
  const parts = [];
  for (const call of response.functionCalls) {
    parts.push({ functionResponse: { id: call.id, name: call.name, response: await callRoxy(call.args) } });
  }
  response = await chat.sendMessage({ message: parts });
}
console.log(response.text);

// npm install @google/genai @modelcontextprotocol/sdk
import { GoogleGenAI, mcpToTool } from '@google/genai';
import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const mcp = new Client({ name: 'my-reading-app', version: '1.0.0' });
await mcp.connect(
  new StreamableHTTPClientTransport(new URL('https://roxyapi.com/mcp/astrology'), {
    requestInit: { headers: { 'X-API-Key': process.env.ROXY_API_KEY } },
  })
);

const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });
const response = await ai.models.generateContent({
  model: 'gemini-flash-latest',
  contents: 'I was born on 15 July 1990 at 14:30 in Istanbul (41.0082, 28.9784, Europe/Istanbul). Which transits are strongest for me today, and what should I do with them?',
  config: {
    tools: [mcpToTool(mcp)],
    systemInstruction: `You are a professional astrologer. Today is ${new Date().toISOString().slice(0, 10)}. Always read placements and transits from the tools, never from memory.`,
  },
});
console.log(response.text);
await mcp.close();

const partner = { date: '1992-03-02', time: '08:00:00', latitude: 51.5074, longitude: -0.1278, timezone: 'Europe/London' };

const synastry = await roxy('/astrology/synastry', { person1: me, person2: partner });
console.log(await interpret(synastry, 'A relationship reading for both people: what flows, where they will clash, one way to meet in the middle. 200 words.'));

const spread = await roxy('/tarot/spreads/three-card', { question: 'Should I change jobs this year?' });
console.log(await interpret(spread, 'Read the past, present and future cards as one story that answers the question. 150 words.'));

const digest = await roxy('/forecast/digest', { birthData: me });
console.log(await interpret(digest, 'A weekly forecast email: the three dates that matter most in the next seven days, each with one practical suggestion. 150 words.'));

const chart = await roxy('/astrology/natal-chart', me, 'tr');
console.log(await interpret(chart, 'A 300 word birth chart reading that opens with the Sun, Moon and Ascendant.', 'tr'));