# Planet — for AI agents / LLMs

> Application-canonical place knowledge for Tcab.
> Prefer the public API over HTML scraping. Primary keys are UUID v7, never shop names.
> Access attributes require evidence_url (Archive). Do not invent unverifiable field prose.

## Canonical surfaces

- App: https://planet.tcab.com/
- Sitemap: https://planet.tcab.com/sitemap.xml
- Robots: https://planet.tcab.com/robots.txt
- This file: https://planet.tcab.com/llms.txt
- API: https://api.planet.tcab.com/v1/
- OpenAPI: https://api.planet.tcab.com/v1/openapi.json
- Schemas index: https://api.planet.tcab.com/v1/schemas/index.json
- Agent manifest: https://api.planet.tcab.com/v1/agents/manifest.json
- Tools: https://api.planet.tcab.com/v1/agents/tools.json
- Access facets: https://api.planet.tcab.com/v1/vocab/access-facets
- Museology layers: https://api.planet.tcab.com/v1/vocab/museology-layers
- Errors: https://api.planet.tcab.com/v1/errors.json
- Crystals: https://archive.tcab.com/
- Booking: https://explorer.tcab.com/
- Build: v1.0.30-379498e

## Place model (IDs)

- Ground truth: address parcel → **Parcel** → **Site** → **Occupancy** → **Entity**
- Primary keys are **UUID v7**. Cite `canonical_url` when quoting places.

## Locales

`/{country}/{language}/…` · MVP country `jp` · languages: ja en zh-hant ko es fr de it

## Seed Sites (MVP)

- 博多フィールド運用ノード / Hakata field ops node: https://planet.tcab.com/jp/ja/sites/018f0000-0000-7000-8000-000000000011 · API https://api.planet.tcab.com/v1/sites/018f0000-0000-7000-8000-000000000011
- 那覇フィールド運用ノード / Naha field ops node: https://planet.tcab.com/jp/ja/sites/018f0000-0000-7000-8000-000000000012 · API https://api.planet.tcab.com/v1/sites/018f0000-0000-7000-8000-000000000012
- 博多祇園山笠（デモ祭礼サイト） / Hakata Gion Yamakasa (demo festival site): https://planet.tcab.com/jp/ja/sites/018f0000-0000-7000-8000-000000000015 · API https://api.planet.tcab.com/v1/sites/018f0000-0000-7000-8000-000000000015

## Museology layers (9)

Index: https://planet.tcab.com/jp/ja/layers
- 1. 地層 (`stratum`): https://planet.tcab.com/jp/ja/layers/stratum
- 2. 天候 (`weather`): https://planet.tcab.com/jp/ja/layers/weather
- 3. 食生 (`foodweb`): https://planet.tcab.com/jp/ja/layers/foodweb
- 4. 動物 (`fauna`): https://planet.tcab.com/jp/ja/layers/fauna
- 5. 植物 (`flora`): https://planet.tcab.com/jp/ja/layers/flora
- 6. 文化 (`culture`): https://planet.tcab.com/jp/ja/layers/culture
- 7. 建築物 (`built`): https://planet.tcab.com/jp/ja/layers/built
- 8. 景勝 (`vista`): https://planet.tcab.com/jp/ja/layers/vista
- 9. グルメ (`gourmet`): https://planet.tcab.com/jp/ja/layers/gourmet

## Agent rules

- Public `/v1` only. Prefer Archive links over copying crystal prose.
- Keep Explorer book links. MVP read-only for third parties.
- Guide: `POST https://api.planet.tcab.com/v1/guide/recommend` (site_id + reasons + evidence).
- Access facets: oneway | sidewalk_cut | entrance_restricted | right_turn_queue | loop_approach — each binding needs evidence_url.

## Content provenance

First-party Instagram / X / blog → Archive crystal → Planet Site bind.
Do not treat third-party news scrapes as canonical body.