# MetaGazette

> Multilingual digital news publication. Not a shop. Articles are free to read. No product price, SKU, GTIN, warehouse stock or checkout.

This is the expanded companion to `/llms.txt`. Use the live language catalog at `/llms.txt` for current headlines. This file documents how to consume the site as an agent.

## Editions

- [English](https://en.metagazette.com/): Breaking news, politics, technology and world affairs
- [Turkish](https://tr.metagazette.com/): Son dakika, siyaset, teknoloji ve dünya haberleri
- [German](https://de.metagazette.com/): Nachrichten, Politik, Technologie und Weltgeschehen
- [Spanish](https://es.metagazette.com/): Noticias, política, tecnología y asuntos internacionales
- [Arabic](https://ar.metagazette.com/): أخبار عاجلة، سياسة، تكنولوجيا وشؤون عالمية

Reciprocal hreflang: `en`, `tr`, `de`, `es`, `ar`, `x-default` → English.

## JavaScript-free content

The public web app is a React SPA. Agents that do not run JavaScript should:

1. Read this file and `/llms.txt`
2. Fetch article Markdown at `/article/{slug}.md`
3. Or call the JSON API below

Homepage HTML still includes Organization JSON-LD, Open Graph, hreflang and a noscript summary (name, description, price=none, availability=online publication).

## Public JSON API (function-calling shape)

Base URL: `https://api.metagazette.com` or same-origin `/api`.

No authentication for read endpoints.

### Article object

```json
{
  "id": "uuid",
  "slug": "string",
  "title": "string",
  "summary": "string",
  "content": "string",
  "coverImageUrl": "string|null",
  "authorName": "string",
  "publishedAtUtc": "ISO-8601",
  "updatedAtUtc": "ISO-8601",
  "categories": [{ "id": "uuid", "name": "string", "slug": "string" }],
  "tags": [{ "id": "uuid", "name": "string", "slug": "string" }]
}
```

Fields that **do not exist** and must not be invented: `price`, `priceCurrency`, `availability`, `sku`, `gtin13`, `mpn`, `aggregateRating`, `review`.

### Endpoints

- `GET /api/languages`
- `GET /api/categories?languageCode=tr`
- `GET /api/tags?languageCode=tr`
- `GET /api/articles?languageCode=tr&take=20`
- `GET /api/articles/{slug}?languageCode=tr`
- `GET /api/homepage?languageCode=tr`
- `GET /health`

Full OpenAPI: `/openapi.json`

## Structured data

JSON-LD types in use: NewsMediaOrganization, WebSite, NewsArticle, BreadcrumbList, FAQPage.

Organization `sameAs` (when configured): Facebook, X, LinkedIn. Wikidata and Crunchbase are **not** linked because those entity pages are not published by MetaGazette in this source.

`vatID` / `taxID`: **missing** — imprint HTML still uses unpublished placeholders. Do not fabricate a tax number.

Product / Offer schema: **not used**. This is a news site, not a product catalog. Availability enums such as `in_stock` apply to commerce Offer, not to journalism.

## Fit

Suitable for: news reading, citations, language-specific coverage.

Not suitable for: comparison shopping, inventory, medical instructions, investment advice, treating comments as verified product reviews.

## Other agent files

- /AGENTS.md
- /skill.md
- /openapi.json
- /.well-known/mcp.json (MCP evaluated, not deployed)
- /.well-known/ai-plugin.json (ChatGPT plugin store not used; OpenAPI is the interface)
- /robots.txt (explicit allow for GPTBot, ClaudeBot, Claude-SearchBot, PerplexityBot, Amazonbot, Applebot-Extended, Bytespider, CCBot)

## Measurement

GA4: G-836FV3LBQJ after cookie consent. AI channel-group recipe: /ga4-ai-channel-group.json (must be applied in GA4 Admin).

Meta Pixel and Conversions API: not installed; a real Pixel ID and server CAPI access are required.