Connect Feng Shui API to Your AI Agent

Organize the calculated symbols and directions into a readable reference.

14 tools API key

Try a Feng Shui API Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Feng Shui API

Prepare a zodiac date reference

Look up the date’s zodiac and pillar information under the chosen convention.

/oo Feng Shui API: For Gregorian date [date] and local time [time], retrieve Feng Shui API year, month and day zodiac information using [lunar or solar-term convention], plus the hour animal and branch. Explain the symbols and distinguish the hour lookup from a full hour pillar.

Compare traditional house charts

Calculate chart references from a supplied facing and building year or period.

/oo Feng Shui API: Retrieve Feng Shui API Eight Mansions and natal Flying Star charts for facing [bearing or mountain code] and [construction year or period]. Explain the sectors and chart values as traditional references, preserving the input assumptions.

Start Working with Feng Shui API

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Feng Shui API

    Connect with a Feng Shui API key.

    Connect Feng Shui API →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • Provide Gregorian dates and the intended lunar or solar-term convention. House charts need a facing direction; Flying Star charts also need a construction year or period.
  • Date calculations use China Standard Time. These are traditional systems, not evidence of future outcomes; hour zodiac lookup does not calculate a full hour pillar.

Feng Shui API Tools

Retrieve zodiac, traditional compatibility, Kua, Eight Mansions and Flying Star calculations, or check Lu Ban ruler measurements. AI can explain the supplied chart results as traditional cultural references.

Zodiac and personal chart references

Look up zodiac symbols, traditional relationships and Kua directions.

House charts and ruler measurements

Calculate traditional house sectors and check a Lu Ban ruler length.

14 tools

Get Zodiac Year

Get the Chinese year zodiac animal, element and stem-branch pillar for a date.

fengshui.get_zodiac_year

Get Zodiac Month

Get the lunar month or solar-term month zodiac and pillar for a date.

fengshui.get_zodiac_month

Get Zodiac Day

Get the day zodiac animal and stem-branch pillar for a date.

fengshui.get_zodiac_day

Get Zodiac Hour

Get the zodiac animal and earthly branch for a local two-hour period; this does not calculate a full hour pillar.

fengshui.get_zodiac_hour

Get Zodiac Allies

Get the two zodiac animals forming the traditional three-harmony group with a sign.

fengshui.get_zodiac_allies

Get Zodiac Enemy

Get the opposite, traditionally clashing zodiac animal for a sign.

fengshui.get_zodiac_enemy

Get Zodiac Secret Friend

Get the zodiac animal forming a traditional six-harmony pair with a sign.

fengshui.get_zodiac_secret_friend

Get Zodiac Peach Blossom

Get the traditional Peach Blossom zodiac animal and compass direction for a sign.

fengshui.get_zodiac_peach_blossom

Get Compatibility

Score traditional love or business compatibility from 1 (challenging) to 4 (excellent), using birth dates or zodiac animals.

fengshui.get_compatibility

Get Kua

Calculate the personal Kua number, East or West group, and traditional favorable and unfavorable directions.

fengshui.get_kua

Get Eight Mansions

Calculate the house trigram and traditional Eight Mansions stars for the eight compass sectors.

fengshui.get_eight_mansions

Get Flying Star

Calculate the natal Flying Star chart for the nine palaces using the building facing and construction year or period. Replacement (Ti Gua) charts are not computed.

fengshui.get_flying_star

Check Lucky Dimension

Check a positive length on the Lu Ban ruler and get nearest auspicious ranges when the length is inauspicious.

fengshui.check_lucky_dimension

Get Key Status

Get the current API key status and hourly request quota without accessing personal data.

fengshui.get_key_status

Frequently Asked Questions

Should I enter a lunar date?

Input dates are Gregorian. The calendar choice controls whether the year or month boundaries follow Chinese New Year or the relevant solar terms.

What is needed for a Flying Star chart?

Provide the building facing and exactly one construction year or period. The operation calculates a natal chart and does not compute replacement charts.

How should I provide the facing?

Use a compass bearing or an accepted twenty-four-mountain code or pinyin name. Keep the same facing when comparing chart systems.

Connect Feng Shui API

About Feng Shui API ↗