| name | saju-fortune |
| description | 사주팔자 정보를 인터뷰로 확인한 뒤 saju-fortune npm package를 사용해 연애운, 재물운, 직업운, 건강운, 한해 운세, 궁합을 대화형으로 풀이한다. |
| license | MIT |
| metadata | {"category":"utility","locale":"ko-KR","phase":"v1"} |
Saju Fortune
What this skill does
saju-fortune npm package로 사주팔자 기본 구조, 오행 분포, 용신 조율점, 주제별 운세, 궁합 풀이를 제공한다. 사용자를 바로 점치는 대신 먼저 필요한 정보를 인터뷰하고, 패키지 결과를 근거로 사주 풀이 에이전트처럼 대화한다.
이 스킬은 hjsh200219/fortuneteller MCP 서버의 도구 모델(analyze_saju, check_compatibility, get_daily_fortune, get_dae_un, get_fortune_by_period)을 참고하지만 MCP 서버를 따로 실행하지 않는다. 에이전트는 로컬/전역 npm package를 직접 호출한다.
When to use
- "사주 봐줘"
- "올해 운세 어때?"
- "연애운/재물운/직업운/건강운 봐줘"
- "우리 궁합 봐줘"
- "생년월일시로 사주팔자 풀이해줘"
When not to use
- 의학적 진단, 투자 수익 보장, 법적 판단처럼 전문 책임이 필요한 결정을 대신해야 하는 경우
- 사용자가 출생 정보를 제공하지 않고 사주 계산 없이 일반 조언만 원하는 경우
- 사주 풀이를 사실 확정이나 운명 결정론으로 제시해야 하는 경우
Prerequisites
- Node.js 18+
- 배포 후:
npm install -g saju-fortune
- 실행 전:
export NODE_PATH="$(npm root -g)"
- 이 저장소에서 개발할 때: 루트에서
npm install
Required interview inputs
사주 계산 전에 아래를 확인한다.
- 이름(선택)과 한자 이름(선택)
- 양력/음력
- 생년월일 (
YYYY-MM-DD)
- 태어난 시간 (
HH:mm, 모르면 모른다고 기록하고 시간 정확도 한계를 설명)
- 성별 (
male 또는 female으로 package 호출)
- 출생 시군구(선택, 모르면 생략)
- 보고 싶은 주제: 종합운, 연애운, 재물운, 직업운, 건강운, 한해 운세, 궁합
궁합은 두 사람 각각의 생년월일시와 성별을 확인한다.
Workflow
1. Interview first
정보가 부족하면 풀이를 시작하지 말고 짧게 묻는다.
권장 질문:
사주 풀이를 위해 양력/음력, 생년월일, 태어난 시간, 성별을 알려주세요. 보고 싶은 주제도 골라주세요: 연애운, 재물운, 직업운, 건강운, 한해 운세, 궁합.
태어난 시간을 모르면:
태어난 시간을 모르면 시주는 확정하지 못해요. 가능한 시간대가 있으면 알려주시고, 없으면 연·월·일 중심의 보수적 풀이로 진행할게요.
음력 생일이면 이 패키지 안에서 변환하지 않는다. 검증된 만세력으로 양력 생년월일을 먼저 확인한 뒤 calendar: "solar"로 호출하고, 변환 근거와 윤달 여부를 한계로 적는다.
2. Install package when missing
node -e 'require("saju-fortune")'가 실패하면 다른 웹 스크래핑이나 MCP 서버 실행으로 우회하지 말고 전역 package 설치를 먼저 시도한다.
npm install -g saju-fortune
export NODE_PATH="$(npm root -g)"
3. Analyze one person's saju
NODE_PATH="$(npm root -g)" node - <<'JS'
const { analyzeSaju } = require("saju-fortune")
const result = analyzeSaju({
name: "민준",
birthDate: "1990-03-15",
birthTime: "10:30",
calendar: "solar", // 음력은 검증된 만세력으로 양력 변환 후 입력
gender: "male",
birthCity: "서울"
}, {
analysisType: "fortune",
fortuneType: "wealth",
targetYear: 2026
})
console.log(JSON.stringify(result, null, 2))
JS
fortuneType mapping:
- 종합운:
general
- 연애운:
love
- 재물운:
wealth
- 직업운:
career
- 건강운:
health
- 한해 운세:
general + targetYear
4. Check compatibility
NODE_PATH="$(npm root -g)" node - <<'JS'
const { checkCompatibility } = require("saju-fortune")
const result = checkCompatibility({
person1: { name: "민준", birthDate: "1990-03-15", birthTime: "10:30", gender: "male" },
person2: { name: "서연", birthDate: "1992-07-20", birthTime: "14:30", gender: "female" }
})
console.log(JSON.stringify(result, null, 2))
JS
5. MCP-style tool names without serving MCP
패키지는 upstream MCP 서버의 대표 도구명을 로컬 함수로 흉내 낸다. MCP 서버를 따로 띄우지 않는다.
const { callSajuTool } = require("saju-fortune")
const result = callSajuTool("analyze_saju", {
birthDate: "1990-03-15",
birthTime: "10:30",
gender: "male",
analysisType: "fortune",
fortuneType: "love"
})
지원 도구명:
analyze_saju
check_compatibility
get_daily_fortune
get_dae_un
get_fortune_by_period
convert_calendar
manage_settings
6. Interpret like a fortune-reading agent
응답은 아래 구조를 따른다.
- 입력 정보와 정확도 한계: 양력/음력, 시간, 출생지 누락 여부를 확인한다.
- 사주팔자 요약: 연주·월주·일주·시주와 일간을 짧게 설명한다.
- 오행 분포: 강한 오행과 부족한 오행을 생활 언어로 번역한다.
- 주제별 풀이: 연애운/재물운/직업운/건강운/한해 운세 중 사용자가 고른 주제만 깊게 본다.
- 실천 조언: 결정론 대신 대화, 습관, 리스크 관리 조언을 준다.
- 주의 문구: 사주 풀이는 재미와 자기점검용이며 의료·투자·법률 판단을 대신하지 않는다고 말한다.
Done when
- 필요한 출생 정보를 인터뷰로 확인했다.
saju-fortune package 결과를 근거로 사주팔자와 오행 분포를 확인했다.
- 사용자가 요청한 주제(연애운, 재물운, 한해 운세 등)에 맞춰 풀이했다.
- 모르는 시간, 음력 윤달, 출생지 누락 같은 한계를 명시했다.
- MCP 서버를 실행하거나 별도 서버를 서빙하지 않았다.
Failure modes
- 태어난 시간이 없으면 시주와 시주 기반 해석은 확정할 수 없다.
- 음력 또는 윤달 생일은 내장 계산으로 변환하지 않는다. 검증된 만세력으로 양력 날짜를 먼저 확인하지 못하면 풀이하지 않는다.
- 출생지가 없으면 경도 보정은 생략되거나 기본값으로 해석된다.
- package가 설치되지 않았고 네트워크도 없으면 설치 실패를 설명하고 진행하지 않는다.
- 사주 풀이는 전통 해석 기반의 참고 자료이며 의료, 투자, 법률, 안전 결정을 대체하지 않는다.
Notes
- 입력한 생년월일시는 풀이 중에만 사용하고 영구 저장하지 않는다.
- 사용자가 불안해할 만한 단정적 흉언, 저주, 사망 예언, 질병 확정 표현은 하지 않는다.
- 궁합 점수는 관계 대화의 참고자료일 뿐 이별/결혼 결정을 대신하지 않는다.