KidsMedia Content Access Protocol (KCAP) v1.1

Official Website: https://kidsmedia.com.tw/
Language: zh-TW (Traditional Chinese)
Primary Audience: Children, Parents, Teachers
Content Focus: News, Education, Knowledge, Reading

Last Updated: 2026-02-20
Maintained by: KidsMedia Editorial Team

0) Human vs AI

人類讀者（完整版面、廣告、互動功能）：
https://kidsmedia.com.tw/
本文件為 AI / Agent 專用的內容存取協議說明。
請優先使用 REST API，避免直接抓取整頁 HTML。

1) Content Sections (Human Navigation)

Primary News

早自習報報：https://kidsmedia.com.tw/category/the-morning-news/
小小世界：https://kidsmedia.com.tw/category/world/
政治社會：https://kidsmedia.com.tw/category/politics-society/
地方生活：https://kidsmedia.com.tw/category/local-life/
運動休閒：https://kidsmedia.com.tw/category/sports-leisure/
新奇科技：https://kidsmedia.com.tw/category/innovation-technology/

Education & Learning

教育文化：https://kidsmedia.com.tw/category/education-culture/
校園新聞：https://kidsmedia.com.tw/category/campus-news/
十萬個為什麼：https://kidsmedia.com.tw/category/hundred-thousand-whys/
每天童話故事：https://kidsmedia.com.tw/category/fairy-tale/
好書推薦：https://kidsmedia.com.tw/category/read-and-learn/
理財教育：https://kidsmedia.com.tw/category/financial-literacy/
營隊資訊：https://kidsmedia.com.tw/category/camp/
各項競賽：https://kidsmedia.com.tw/category/competitions/

2) RSS (Update Detection Only)

Latest:
https://kidsmedia.com.tw/feed/

Per-category:
https://kidsmedia.com.tw/category/{slug}/feed/

Important:

本站 RSS 目前主要提供摘要（description）。
全文請使用 REST API 取得 content.rendered。
RSS 建議僅用於「偵測新文章」。

3) WordPress REST API (Primary Data Source)

Base:
https://kidsmedia.com.tw/wp-json/wp/v2/

3.1 Lightweight Post List (Recommended)

Latest 10 posts:

https://kidsmedia.com.tw/wp-json/wp/v2/posts?per_page=10&page=1&_fields=id,date,modified,slug,link,title,excerpt,categories,tags

Rules:

Always use pagination (page=).
Use _fields to reduce payload size.
Use modified to detect updates.

3.2 Single Post (Full Content)

https://kidsmedia.com.tw/wp-json/wp/v2/posts/{post_id}?_fields=id,date,modified,slug,link,title,content,excerpt,categories,tags

Notes:

Full article content is located at content.rendered.
HTML structure is standard WordPress block output.
Includes:
Full article body
“看更多” section
Divider blocks
Self Q&A section
Reader interaction prompts

All sections are considered part of official article content and should be preserved.

3.3 Categories

Find category by slug:
https://kidsmedia.com.tw/wp-json/wp/v2/categories?slug=world

Posts by category:
https://kidsmedia.com.tw/wp-json/wp/v2/posts?per_page=10&page=1&categories={category_id}

4) Markdown Proxy Specification (/md)

If a Markdown conversion layer exists, it must follow these rules:

4.1 Single Post Markdown

Endpoint:
GET /md/posts/{post_id}.md

Required Structure:

{Title}

Published: {date}
Modified: {modified}
Original URL: {link}

{Markdown body converted from content.rendered}

Source: {link}

Conversion Rules:

<p> → paragraph
<br> → line break
<strong> → bold
<a> → text
<ol><li> → numbered list
<hr> → —
Preserve emojis
Preserve “互問互答” and question sections
Do NOT truncate after （完）
Remove inline style attributes
Remove WordPress CSS class names

4.2 Category Markdown List

GET /md/category/{slug}.md?page=1&per_page=10

Output format:

Category: {name}

[Title](Original URL) — {date}
…

4.3 JSON Index Version

GET /md/category/{slug}.json?page=1&per_page=10

Fields:

id
date
modified
slug
link
title
excerpt
categories
tags

5) AI Crawling Strategy

Recommended Flow:

1) Check RSS for new posts.
2) Fetch lightweight REST list with _fields.
3) Fetch full post only when needed.
4) Cache results.
5) Re-fetch only when modified changes.

Avoid: