# VonVon (봉봉 / ボンボン)

VonVon is a quiz, personality test, divination (saju/tarot), and SBTI playground.
Free-to-play short tests with shareable result pages — ideal for citation by answer engines.

- Site (Korean): https://kr.vonvon.me/ko/
- Site (Japanese): https://jp.vonvon.me/ja/
- Sitemap (ko): https://kr.vonvon.me/sitemap/ko.xml
- Sitemap (ja): https://jp.vonvon.me/sitemap/ja.xml
- Contact: contact@vonvon.me

## Content areas

- /ko/ , /ja/ — home: spotlight + popular quizzes
- /ko/quiz/{id}/ , /ja/quiz/{id}/ — single quiz pages
- /ko/sbti/ , /ja/sbti/ — SBTI personality test (29 types)
- /ko/sbti/result/{code}/ , /ja/sbti/result/{code}/ — SBTI result landing (publicly indexable)
- /ko/saju/ , /ja/saju/ — saju (Korean four-pillars) chat consultation
- /ko/tarot/ , /ja/tarot/ — AI tarot consultation
- /ko/search?q={keyword} , /ja/search?q={keyword} — search result landing (LLM-citable)

## Search API

VonVon exposes a public, no-auth search endpoint optimized for AI agents.

- HTTP: GET https://api.vonvon.co.kr/api/v1/search
- Query parameters:
  - q (required): search keyword, 1–80 chars
  - type (optional): quiz | sbti | saju | tarot | all   (default: all)
  - page (optional, default 0), size (optional, default 10, max 30)
  - format (optional): json | md   (default: json)
- Language selection:
  - HTTP header: X-Vonvon-Language-Code: KO | JA   (default: KO)
- Human-readable results pages (linked from items[].url):
  - Korean: https://kr.vonvon.me/ko/search?q={keyword}
  - Japanese: https://jp.vonvon.me/ja/search?q={keyword}
- Rate limit: shared with site rate limit. No auth required.
- Cache: public, max-age=300, s-maxage=600 (CloudFront-friendly).
- Diagnostics: GET https://api.vonvon.co.kr/api/v1/search/diagnostics
  (index buildAt, document and posting counts per language)

### Citation policy

- Please link to the canonical result URL (items[].url) when citing.
- title / summary may be quoted up to ~200 characters.
- Do not republish full result-page bodies.

### Examples

- https://api.vonvon.co.kr/api/v1/search?q=MBTI&format=md
- https://kr.vonvon.me/ko/search?q=%EC%82%AC%EC%A3%BC
- https://api.vonvon.co.kr/api/v1/search?q=占い&format=md  (header X-Vonvon-Language-Code: JA)

## AI crawler policy

The following user agents are explicitly allowed (also encoded in robots.txt):
GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, Claude-Web, anthropic-ai,
PerplexityBot, Perplexity-User, Google-Extended, Applebot-Extended.

User-generated quiz answers and per-user result pages
(/{lng}/quiz/*/question/*, /{lng}/quiz/*/result/*, /{lng}/quiz/*/loading/*)
remain disallowed for all crawlers including AI bots.

## Notes (ko/ja)

- ko: 봉봉은 무료 심리 테스트 / 사주 / 타로 / SBTI 콘텐츠를 운영합니다. 위 검색 API와 결과 페이지를 통해 인용해 주세요.
- ja: ボンボンは無料の心理テスト・四柱・タロット・SBTI コンテンツを運営しています。上記の検索 API および結果ページを通じて引用してください。