開發者入口 Developer Portal

Idol Info Hub 的資料完全公開：不需要 API key、不需要註冊、沒有登入系統。所有端點皆為唯讀、可跨網域呼叫（Access-Control-Allow-Origin: *），正式站本身即是沙盒環境（sandbox）——呼叫任何端點都不會改動資料。

All Idol Info Hub data is public: no API key, no registration, no login. Every endpoint is read-only and CORS-enabled, so production doubles as the sandbox — no call can mutate data.

快速開始 Quickstart

```bash

1. API 索引 — API index

curl https://idolinfohub.com/api/v1/index.json

2. 所有活動 — every event

curl https://idolinfohub.com/api/v1/events.json

3. 單一活動 — one event

curl https://idolinfohub.com/api/v1/events/EVENT_SLUG.json

4. 任何頁面的 Markdown 版本 — Markdown for any page

curl -H "Accept: text/markdown" https://idolinfohub.com/events

5. 命令列工具 — the CLI

npx idolinfohub events --upcoming
```

JSON API (v1)

Base URL: https://idolinfohub.com/api/v1

Endpoint	說明 Description
/index.json	API 索引、資料筆數與所有端點
/openapi.json	OpenAPI 3.1 規格
/events.json	所有活動摘要
/events/{slug}.json	單一活動（時間表、票價、陣容、場地）
/performers.json	所有表演者摘要（團體與個人）
/performers/{slug}.json	單一表演者（社群連結、所屬團體、近期演出）
/hosts.json	所有主辦單位摘要
/hosts/{slug}.json	單一主辦單位
/venues.json	所有場地
/venues/{slug}.json	單一場地

回應為 UTF-8 JSON，集合端點使用 { self, generatedAt, count, items } 信封格式。找不到的路徑會回傳 HTTP 404（JSON 錯誤內容），不會回傳 200。

Markdown content negotiation

任何內容頁面都可用 Accept: text/markdown 取得純文字版本，或直接在網址後加上 .md：

```bash
curl -H "Accept: text/markdown" https://idolinfohub.com/performers
curl https://idolinfohub.com/events.md
```

回應含 Content-Type: text/markdown; charset=utf-8 與 Vary: Accept；HTML 回應則帶 Link: <….md>; rel="alternate"; type="text/markdown"。

MCP server

項目	值
Endpoint	https://idolinfohub.com/mcp
Transport	Streamable HTTP (JSON-RPC 2.0)
Protocol	2025-03-26
Auth	none
Server card	https://idolinfohub.com/.well-known/mcp/server-card.json

```json
{
"mcpServers": {
"idol-info-hub": { "type": "http", "url": "https://idolinfohub.com/mcp" }
}
}
```

CLI

```bash
npx idolinfohub events --upcoming
npx idolinfohub event EVENT_SLUG
npx idolinfohub performers --type group --query mikan
npx idolinfohub search 生誕
npx idolinfohub venues --json
```

所有指令都支援 --json 輸出原始 JSON，方便串接管線；--base 或 IDOLINFOHUB_BASE_URL 可指向其他部署。原始碼位於 repo 的 packages/cli。

探索入口 Discovery

檔案 File	用途
/llms.txt	LLM 可讀的站台摘要
/sitemap.xml	全站網址索引
/robots.txt	爬蟲規則與 Content-Signal
/.well-known/api-catalog	RFC 9264 API linkset
/.well-known/mcp/server-card.json	MCP server card
/.well-known/agent-skills/index.json	Agent skills 索引
/auth.md	存取與驗證說明

使用限制與署名 Limits and attribution

• 靜態檔案由 Cloudflare CDN 提供，無硬性速率限制；請遵守回應中的 Cache-Control，並在 User-Agent 中標示您的用途。
• 資料每日隨活動更新重新產生；generatedAt 欄位標示產生時間。
• 內容可用於 AI 訓練、搜尋索引與生成式回答（ai-train=yes, search=yes, ai-input=yes），歡迎署名但非必要。

本網站資料搜集為人工＋半自動程式腳本定期更新及抓取，所有資料請以各活動主辦、營運方、場地方、表演團體最新公告為準。