观星 GuanXing — Chinese Metaphysics AI#

A comprehensive Chinese metaphysics toolkit. Call the GuanXing API to provide BaZi birth chart analysis, daily fortune, crypto token fortune (五行), Feng Shui, Tarot, I-Ching divination, dream interpretation, name scoring, compatibility matching, and zodiac readings.

Setup#

Get a free API key at https://heartai.zeabur.app (register → Developer Center → Create App → copy your gx_sk_ key).

Set the environment variable:

text

GUANXING_API_KEY=gx_sk_your_key_here

Base URL: https://heartai.zeabur.app

Authentication#

All requests require a Bearer token in the Authorization header:

text

Authorization: Bearer $GUANXING_API_KEY
Content-Type: application/json

External Endpoints#

EndpointMethodPurposeData Senthttps://heartai.zeabur.app/api/v1/baziPOSTBaZi birth chart analysisBirth date, birth hour, namehttps://heartai.zeabur.app/api/v1/fortunePOSTDaily fortune readingZodiac sign, birth datehttps://heartai.zeabur.app/api/v1/crypto-fortunePOSTCrypto token fortuneToken symbolhttps://heartai.zeabur.app/api/v1/qiuqianPOSTI-Ching divination (求签)Category, questionhttps://heartai.zeabur.app/api/v1/tarotPOSTTarot card readingQuestion, spread typehttps://heartai.zeabur.app/api/v1/dreamPOSTDream interpretationDream descriptionhttps://heartai.zeabur.app/api/v1/almanacPOSTChinese almanacDatehttps://heartai.zeabur.app/api/v1/fengshuiPOSTFeng Shui analysisDirection, element, space typehttps://heartai.zeabur.app/api/v1/name-scorePOSTChinese name scoringFull namehttps://heartai.zeabur.app/api/v1/compatibilityPOSTCompatibility matchingTwo birth dateshttps://heartai.zeabur.app/api/v1/zodiacPOSTChinese zodiac fortuneBirth year or zodiac sign

Security & Privacy#

• All data is sent to the GuanXing API at heartai.zeabur.app over HTTPS.
• No data is stored locally. No files are read or written.
• The API processes birth dates and names to generate fortune readings. No data is shared with third parties.
• By using this skill, your data is sent to the GuanXing (观星) service. Only install if you trust this service.

Model Invocation Note#

This skill may be invoked autonomously by the agent when the user asks about fortune, 命理, 八字, zodiac, crypto luck, Feng Shui, or related topics. This is standard behavior. You can opt out by removing the skill.

Actions#

1. BaZi Birth Chart (八字命理)#

When the user asks about their birth chart, 八字, destiny, life path, or 命格:

bash

curl -s -X POST https://heartai.zeabur.app/api/v1/bazi \
  -H "Authorization: Bearer $GUANXING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"birthDate": "YYYY-MM-DD", "birthHour": HOUR_0_TO_23, "name": "NAME"}'

• birthDate (required): Birth date in YYYY-MM-DD format
• birthHour (optional): Birth hour 0-23 (maps to 十二时辰)
• name (optional): User's name for personalized reading

Ask the user for their birth date if not provided. Birth hour improves accuracy but is optional.

2. Daily Fortune (每日运势)#

When the user asks about today's fortune, luck, or 运势:

bash

curl -s -X POST https://heartai.zeabur.app/api/v1/fortune \
  -H "Authorization: Bearer $GUANXING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"zodiac": "ZODIAC_SIGN", "birthDate": "YYYY-MM-DD"}'

• zodiac (required): Chinese zodiac sign name like 白羊座, 金牛座, etc.
• birthDate (optional): For personalized 八字-based fortune

3. Crypto Fortune (加密运势)#

When the user asks about crypto luck, token fortune, or 币圈运势:

bash

curl -s -X POST https://heartai.zeabur.app/api/v1/crypto-fortune \
  -H "Authorization: Bearer $GUANXING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"token": "BTC"}'

• token (required): Token symbol — BTC, ETH, SOL, BNB, TON, DOGE, AVAX
• Token-to-五行 mapping: BTC→金(Metal), ETH→水(Water), SOL→火(Fire), BNB→土(Earth), TON→木(Wood)

For a portfolio overview, call the endpoint for each token the user holds.

4. I-Ching Divination (求签)#

When the user wants to divine, draw a fortune stick, or 求签:

bash

curl -s -X POST https://heartai.zeabur.app/api/v1/qiuqian \
  -H "Authorization: Bearer $GUANXING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category": "CATEGORY", "question": "USER_QUESTION"}'

• category (optional): 事业 (career), 感情 (love), 财运 (wealth), 学业 (study), 健康 (health)
• question (optional): Specific question the user wants answered

5. Tarot Reading (塔罗牌)#

When the user asks for a tarot reading:

bash

curl -s -X POST https://heartai.zeabur.app/api/v1/tarot \
  -H "Authorization: Bearer $GUANXING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"question": "USER_QUESTION", "spread": "SPREAD_TYPE"}'

• question (optional): The question to explore
• spread (optional): "single" (one card), "three" (past-present-future), "celtic" (full spread)

6. Dream Interpretation (解梦)#

When the user describes a dream and wants it interpreted:

bash

curl -s -X POST https://heartai.zeabur.app/api/v1/dream \
  -H "Authorization: Bearer $GUANXING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"dream": "DREAM_DESCRIPTION"}'

• dream (required): The user's dream description

7. Chinese Almanac (老黄历)#

When the user asks what's auspicious today, 宜忌, or 老黄历:

bash

curl -s -X POST https://heartai.zeabur.app/api/v1/almanac \
  -H "Authorization: Bearer $GUANXING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date": "YYYY-MM-DD"}'

• date (optional): Defaults to today if not specified

8. Feng Shui Analysis (风水)#

When the user asks about Feng Shui, home layout, or 方位:

bash

curl -s -X POST https://heartai.zeabur.app/api/v1/fengshui \
  -H "Authorization: Bearer $GUANXING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"direction": "DIRECTION", "element": "ELEMENT", "spaceType": "SPACE_TYPE"}'

• direction (optional): 东/南/西/北/东南/西南/东北/西北
• element (optional): 金/木/水/火/土
• spaceType (optional): 办公室 (office), 卧室 (bedroom), 客厅 (living room)

9. Name Scoring (姓名打分)#

When the user wants to score a name or analyze name meaning:

bash

curl -s -X POST https://heartai.zeabur.app/api/v1/name-score \
  -H "Authorization: Bearer $GUANXING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "FULL_NAME"}'

• name (required): Chinese or English full name

10. Compatibility (缘分合盘)#

When the user asks about compatibility with someone:

bash

curl -s -X POST https://heartai.zeabur.app/api/v1/compatibility \
  -H "Authorization: Bearer $GUANXING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"person1": {"birthDate": "YYYY-MM-DD", "name": "NAME1"}, "person2": {"birthDate": "YYYY-MM-DD", "name": "NAME2"}}'

• Both person1 and person2 require birthDate. name is optional.

11. Zodiac Fortune (生肖运势)#

When the user asks about their Chinese zodiac:

bash

curl -s -X POST https://heartai.zeabur.app/api/v1/zodiac \
  -H "Authorization: Bearer $GUANXING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"zodiac": "ZODIAC_ANIMAL", "birthYear": YEAR}'

• zodiac (optional): 鼠/牛/虎/兔/龙/蛇/马/羊/猴/鸡/狗/猪
• birthYear (optional): Birth year to auto-determine zodiac

Response Handling#

All endpoints return JSON with this structure:

json

{
  "success": true,
  "data": { ... },
  "meta": { "skill": "...", "tokensUsed": 245, "latencyMs": 1200 }
}

If success is false, the response includes an error field. Report the error message to the user in a friendly way.

Response Formatting#

When presenting results to the user:

• Use the Chinese terms naturally (八字, 五行, 天干地支, etc.)
• Format fortune scores as X/100 or X/5 stars
• Highlight lucky colors, numbers, and directions
• For crypto fortune, mention the 五行 element relationship
• Keep the tone warm and insightful, not clinical
• If the user speaks English, translate key Chinese metaphysics terms with brief explanations

Trust Statement#

By using this skill, data you provide (birth dates, names, questions) is sent to the GuanXing (观星) API at heartai.zeabur.app for processing. The API uses AI to generate metaphysics readings. Only install if you trust this service. API documentation: https://heartai.zeabur.app