Connect Yuanfenju to Your AI Agent

Provide the date you want to explore and ask AI to explain the calendar fields returned.

12 tools API key

Try a Yuanfenju Task

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

oo Skill Yuanfenju

Read a Day’s Almanac

Retrieve an almanac for an eligible Gregorian date and explain its traditional-calendar fields.

/oo Yuanfenju: Get the almanac for [date: Gregorian YYYY-MM-DD within the rolling 90-day window] and explain the returned traditional-calendar fields.

Find Solar Term Information

Provide a calendar date to retrieve solar-term information and explain the returned dates.

/oo Yuanfenju: Get solar-term information for year [year], month [month], day [day] and explain the returned dates.

Start Working with Yuanfenju

  1. Install OOMOL

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

    Install OOMOL →
  2. Connect Yuanfenju

    Connect with your Yuanfenju Development API Key.

    Connect Yuanfenju →
  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

  • A Yuanfenju development key and a plan covering your selected cultural or calendar endpoint.
  • Almanac queries require a Gregorian YYYY-MM-DD date within the rolling 90-day window; solar terms require year, month, and day.
  • Chart interpretations are for cultural research and entertainment. Calendar conversions and lunar-date chart preparation can consume additional calls.

Yuanfenju Tools

Retrieve an almanac for an eligible Gregorian date and explain its traditional-calendar fields. Provide a calendar date to retrieve solar-term information and explain the returned dates.

Read a Day’s Almanac

Get the Chinese almanac for a Gregorian date within 90 days before or after today, for cultural research and entertainment.

Find Solar Term Information

Get the year's 12 seasonal nodes or all 24 solar terms with Gregorian and lunar timestamps for the supplied date.

12 tools

Get Annual Usage

Get the current 24-hour cycle's used call count and reset timing for a Yuanfenju annual-plan account. This free query is only available to annual members.

yuanfenju.get_annual_usage

Interpret Bazi

Get Yuanfenju's official Bazi interpretation for cultural research and entertainment, including five-element, relationship, wealth and life interpretation text. Lunar dates in 1900-2100 are converted first using an additional call; other non-leap lunar dates use native input.

yuanfenju.interpret_bazi

Analyze Bazi Compatibility

Analyze two people's Bazi charts for relationship or marriage entertainment using the official matching interface selected by the caller. Marriage uses firstPerson as the male partner and secondPerson as the female partner. Each lunar date in 1900-2100 adds a conversion call; other non-leap lunar dates use native input.

yuanfenju.analyze_bazi_compatibility

Get Ziwei Chart

Calculate a Ziwei Doushu chart with twelve palaces and star placements for cultural research and entertainment. Lunar dates in 1900-2100 are converted first using an additional call; other non-leap lunar dates use native input.

yuanfenju.get_ziwei_chart

Get Natal Chart

Calculate a Western astrology natal chart from the original Gregorian local birth time for cultural research and entertainment. Returns celestial data, official interpretations and the SVG chart when provided. The provider handles timezone/DST and transport compression; no true solar time correction is applied.

yuanfenju.get_natal_chart

Find Auspicious Dates

Find dates marked suitable for a selected traditional activity within the next 7 days, half month, month or three months, for cultural research and entertainment. Use get_almanac for a selected date's hourly details.

yuanfenju.find_auspicious_dates

Get Account

Get the connected Yuanfenju account's membership, expiry and applicable remaining quota. This query does not consume call credits.

yuanfenju.get_account

Get Bazi Chart

Calculate a standard Bazi chart with four pillars, five elements and luck cycles for cultural research and entertainment. Lunar dates in 1900-2100 are converted first, including leap months, using an additional API call. Other non-leap lunar dates use native lunar input.

yuanfenju.get_bazi_chart

Interpret Tarot

Draw and interpret a full-deck tarot spread for entertainment using the current Yuanfenju interface. Drawing is automatic; paid membership is required.

yuanfenju.interpret_tarot

Convert Calendar

Convert Gregorian and Chinese lunar dates in either direction, including negative lunar month numbers for leap months.

yuanfenju.convert_calendar

Get Almanac

Get the Chinese almanac for a Gregorian date within 90 days before or after today, for cultural research and entertainment.

yuanfenju.get_almanac

Get Solar Terms

Get the year's 12 seasonal nodes or all 24 solar terms with Gregorian and lunar timestamps for the supplied date.

yuanfenju.get_solar_terms

Frequently Asked Questions

What can AI help me do with Yuanfenju?

Look up a day’s traditional almanac and explore solar-term dates with Yuanfenju.

What should I know before using Yuanfenju results?

Chart interpretations are for cultural research and entertainment. Calendar conversions and lunar-date chart preparation can consume additional calls.

What do I need to connect Yuanfenju?

Connect your Yuanfenju development API key with a plan covering the selected endpoint. Almanac dates must fall within the rolling 90-day window.

Connect Yuanfenju

About Yuanfenju ↗