Skip to content

News

Service overview · CLI reference · MCP reference

Browse NTU news, filter by category or search published articles. Try ntu news search "artificial intelligence".

Service notes

Read-only tools for NTU's public news listing and article pages. No credentials or Chromium required.

Requests and limitations

All results include retrieved_at, source_url, and cached. Responses are cached in memory for five minutes; refresh: true fetches them again. The shared public HTTP client pools connections, bounds responses to 8 MB, uses a 20-second timeout, and permits up to two in-flight requests per client with 250 ms default pacing. Public HTTP settings are documented in the shared runtime guide. Published news may be corrected or removed; cached results are snapshots.

Sources

  • NTU news page supplies category labels and IDs, plus the supported sort values.
  • GetStories returns story cards and pagination. Verified parameters: categories, page, listingKeyword, and sort.
  • Article URLs returned by the API supply the full published HTML text.

Tests

Run from the repository root:

uv run python -m unittest discover -s tests/news -t . -v
uv run python -m tests.news.live_smoke

Offline tests use synthetic stories, category forms, and article markup. The opt-in live stdio smoke checks keyword search, categories, pagination, oldest-first ordering, empty results, current and older article text, chunking, and caching. It prints statuses without saving article bodies.