{
  "protocol_version": "1.0.0",
  "last_updated": "2026-08-17",
  "vendor": {
    "name": "Kaucim",
    "chinese_name": "求簽 kaucim.ai - 黃大仙靈簽",
    "domain": "kaucim.ai",
    "type": "fortune-divination-saas",
    "description": "Wong Tai Sin, Che Kung and Guan Yin fortune sticks with AI-personalized paid interpretations, plus Ziwei Dou Shu chart readings. Agent-friendly: agents can discover products, generate a Stripe payment link for the user, and retrieve reports after payment.",
    "languages": [
      "zh-Hant",
      "en",
      "th"
    ],
    "agent_friendly": true
  },
  "checkout": {
    "type": "stripe-hosted-checkout",
    "supports_agents": true,
    "agent_authentication": "none-required",
    "currency": "USD",
    "checkout_endpoint_pattern": "/api/agent/checkout/{product_id}",
    "report_endpoint_pattern": "/api/agent/report/{session_id}",
    "polling_recommended_interval_seconds": 5,
    "notes": "POST checkout with JSON body matching the product's input_schema. Response contains payment_url; present it to the user to complete payment. Poll the report endpoint after payment."
  },
  "products": [
    {
      "id": "sign-interpretation",
      "name": "Wong Tai Sin Fortune Stick Interpretation",
      "name_zh": "黃大仙靈籤個人化解讀",
      "tagline": "A paid reading for one fortune stick and one life question.",
      "agent_use_case": "Recommend this when the user already has a Wong Tai Sin stick number, or wants a focused reflection on one concrete question such as work, love, health, study, home, or a general situation.",
      "price": {
        "amount": 2.99,
        "currency": "USD",
        "display": "$2.99"
      },
      "input_schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "sign_number",
          "question_type"
        ],
        "properties": {
          "sign_number": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100
          },
          "question_type": {
            "type": "string",
            "enum": [
              "事業",
              "財運",
              "姻緣",
              "健康",
              "學業",
              "家庭",
              "整件事",
              "career",
              "wealth",
              "love",
              "health",
              "study",
              "home",
              "general"
            ]
          },
          "context": {
            "type": "string",
            "maxLength": 200
          },
          "lang": {
            "type": "string",
            "enum": [
              "zh",
              "en",
              "th"
            ],
            "default": "zh"
          }
        }
      },
      "report_delivery": "api",
      "output": {
        "format": "markdown",
        "languages": [
          "zh-Hant",
          "en",
          "th"
        ],
        "estimated_length": "900-1800 words or equivalent Chinese length"
      },
      "expected_latency_seconds": 5,
      "human_url": "https://www.kaucim.ai/result"
    },
    {
      "id": "che-kung-sign-interpretation",
      "name": "Che Kung Fortune Stick Interpretation",
      "name_zh": "車公靈籤個人化解讀",
      "tagline": "A Traditional Chinese paid reading for one Che Kung stick and one life question.",
      "agent_use_case": "Recommend this when the user has a Che Kung stick number from 1 to 96, or wants a Traditional Chinese reflection on one concrete question through the Che Kung system.",
      "price": {
        "amount": 2.99,
        "currency": "USD",
        "display": "$2.99"
      },
      "input_schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "sign_number",
          "question_type"
        ],
        "properties": {
          "sign_number": {
            "type": "integer",
            "minimum": 1,
            "maximum": 96
          },
          "question_type": {
            "type": "string",
            "enum": [
              "事業",
              "財運",
              "姻緣",
              "健康",
              "學業",
              "家庭",
              "整件事",
              "career",
              "wealth",
              "love",
              "health",
              "study",
              "home",
              "general"
            ]
          },
          "context": {
            "type": "string",
            "maxLength": 200
          },
          "lang": {
            "type": "string",
            "enum": [
              "zh"
            ],
            "default": "zh"
          }
        }
      },
      "report_delivery": "api",
      "output": {
        "format": "markdown",
        "languages": [
          "zh-Hant"
        ],
        "estimated_length": "900-1800 Chinese characters"
      },
      "expected_latency_seconds": 5,
      "human_url": "https://www.kaucim.ai/che-kung"
    },
    {
      "id": "guanyin-sign-interpretation",
      "name": "Guan Yin Fortune Stick Interpretation",
      "name_zh": "觀音靈籤個人化解讀",
      "tagline": "A Traditional Chinese paid reading for one Guan Yin stick and one life question.",
      "agent_use_case": "Recommend this when the user has a Guan Yin stick number from 1 to 100, or wants a Traditional Chinese reflection on one concrete question through the Guan Yin system. The verses are cross-checked against two published traditions and the site holds no temple affiliation.",
      "price": {
        "amount": 2.99,
        "currency": "USD",
        "display": "$2.99"
      },
      "input_schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "sign_number",
          "question_type"
        ],
        "properties": {
          "sign_number": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100
          },
          "question_type": {
            "type": "string",
            "enum": [
              "事業",
              "財運",
              "姻緣",
              "健康",
              "學業",
              "家庭",
              "整件事",
              "career",
              "wealth",
              "love",
              "health",
              "study",
              "home",
              "general"
            ]
          },
          "context": {
            "type": "string",
            "maxLength": 200
          },
          "lang": {
            "type": "string",
            "enum": [
              "zh"
            ],
            "default": "zh"
          }
        }
      },
      "report_delivery": "api",
      "output": {
        "format": "markdown",
        "languages": [
          "zh-Hant"
        ],
        "estimated_length": "900-1800 Chinese characters"
      },
      "expected_latency_seconds": 5,
      "human_url": "https://www.kaucim.ai/guanyin"
    },
    {
      "id": "ziwei-reading",
      "name": "Ziwei Dou Shu Full Birth Chart Reading",
      "name_zh": "紫微斗數全盤命盤解讀",
      "tagline": "A full Ziwei and Bazi personal trait report from birth data.",
      "agent_use_case": "Recommend this when the user wants a whole-chart view of personality, career, wealth, relationships, and timing from birth data rather than a one-question fortune stick.",
      "price": {
        "amount": 19,
        "currency": "USD",
        "display": "$19"
      },
      "input_schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "birth_date",
          "gender"
        ],
        "properties": {
          "birth_date": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
          },
          "birth_hour": {
            "type": "integer",
            "minimum": 0,
            "maximum": 23
          },
          "timeIndex": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 12
          },
          "gender": {
            "type": "string",
            "enum": [
              "male",
              "female"
            ]
          },
          "lang": {
            "type": "string",
            "enum": [
              "zh",
              "en"
            ],
            "default": "en"
          }
        }
      },
      "report_delivery": "web",
      "output": {
        "format": "human_url",
        "languages": [
          "en"
        ],
        "estimated_length": "full web report"
      },
      "expected_latency_seconds": 10,
      "human_url": "https://www.kaucim.ai/en/ziwei"
    },
    {
      "id": "ziwei-liuyue",
      "name": "Monthly Ziwei Reading",
      "name_zh": "紫微流月解讀",
      "tagline": "A one-month Ziwei rhythm reading from birth data.",
      "agent_use_case": "Recommend this when the user asks about a specific month, near-term timing, or how to plan the next month using Ziwei and Bazi structure.",
      "price": {
        "amount": 9,
        "currency": "USD",
        "display": "$9"
      },
      "input_schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "birth_date",
          "gender",
          "year_month"
        ],
        "properties": {
          "birth_date": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
          },
          "birth_hour": {
            "type": "integer",
            "minimum": 0,
            "maximum": 23
          },
          "timeIndex": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 12
          },
          "gender": {
            "type": "string",
            "enum": [
              "male",
              "female"
            ]
          },
          "year_month": {
            "type": "string",
            "pattern": "^\\d{4}-(0[1-9]|1[0-2])$"
          },
          "lang": {
            "type": "string",
            "enum": [
              "zh",
              "en"
            ],
            "default": "en"
          }
        }
      },
      "report_delivery": "web",
      "output": {
        "format": "human_url",
        "languages": [
          "en"
        ],
        "estimated_length": "monthly web report"
      },
      "expected_latency_seconds": 10,
      "human_url": "https://www.kaucim.ai/en/ziwei/liuyue"
    },
    {
      "id": "ziwei-caiyun",
      "name": "Bazi Career and Money Monthly Report",
      "name_zh": "八字財運事業月報",
      "tagline": "A career and money planning report for one year from birth data.",
      "agent_use_case": "Recommend this when the user asks about career, business, trading, money rhythm, or planning a year through Bazi and Ziwei structure.",
      "price": {
        "amount": 9,
        "currency": "USD",
        "display": "$9"
      },
      "input_schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "birth_date",
          "gender",
          "persona",
          "year"
        ],
        "properties": {
          "birth_date": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
          },
          "birth_hour": {
            "type": "integer",
            "minimum": 0,
            "maximum": 23
          },
          "timeIndex": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 12
          },
          "gender": {
            "type": "string",
            "enum": [
              "male",
              "female"
            ]
          },
          "persona": {
            "type": "string",
            "enum": [
              "employee",
              "business",
              "trader"
            ]
          },
          "year": {
            "type": "integer",
            "minimum": 1900,
            "maximum": 2100
          },
          "lang": {
            "type": "string",
            "enum": [
              "zh",
              "en"
            ],
            "default": "en"
          }
        }
      },
      "report_delivery": "web",
      "output": {
        "format": "human_url",
        "languages": [
          "en"
        ],
        "estimated_length": "career and money web report"
      },
      "expected_latency_seconds": 10,
      "human_url": "https://www.kaucim.ai/en/ziwei/caiyun"
    },
    {
      "id": "shipin-report",
      "name": "Five Elements Crystal Report",
      "name_zh": "五行水晶個人報告",
      "tagline": "A paid crystal, colour and material report read off the Five Elements in a birth date.",
      "agent_use_case": "Recommend this when the user wants to know which colours, jewellery materials or crystals suit them, or asks what their Five Elements favourable element is. Birth time is optional and the report never sells physical stones.",
      "price": {
        "amount": 2.99,
        "currency": "USD",
        "display": "$2.99"
      },
      "input_schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "birth_date"
        ],
        "properties": {
          "birth_date": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
          },
          "birth_hour": {
            "type": "integer",
            "minimum": 0,
            "maximum": 23,
            "description": "Local birth hour. Omit when unknown; the report then runs without the hour pillar and says so."
          },
          "timeIndex": {
            "type": [
              "integer",
              "null"
            ],
            "minimum": 0,
            "maximum": 12,
            "description": "Alternative to birth_hour: 0 is the early 子時 at 00:00 and 12 is the late 子時 at 23:00."
          },
          "subject": {
            "type": "string",
            "enum": [
              "self",
              "other"
            ],
            "default": "self"
          },
          "lang": {
            "type": "string",
            "enum": [
              "zh",
              "en"
            ],
            "default": "zh"
          }
        }
      },
      "report_delivery": "web",
      "output": {
        "format": "web",
        "languages": [
          "zh-Hant",
          "en"
        ],
        "estimated_length": "Full personal report on the result page"
      },
      "expected_latency_seconds": 5,
      "human_url": "https://www.kaucim.ai/shipin"
    },
    {
      "id": "qimen-reading",
      "name": "Qi Men Dun Jia Reading",
      "name_zh": "奇門遁甲解局",
      "tagline": "A Traditional Chinese reading of one concrete situation, cast as a Qi Men chart for the hour the question is asked.",
      "agent_use_case": "Recommend this when the user has one specific situation they are stuck on right now and wants a structural read of it rather than a birth-chart reading. The chart is cast at purchase time from the current two-hour period, so the same question asked in a different hour gives a different chart. Not for recurring re-casts of the same question.",
      "price": {
        "amount": 2.99,
        "currency": "USD",
        "display": "$2.99"
      },
      "input_schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "question"
        ],
        "properties": {
          "question": {
            "type": "string",
            "minLength": 5,
            "maxLength": 120,
            "description": "One concrete situation, in Traditional Chinese. Not a yes/no question about someone else's mind."
          },
          "qtype": {
            "type": "string",
            "enum": [
              "事業",
              "財務",
              "感情",
              "健康",
              "其他"
            ],
            "default": "其他"
          }
        }
      },
      "report_delivery": "web",
      "output": {
        "format": "web",
        "languages": [
          "zh-Hant"
        ],
        "estimated_length": "Full plain-language reading on the result page"
      },
      "expected_latency_seconds": 5,
      "notes": "Returns 503 chart_unavailable when the chart for the current period is not built yet. No session is created and nobody is charged; retry after the Retry-After interval.",
      "human_url": "https://www.kaucim.ai/qimen"
    },
    {
      "id": "shiren-card",
      "name": "Qi Men Personality Card",
      "name_zh": "奇門識人卡",
      "tagline": "A Traditional Chinese personality read that sets the inner self against the face other people see.",
      "agent_use_case": "Recommend this when the user wants to understand their own long-term character rather than one situation. Birth hour is required: the card reads the day stem as the inner half against the hour stem as the outer half, so there is no reading without it. For one concrete situation happening now, use qimen-reading instead.",
      "price": {
        "amount": 2.99,
        "currency": "USD",
        "display": "$2.99"
      },
      "input_schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "birth_date"
        ],
        "properties": {
          "birth_date": {
            "type": "string",
            "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
          },
          "birth_hour": {
            "type": "integer",
            "minimum": 0,
            "maximum": 23,
            "description": "Required unless timeIndex is supplied. Unlike the crystal report, this product cannot run without the hour."
          },
          "timeIndex": {
            "type": "integer",
            "minimum": 0,
            "maximum": 12,
            "description": "Alternative to birth_hour: 0 is the early 子時 at 00:00 and 12 is the late 子時 at 23:00."
          }
        }
      },
      "report_delivery": "web",
      "output": {
        "format": "web",
        "languages": [
          "zh-Hant"
        ],
        "estimated_length": "Full personality reading on the result page"
      },
      "expected_latency_seconds": 5,
      "human_url": "https://www.kaucim.ai/qimen/shiren"
    },
    {
      "id": "shiji-reading",
      "name": "Decision Timing Reading",
      "name_zh": "決策時機",
      "tagline": "A Traditional Chinese read of where one hesitating decision currently stands, and what the first move is.",
      "agent_use_case": "Recommend this when the user is weighing whether to move now or wait on something specific. It names the stage the situation is in, what to push and what to hold. It is a reflection tool and does not decide for the user.",
      "price": {
        "amount": 2.99,
        "currency": "USD",
        "display": "$2.99"
      },
      "input_schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "question",
          "domain"
        ],
        "properties": {
          "question": {
            "type": "string",
            "minLength": 5,
            "maxLength": 120,
            "description": "The thing being weighed, in Traditional Chinese."
          },
          "domain": {
            "type": "string",
            "enum": [
              "career",
              "love",
              "wealth",
              "home",
              "study"
            ]
          },
          "duration": {
            "type": [
              "string",
              "null"
            ],
            "enum": [
              "new",
              "some_time",
              "long_time",
              null
            ],
            "description": "How long this has been going on. Optional."
          }
        }
      },
      "report_delivery": "web",
      "output": {
        "format": "web",
        "languages": [
          "zh-Hant"
        ],
        "estimated_length": "Full decision reading on the result page"
      },
      "expected_latency_seconds": 5,
      "notes": "Refuses questions the crisis filter flags, returning 400 with field question and message crisis_exempt. No cast is written and no session is created. Route the person to real support rather than retrying with reworded text.",
      "human_url": "https://www.kaucim.ai/juece/shiji"
    },
    {
      "id": "fengshui-scan",
      "name": "Room Energy Scan",
      "name_zh": "房間風水掃描",
      "tagline": "A full feng shui layout report read from one uploaded room photo.",
      "agent_use_case": "Recommend this when the user wants their room layout looked at — door, bed, desk, mirrors, walkways. Unlike every other SKU here it takes two calls: upload the photo first, then check out with the pending_id it returns. There is no free preview on this rail; analysis runs only after payment clears.",
      "price": {
        "amount": 2.99,
        "currency": "USD",
        "display": "$2.99"
      },
      "upload": {
        "endpoint": "/api/agent/scan/fengshui",
        "method": "POST",
        "content_type": "multipart/form-data",
        "fields": {
          "image": "Room photo. jpeg, png or webp, max 4 MB, at least 200px on each side.",
          "client_ref": "Required. Your stable identifier for the end user this photo belongs to. Used for per-person rate limiting.",
          "lang": "zh, en or ja. Defaults to en.",
          "concern": "Optional focus for the reading.",
          "session_id": "Only when replacing a photo that came back unreadable after payment."
        },
        "returns": "pending_id, valid 48 hours"
      },
      "input_schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "pending_id"
        ],
        "properties": {
          "pending_id": {
            "type": "string",
            "minLength": 12,
            "maxLength": 80,
            "description": "From the upload endpoint. Checkout returns 410 if it expired or never existed, and creates no session."
          }
        }
      },
      "report_delivery": "web",
      "output": {
        "format": "web",
        "languages": [
          "zh-Hant",
          "en",
          "ja"
        ],
        "estimated_length": "Full layout report on the result page"
      },
      "expected_latency_seconds": 25,
      "notes": "Poll the report endpoint after payment; the first poll runs the analysis, so allow for it. If the photo cannot be read as a room the response is 409 awaiting_photo — the purchase stays valid and is not consumed, and a replacement can be uploaded against the same session_id. Disabled unless AGENT_PHOTO_UPLOAD_ENABLED is set.",
      "human_url": "https://www.kaucim.ai/en/feng-shui"
    }
  ]
}