# Taiwan Idol Hub

> Comprehensive information hub for Taiwan's idol live scene — event schedules, group and member profiles, venue pages, and host directories. Covers Taiwan-based idol groups with regular guest coverage of Japan and Hong Kong artists.

## Key sections

- Events (upcoming): https://idolinfohub.com/events
- Events (all, including past): https://idolinfohub.com/events/all
- Performers (groups & members): https://idolinfohub.com/performers
- Hosts (MC / host directory): https://idolinfohub.com/hosts
- Venues: https://idolinfohub.com/venues
- Developer portal: https://idolinfohub.com/developers
- Sitemap: https://idolinfohub.com/sitemap.xml

## About

idolinfohub.com is a fan-maintained, non-commercial reference site for the Taiwan idol live circuit. It tracks upcoming and past events, group/member profiles (stage names, social accounts, associated groups), and venue information. All data is community-curated and updated regularly.

## Markdown content negotiation

Key pages support `Accept: text/markdown` content negotiation. Send that header on a supported route and the server returns a clean Markdown file instead of HTML — useful for LLM pipelines that need structured text without parsing HTML.

Example:
```
GET /events/mini-mah-20260505
Accept: text/markdown
→ Content-Type: text/markdown; charset=utf-8
```

Static `.md` companions are directly fetchable by appending `.md` to supported routes:

| Route pattern | Example |
|---|---|
| `/` | `/index.md` |
| `/events` | `/events.md` |
| `/events/scheduled` | `/events/scheduled.md` |
| `/events/:slug` | `/events/mini-mah-20260505.md` |
| `/performers` | `/performers.md` |
| `/performers/group` | `/performers/group.md` |
| `/performers/member` | `/performers/member.md` |
| `/performers/:slug` | `/performers/yuusei_uranus.md` |
| `/hosts` | `/hosts.md` |
| `/hosts/:slug` | `/hosts/magic-idol-project.md` |
| `/events/all` | `/events/all.md` |
| `/venues` | `/venues.md` |
| `/developers` | `/developers.md` |

Unknown paths return a real HTTP 404 (never a 200 app shell) with a short
Markdown body linking back to the sitemap, this file and the developer portal.

## JSON API

A static, public, read-only JSON API is served from https://idolinfohub.com/api/v1/.
No API key, no registration, CORS open to every origin.

| Endpoint | Content |
|---|---|
| `/api/v1/index.json` | Discovery document: counts and every endpoint |
| `/api/v1/openapi.json` | OpenAPI 3.1 description |
| `/api/v1/events.json` | All events (summaries) |
| `/api/v1/events/{slug}.json` | One event: schedule, tickets, lineup, venues |
| `/api/v1/performers.json` | All performers (groups and members) |
| `/api/v1/performers/{slug}.json` | One performer: social links, members, appearances |
| `/api/v1/hosts.json` | All hosts |
| `/api/v1/hosts/{slug}.json` | One host and the events they organised |
| `/api/v1/venues.json` | All venues |
| `/api/v1/venues/{slug}.json` | One venue and the events held there |

Collection responses use a `{ self, generatedAt, count, items }` envelope.
Unknown `/api/` paths return HTTP 404 with a JSON error body.

## MCP server

- Endpoint: https://idolinfohub.com/mcp (Streamable HTTP, JSON-RPC 2.0, protocol 2025-03-26)
- Auth: none
- Server card: https://idolinfohub.com/.well-known/mcp/server-card.json

## CLI

`npx idolinfohub events --upcoming` — an official zero-dependency CLI wrapping
the endpoints above. `--json` on any command prints raw API JSON.
Docs: https://idolinfohub.com/developers

## Authentication

No authentication required. The site has no login system, no user accounts, and no protected APIs. All content and API endpoints are fully public and accessible without credentials, tokens, or API keys. See https://idolinfohub.com/developers for the full developer and agent documentation.

## AI usage policy

Content is freely available for AI training, search indexing, and AI-generated answers (ai-train=yes, search=yes, ai-input=yes). Attribution appreciated but not required.