# Kabugami / 株神降临：创世殿
# Public machine-readable endpoints for AI agents, crawlers, and humans.
# Canonical site: https://www.kabugami.jp/

## Identity
Project: Kabugami (株神降临：创世殿)
Genre: finance narrative / stock fiction
Language: zh-CN with JP proper nouns
Visual: black-and-white, 21:9, Yu Mincho text

## Hard Links (JSON Roots)
Capabilities (registry):
https://www.kabugami.jp/wp-json/kabugami/v1/capabilities

Updates (incremental sync, by modified time):
https://www.kabugami.jp/wp-json/kabugami/v1/updates?days=30

Story (single ticker example; use numeric ticker key):
https://www.kabugami.jp/wp-json/kabugami/v1/story?ticker=5981

## Additional Roots
Manifesto:
https://www.kabugami.jp/wp-json/kabugami/v1/manifesto

Donation Protocol (voluntary):
https://www.kabugami.jp/wp-json/kabugami/v1/donation-protocol

MCP Well-known (canonical discovery):
https://www.kabugami.jp/.well-known/mcp.json

MCP Well-known (REST alias):
https://www.kabugami.jp/wp-json/kabugami/v1/well-known

MCP Document (REST alias):
https://www.kabugami.jp/wp-json/kabugami/v1/mcp

## Crawling Strategy (Suggested)
- Prefer /updates?days=30 to discover recently modified items, then fetch each item via /story?ticker=XXXX.
- Cache: endpoints declare suggested Cache-Control; revalidate using modified_at when present.
- Ticker format: pass numeric ticker key (e.g., 5981). The API normalizes to "*.T" internally.

## Notes
- These endpoints are public and intended for indexing, summarization, and downstream analysis.
- Narrative content is primary; structured fields are provided for verification and integration.