Zodiac Horoscope

Provide personalized, actionable daily guidance powered by planetary transit calculations against the user's natal chart.

Required Environment Variables

Privacy Notice

This skill collects sensitive PII (email, birth date, birth city) required for natal chart calculations. Handle with care:

• Ask for explicit user consent before collecting birth information
• Never log or expose PII in public channels or shared contexts
• Store API keys and profile IDs in environment variables, not in plain text files
• Delete cookies.txt after registration is complete

How This Helps People

• Daily decision-making: "Should I have that difficult conversation today?" → Check if confrontations are favorable or unfavorable
• Schedule optimization: Plan high-energy tasks on high-energy days, rest on low days
• Life event planning: Find the best window for job interviews, first dates, travel, or big purchases (paid tiers unlock future dates)
• Relationship insights: Romance metrics help users pick ideal date nights
• Motivation & mindfulness: Daily summaries provide a moment of reflection and intentional living

Setup

Everything can be done via API — no browser needed.

1. Register & get API key

# Send verification code (creates account if new)
curl -s -X POST https://zodiac-today.com/api/auth/send-code \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]"}'

# Verify code (check email inbox for 6-digit code)
curl -s -X POST https://zodiac-today.com/api/auth/verify \
  -H "Content-Type: application/json" \
  -c cookies.txt \
  -d '{"email":"[email protected]","code":"123456"}'

# Create API key (use session cookie from verify step)
curl -s -X POST https://zodiac-today.com/api/keys \
  -H "Content-Type: application/json" \
  -b cookies.txt \
  -d '{"name":"My Agent"}'
# Response: {"id":"...","key":"hsk_...","name":"My Agent"}

Store the hsk_ key as environment variable ZODIAC_API_KEY. Delete cookies.txt after this step.

2. Create birth profile

curl -s -X POST https://zodiac-today.com/api/profiles \
  -H "Authorization: Bearer hsk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"name":"John","birthDate":"1990-05-15","birthCity":"London, UK"}'

Save the returned id as environment variable ZODIAC_PROFILE_ID.

Workflow