🌙 Bluesky Daily Moon Cycle Bot

✨ What It Does

The Moon Cycle Bot is an AI-powered astrology companion built for the Bluesky decentralized social network.

It posts daily updates on the Moon’s sign and phase, and optionally replies to users who comment with their rising sign to offer a personalized interpretation of the Moon's transit in their chart.

Key Features:

  • 🌓 Daily Moon Posts: Automatically shares the current Moon phase and Tropical Zodiac Sign each day.

  • 🪐 Transit Interpretation Replies: When users reply to a Moon post with their rising sign (e.g., "Virgo rising"), the bot responds with a short interpretation of which house the Moon is transiting for them and how it may influence their mood or focus.

  • 🌍 Moon Phase: Bot uses a configured latitude/longitude and timezone (-4) to generate accurate Moon phases.

🧠 Architecture Overview

The bot runs as a server that integrates multiple technologies:

🛠 Core Components

Component

Description

🛰️ @atproto/api

Interacts with the Bluesky protocol (posts, reads, replies).

🔁 MCP Server

Monitors user replies via the bsky-mcp-server and triggers response workflows.

🕸️ LangGraph Agent

A custom LangGraph agent parses replies and generates personalized Moon transit responses based on the rising sign.

🌗 Ephemeris Logic

Local utility scripts determine Moon sign and phase using astronomical calculations.

🧠 LLM Integration (OpenAI)

The LangGraph agent is prompted to give short, humanlike interpretations under 300 characters.

⚠️ Important Disclaimer

This bot is a creative educational tool, not a substitute for professional astrology.

While the Moon Cycle Bot can offer quick insights about the Moon’s influence based on rising signs, astrology is a deep, nuanced practice.
Working with a human astrologer brings personalized context, transits, timing techniques, and wisdom that AI cannot replicate.

Use this tool as a spark for curiosity, NOT a replacement for real interpretation.