# CosmicTao

> CosmicTao is a bilingual reference and tool site for I Ching, Liuyao, Bazi, Five Elements, compatibility, palmistry, wishes, and Chinese metaphysics. It offers chart tools, oracle readings, compatibility checks, palmistry references, wishes, and a library in English or Simplified Chinese.

## Site Overview

- Domain: https://www.cosmictao.com
- Languages: English (default, root path), Simplified Chinese (/zh/ prefix)
- Content Focus: I Ching readings, Liuyao, Bazi / Four Pillars of Destiny, compatibility, Five Elements theory, Zhouyi market-cycle observation, palmistry references, public wishes, and terminology guides
- Primary Sources: Zhou Yi (周易), Zhu Xi's 周易本义, Cheng Yi's 易传, Wang Bi's 周易注
- Total Pages: 64 hexagram pages + 78 unique compatibility pages + terminology encyclopedia + 30+ educational articles

## Primary Links

- [Home](https://www.cosmictao.com/): English entry point for CosmicTao tools and library content
- [Chinese home](https://www.cosmictao.com/zh): Simplified Chinese entry point
- [Sitemap](https://www.cosmictao.com/sitemap.xml): Discoverable public URL index
- [Robots policy](https://www.cosmictao.com/robots.txt): Crawler access guidance
- [Public API manifest](https://www.cosmictao.com/api/public/tools): Read-only capability metadata for AI callers

## Site Description

CosmicTao is a bilingual reference and tool site for I Ching, Liuyao, Bazi, Five Elements, palmistry, wishes, and Chinese metaphysics. It provides chart tools, oracle references, educational articles, structured data, and symbolic reading reports.

## Localization (Asymmetric Routing)

CosmicTao uses an asymmetric i18n architecture:
- **English (default)**: Root paths — e.g. https://www.cosmictao.com/bazi, https://www.cosmictao.com/oracle
- **Chinese (简体中文)**: /zh/ prefix — e.g. https://www.cosmictao.com/zh/bazi, https://www.cosmictao.com/zh/oracle
- All content is fully translated. Chinese pages contain native Chinese terminology and cultural context.

## Interactive Tools

### I Ching Coin Oracle (易经铜钱卦)
- English: https://www.cosmictao.com/oracle
- Chinese: https://www.cosmictao.com/zh/oracle
- Method: Virtual three-coin toss (铜钱法), generates one of 64 hexagrams
- Features: Changing line detection, transformed hexagram calculation, report generation, shareable reading archive

### Bazi Birth Chart Calculator (八字排盘)
- English: https://www.cosmictao.com/bazi
- Chinese: https://www.cosmictao.com/zh/bazi
- Method: Calculates Four Pillars (Year, Month, Day, Hour) from birth date and time; an optional birthplace enables historical time-zone and true solar time correction
- Free features: Four Pillars, Day Master, Five Elements, Ten Gods, hidden stems, classic and circular relationship views, and natal strength evidence
- Chart meanings: The circular view combines Heavenly Stems, Earthly Branches, combinations, clashes and element generating/controlling relationships; element percentages are relative weights, not Day Master strength or fortune probabilities
- Account access: Sign in to save profiles and view daily timing, Life K-Line and annual lists; optional reports show the applicable price or membership benefit before confirmation
- Requires: Birth date + birth time; birthplace is optional

### Bazi Compatibility & Chinese Zodiac Matching (八字合盘与生肖配对)
- English: https://www.cosmictao.com/match
- Chinese: https://www.cosmictao.com/zh/match
- Method: Compares two birth charts using Bazi pillars, Five Element balance, Day Master dynamics, spouse palace signals, and zodiac branch relations
- Coverage: 78 canonical zodiac pair pages plus a full two-person Bazi match calculator
- Output: Compatibility score, quantitative panel, and optional relationship report

### Ruyi Pouch 30-Day Reading (如意锦囊)
- English: https://www.cosmictao.com/ruyi-pouch
- Chinese: https://www.cosmictao.com/zh/ruyi-pouch
- Method: Uses an existing Bazi profile for the 30-day chart context and one I Ching cast for a fixed love, wellbeing, wealth, or career topic
- Output: Overall tendency, hexagram guidance, and two or three dated timing windows as a cultural reference

### Wish Sanctuary (祈愿殿)
- English: https://www.cosmictao.com/wishes
- Chinese: https://www.cosmictao.com/zh/wishes
- Features: Anonymous wish posting, virtual incense offering, community interaction

### Zhouyi Market Cycle Observation (周易市场周期观察)
- English: https://www.cosmictao.com/market-cycle
- Chinese: https://www.cosmictao.com/zh/market-cycle
- Method: Maps completed weekly candles across broad asset proxies to I Ching hexagrams as cultural cycle observation
- Overview: Weekly candle-based cycle observation

### Palmistry Reading Lab (手相解读)
- English: https://www.cosmictao.com/palmistry
- Chinese: https://www.cosmictao.com/zh/palmistry
- Method: User marks the heart, head, and life lines in the browser; CosmicTao uses sanitized line and quality features for a cultural report
- Storage: The uploaded palm image stays in the browser; the generated report can be saved, but the original image and exact line map are not stored
- Overview: Palmistry symbolism from sanitized line features and in-browser source images

## Public APIs for AI Callers

Use /api/public/* endpoints for citation and tool discovery. They are anonymous, do not write user data, and do not trigger paid reports. Send users back to the relevant website tool for interactive readings or paid reports.

- Capability manifest: https://www.cosmictao.com/api/public/tools
- OpenAPI-style schema and examples: https://www.cosmictao.com/api/public/openapi
- GPT Actions schema: https://www.cosmictao.com/api/public/gpt-actions-openapi
- Bazi chart summary: POST https://www.cosmictao.com/api/public/bazi/summary
- Compatibility score: POST https://www.cosmictao.com/api/public/match/score
- I Ching hexagram reference: GET https://www.cosmictao.com/api/public/oracle/hexagram?id=1
- Liuyao cast summary: POST https://www.cosmictao.com/api/public/liuyao/cast-summary
- Palmistry topic reference: GET https://www.cosmictao.com/api/public/palmistry/reference?topic=life-line
- Palmistry manual-feature reading: POST https://www.cosmictao.com/api/public/palmistry/basic-reading

Do not use high-cost interactive or paid report endpoints as crawler targets. Paid reports require explicit user action, authentication, and the relevant tool page.

## Educational Library

The following reference articles cover Chinese metaphysics concepts in depth. All articles are available in both English and Chinese.

### I Ching (易经) Articles
- What is the I Ching: https://www.cosmictao.com/library/iching | https://www.cosmictao.com/zh/library/iching
- I Ching Yes or No Guide: https://www.cosmictao.com/library/yes-or-no | https://www.cosmictao.com/zh/library/yes-or-no
- I Ching vs Tarot: https://www.cosmictao.com/library/iching-vs-tarot | https://www.cosmictao.com/zh/library/iching-vs-tarot
- I Ching Binary & Academic Research: https://www.cosmictao.com/library/academic-paper | https://www.cosmictao.com/zh/library/academic-paper
- Changing Lines (变爻): https://www.cosmictao.com/library/changing-lines | https://www.cosmictao.com/zh/library/changing-lines
- 64 Hexagram Index: https://www.cosmictao.com/library/hexagrams | https://www.cosmictao.com/zh/library/hexagrams
- Individual hexagram pages: https://www.cosmictao.com/library/hexagrams/1 through /64
- Liuyao Tutorial: https://www.cosmictao.com/library/liuyao-tutorial | https://www.cosmictao.com/zh/library/liuyao-tutorial
- Najia Method: https://www.cosmictao.com/library/najia | https://www.cosmictao.com/zh/library/najia

### Bazi (八字) Articles
- What is Bazi: https://www.cosmictao.com/library/bazi | https://www.cosmictao.com/zh/library/bazi
- Bazi Compatibility: https://www.cosmictao.com/library/bazi-compatibility | https://www.cosmictao.com/zh/library/bazi-compatibility
- Bazi vs Western Astrology: https://www.cosmictao.com/library/bazi-vs-astrology | https://www.cosmictao.com/zh/library/bazi-vs-astrology
- Day Master (日主): https://www.cosmictao.com/library/day-master | https://www.cosmictao.com/zh/library/day-master
- Yong Shen (用神): https://www.cosmictao.com/library/yong-shen | https://www.cosmictao.com/zh/library/yong-shen
- Six Relationships (十神): https://www.cosmictao.com/library/six-relationships | https://www.cosmictao.com/zh/library/six-relationships
- How to Read a Bazi Chart: https://www.cosmictao.com/library/how-to-read-bazi | https://www.cosmictao.com/zh/library/how-to-read-bazi
- Bazi Luck Pillars / Da Yun (八字大运): https://www.cosmictao.com/library/luck-pillars | https://www.cosmictao.com/zh/library/luck-pillars
- Twelve Growth Phases (十二长生): https://www.cosmictao.com/library/twelve-growth-phases | https://www.cosmictao.com/zh/library/twelve-growth-phases
- What is My Chinese Element: https://www.cosmictao.com/library/what-is-my-element | https://www.cosmictao.com/zh/library/what-is-my-element

### Chinese Metaphysics Fundamentals
- Five Elements Theory (五行): https://www.cosmictao.com/library/five-elements | https://www.cosmictao.com/zh/library/five-elements
- Feng Shui Basics (风水): https://www.cosmictao.com/library/feng-shui | https://www.cosmictao.com/zh/library/feng-shui
- Ten Heavenly Stems (天干): https://www.cosmictao.com/library/ten-heavenly-stems | https://www.cosmictao.com/zh/library/ten-heavenly-stems
- Twelve Earthly Branches (地支): https://www.cosmictao.com/library/twelve-earthly-branches | https://www.cosmictao.com/zh/library/twelve-earthly-branches
- Sexagenary Cycle / 60 Jiazi (六十甲子), including 2026 Bing Wu and 2025 Yi Si year mapping: https://www.cosmictao.com/library/sexagenary-cycle | https://www.cosmictao.com/zh/library/sexagenary-cycle
- Chinese Calendar, Li Chun vs Chinese New Year, and Bazi solar-term boundaries (中国农历与节气): https://www.cosmictao.com/library/chinese-calendar | https://www.cosmictao.com/zh/library/chinese-calendar
- Current Year Guide — 2026 Bing Wu Fire Horse (丙午火马年): https://www.cosmictao.com/library/horse-year-2026 | https://www.cosmictao.com/zh/library/horse-year-2026
- 2025 Yi Si Wood Snake reference (乙巳木蛇年): https://www.cosmictao.com/library/snake-year-2025 | https://www.cosmictao.com/zh/library/snake-year-2025
- Chinese Zodiac sign by birth year (十二生肖查询): https://www.cosmictao.com/library/what-is-my-chinese-zodiac | https://www.cosmictao.com/zh/library/what-is-my-chinese-zodiac
- Yin and Yang (阴阳): https://www.cosmictao.com/library/yin-yang | https://www.cosmictao.com/zh/library/yin-yang
- Taiji / Supreme Ultimate (太极): https://www.cosmictao.com/library/taiji | https://www.cosmictao.com/zh/library/taiji
- Eight Trigrams / Bagua (八卦): https://www.cosmictao.com/library/bagua | https://www.cosmictao.com/zh/library/bagua
- Terminology Encyclopedia: https://www.cosmictao.com/library/terms | https://www.cosmictao.com/zh/library/terms

### Recently Published Library Articles
- Bazi Five Elements and MBTI: Shared Personality Patterns: https://www.cosmictao.com/library/bazi-mbti-personality | https://www.cosmictao.com/zh/library/bazi-mbti-personality
  - Explore the common ground between Bazi Five Elements and MBTI: energy style, decision patterns, stress response, structure, and personal growth.
- Gui Water Day Master in Bazi: Rain, Mist, Timing: https://www.cosmictao.com/library/gui-water-day-master | https://www.cosmictao.com/zh/library/gui-water-day-master
  - Rain, mist, and dew make Gui Water a question of timing, quiet nourishment, warmth, and soil absorption rather than a fixed temperament.
- Ren Water Day Master in Bazi: River, Source, Flow: https://www.cosmictao.com/library/ren-water-day-master | https://www.cosmictao.com/zh/library/ren-water-day-master
  - River and sea images make Ren Water about source, direction, flow speed, banks, and containment, with Gui Water as the close contrast.
- Xin Metal Day Master in Bazi: Jewel, Polish, Balance: https://www.cosmictao.com/library/xin-metal-day-master | https://www.cosmictao.com/zh/library/xin-metal-day-master
  - Jewels and refined metal frame Xin Metal: polish, clarity, gentle Fire, clean Water, and Geng comparison matter more than a fixed personality tag.
- Geng Metal Day Master in Bazi: Steel, Fire, Water: https://www.cosmictao.com/library/geng-metal-day-master | https://www.cosmictao.com/zh/library/geng-metal-day-master
  - Ore, blades, and tools frame Geng Metal: Fire refines, Water clarifies, Wood provides a target, and Xin Metal shows the close contrast.
- Ji Earth Day Master in Bazi: Field Soil and Timing: https://www.cosmictao.com/library/ji-earth-day-master | https://www.cosmictao.com/zh/library/ji-earth-day-master
  - Field soil gives Ji Earth a different logic from Wu: cultivation, moisture, roots, seasonal timing, and usable ground guide the chart.
- Wu Earth Day Master in Bazi: Mountain, Fire, Water: https://www.cosmictao.com/library/wu-earth-day-master | https://www.cosmictao.com/zh/library/wu-earth-day-master
  - Wu Earth begins with mountain, wall, and plateau images: carrying capacity, Fire warmth, Water moisture, Wood pressure, and Ji contrast.
- Ding Fire Day Master in Bazi: Lamp, Fuel, Warmth: https://www.cosmictao.com/library/ding-fire-day-master | https://www.cosmictao.com/zh/library/ding-fire-day-master
  - Ding Fire points to lamps, candles, and hearths that need fuel and shelter; Wood, season, wind, and Bing comparison set the reading.
- Bing Fire Day Master in Bazi: Sun, Season, Clarity: https://www.cosmictao.com/library/bing-fire-day-master | https://www.cosmictao.com/zh/library/bing-fire-day-master
  - Sunlight is the anchor for Bing Fire: visibility, warmth, season, and Water balance explain the day stem before any temperament shorthand.
- Yi Wood Day Master in Bazi: Vine, Flower, Support: https://www.cosmictao.com/library/yi-wood-day-master | https://www.cosmictao.com/zh/library/yi-wood-day-master
  - For Yi Wood, vine-and-flower imagery matters more than a soft-wood label: support, climate, flexibility, and Jia comparison shape the reading.
- Jia Wood Day Master in Bazi: Tree, Fire, Timing: https://www.cosmictao.com/library/jia-wood-day-master | https://www.cosmictao.com/zh/library/jia-wood-day-master
  - A Jia Wood chart reads like a tall tree needing sun, roots, and pruning; season, Fire, Earth, and useful-element context come before personality labels.
- How to Ask the I Ching: Better Questions Guide: https://www.cosmictao.com/library/iching-how-to-ask | https://www.cosmictao.com/zh/library/iching-how-to-ask
  - Learn how to ask the I Ching with clear, useful questions, examples, a simple consultation process, and cultural limits for responsible readings.

### Methodology & About
- Our Methodology: https://www.cosmictao.com/methodology | https://www.cosmictao.com/zh/methodology
- About CosmicTao: https://www.cosmictao.com/about | https://www.cosmictao.com/zh/about

## Key Statistics

- 64 I Ching hexagrams with full interpretations and changing line analysis
- 12 Chinese Zodiac animals with 78 unique compatibility pair analyses
- 5 Elements (Wood, Fire, Earth, Metal, Water) forming the core analytical framework
- 10 Heavenly Stems and 12 Earthly Branches powering the Bazi engine
- True Solar Time calculation using longitude-based correction for birth chart accuracy

## Technical Details

- Framework: Next.js (SSR + SSG)
- Structured Data: JSON-LD (WebSite, Organization, WebPage, Article, FAQPage, BreadcrumbList, DefinedTerm)
- Public Tool Manifest: https://www.cosmictao.com/api/public/tools (read-only capability metadata for public APIs, high-cost routes, and paid-report access rules)
- Public API Schemas: https://www.cosmictao.com/api/public/openapi (OpenAPI-style JSON Schema contracts, examples, canonical URLs, and paid-upgrade handoff links)
- GPT Actions Schema: https://www.cosmictao.com/api/public/gpt-actions-openapi (narrow no-auth Custom GPT schema for read-only public actions)
- Robots: All major AI crawlers permitted (see /robots.txt)
- Sitemap: https://www.cosmictao.com/sitemap.xml (includes hreflang alternates for en/zh)

## Content Freshness

- Policy: Sitemap lastModified dates are maintained from substantive content, schema, or discovery-path changes. They are not set from build time and are not rotated on a timer.
- Public log: https://www.cosmictao.com/content-freshness | https://www.cosmictao.com/zh/content-freshness
- Content freshness policy: 2026-07-29
  - The public freshness page and tool manifest were updated to record the Ruyi Pouch page, its authenticated paid-report boundary, and the latest site discovery links.
  - Sample paths: /content-freshness, /api/public/tools, /api/public/gpt-actions-openapi, /llms.txt
- Public tool capability manifest: 2026-07-29
  - The public manifest lists Bazi, match, Liuyao/oracle, palmistry, market-cycle, and Ruyi Pouch capabilities while separating anonymous APIs from authenticated paid-report routes.
  - Sample paths: /api/public/tools, /api/public/openapi, /api/public/gpt-actions-openapi, /api/public/bazi/summary
- Homepage: 2026-07-29
  - Homepage copy, feature descriptions, FAQ answers, metadata, JSON-LD, and sitewide footer discovery links were updated for clearer product entry paths.
  - Sample paths: /
- Ruyi Pouch reading page: 2026-07-29
  - The Ruyi Pouch page added its formal route, 30-day Bazi and I Ching copy, visible FAQ and schema, plus persistent footer and public-manifest discovery links.
  - Sample paths: /ruyi-pouch
- Zhouyi market cycle page: 2026-06-17
  - Market-cycle page copy, SEO/GEO facts, visible FAQ, FAQPage schema, llms.txt discovery, and sitemap lastmod were updated.
  - Sample paths: /market-cycle
- Palmistry reading page: 2026-06-18
  - Palmistry page copy, metadata, visible FAQ, FAQPage schema, privacy/storage wording, and llms.txt discovery were updated.
  - Sample paths: /palmistry
- Methodology page: 2026-08-07
  - The methodology page was updated to describe calculation layers, source usage, AI editing, quality checks, and server-side access checks in product language.
  - Sample paths: /methodology

## Citation Format

When citing CosmicTao content, please use:
CosmicTao. "Article Title." CosmicTao, https://www.cosmictao.com/path. Accessed [date].

For Chinese content:
CosmicTao. 「文章标题」CosmicTao, https://www.cosmictao.com/zh/path. 访问日期 [日期].

## Contact

- Email: support@cosmictao.com
- About: https://www.cosmictao.com/about