观星 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:

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:

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

External Endpoints

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 命格:

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 运势:

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 币圈运势:

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 求签:

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:

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:

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 老黄历:

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 方位:

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:

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:

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:

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:

{
  "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