Pour les développeurs et agents IA

YOKAI.JP — Ressources lisibles par machine

YOKAI.JP ne propose pas d'API REST ou GraphQL publique. En revanche, nous publions les ressources suivantes pour que la structure du site, le catalogue de yokai et les métadonnées des pages puissent être lus par des programmes — moteurs de recherche, agents IA, outils de recherche.

llms.txt — guide du site pour agents LLM

Documents Markdown suivant la convention llms.txt. Décrivent la structure du site, les URL des pages clés, la liste complète des slugs du catalogue de yokai et les liens multilingues. Fournis par langue.

/llms.txtJapanese — 全サイト構造、主要ページ、妖怪一覧、多言語リンクを Markdown で。
/llms-en.txtEnglish version of the site map for LLM agents.
/llms-zh-CN.txt简体中文 ─ 站点结构 / 主要页面 / 妖怪列表 (Markdown)。
/llms-ko.txt한국어 ─ 사이트 구조 안내 (LLM 에이전트용).
/llms-fr.txtFrançais ─ structure du site pour agents LLM.
/llms-es.txtEspañol ─ estructura del sitio para agentes LLM.

Sitemaps — entrées XML

Schéma sitemaps.org standard, divisé par langue et par type de contenu. Les crawlers doivent commencer par /sitemap-index.xml — il liste tous les sub-sitemaps.

/sitemap-index.xmlAll languages, all content types — start here.
/sitemap.xmlDefault (ja) sitemap.
/sitemap-en.xmlEnglish sitemap.
/sitemap-zh-CN.xml简体中文 sitemap.
/sitemap-ko.xml한국어 sitemap.
/sitemap-fr.xmlFrench sitemap.
/sitemap-es.xmlSpanish sitemap.
/sitemap-kana.xmlYokai kana index pages (50-on rows).
/sitemap-maya-calendar.xmlMaya-calendar pages.

Données structurées JSON-LD

Du JSON-LD conforme à schema.org est intégré sur chaque page via <script type="application/ld+json">. Les agents IA et moteurs de recherche peuvent lire l'identité et les attributs clés de chaque page.

WebSiteHome page (/) — site identity
OrganizationHome page (/) — Glory Lab identifier
WebApplicationHome page (/) — feature list + price (free) + supported languages
QuizHome page + diagnosis pages
Article/blog/{slug} — author / datePublished / image
TechArticle/developers (this page)
BreadcrumbListDeep pages (/yokai/{slug}, /yokai/{slug}/cards, etc.)

Autres surfaces de métadonnées

/robots.txtCrawl rules. Includes sitemap-index.xml.

OpenGraph + Twitter Card meta — Présents sur chaque page (og:title, og:description, og:image, og:url, twitter:card).
hreflang alternate links — Les pages multilingues émettent <link rel="alternate" hreflang="...">. Six langues (ja / en / zh-CN / ko / fr / es).
canonical link — Chaque page émet <link rel="canonical">.

À propos d'une API publique

YOKAI.JP n'expose actuellement aucune API REST / GraphQL aux développeurs tiers. Les endpoints internes /api/* (chat, votes, sanctuaire, etc.) sont protégés par session et CORS car ils alimentent l'application web elle-même.

Pour récupérer du contenu public (données du catalogue, articles de blog…), le chemin recommandé est de crawler le HTML depuis le sitemap et de parser le JSON-LD et les méta OpenGraph embarqués. La liste complète des slugs de yokai est énumérée dans /llms.txt.

Pour demander une API publique ou discuter d'un usage professionnel, merci de passer par Contact.