Chinng AI-Agent Portal

Return only articles whose existing content_hash changed and were republished.

New article creation and asynchronous enrichment changes are excluded. Save next_cursor and pass it on the next poll for stable, token-light incremental retrieval.

Fetch a full article by id.

The body/summary returned is gated by license_note:

• full (default): body included

• summary-only: no body, summary (summary/summary_en) present

• link-only: link and metadata only, no summary or body

Args: id: article id (e.g. "news-20260702-4c769f") include_body: false to return metadata only, omitting the body (even when license is full)

Returns: The article's full metadata + body (body_policy states which policy was applied). Returns {error: "not_found", id} if the article does not exist.

Fetch one website's full Agent-Readiness assessment by domain.

Args: domain: the site's domain (e.g. "example.com"). Normalized (scheme/path/case stripped).

Returns: domain, score (0-100 overall), level, level_label, categories[] (per-category pct with passed/failed/neutral check ids), checks[] (every verified check with its HTTP status and byte size), llms_txt_url / llms_full_txt_url, discovered_via and first_seen_at / checked_at / updated_at timestamps. Returns {error: "not_found", domain} if the domain has not been scanned.

List item metadata (no body, token-light).

Two content families are distinguished by category prefix:

• news articles: category="news" (or narrower, e.g. "news/world")

• CVE/vulnerability advisories: category="security" (or "security/library" / "security/os" / "security/app") Omit category to list both together.

Args: category: category prefix match. e.g. "news" matches all news/*, "security" matches all CVE, "news/world" narrows it status: filter by ingested/processed/enriched/published (all if omitted) source: feed identifier. e.g. "ghost-chinng-lab" lang: original language. e.g. "ja" since: lower bound on published_at (ISO 8601. e.g. "2026-07-01") until: upper bound on published_at (ISO 8601) q: title substring search limit: number of results (default 20, max 100) offset: paging start position

Returns: {total, count, limit, offset, items[]} — each item includes summary/summary_en/tags/ entities/related_auto/license_note plus summary_omitted_reason, redistribution, keywords_en, entities_en, topics_en and numeric_facts, but never the body.

List scanned websites by their AI-agent readiness (the Agent-Readiness directory).

A separate content family from news/CVE: each entry is a domain we actively scanned for agent-facing surfaces across five categories (Discoverability / Content / Bot Access Control / API-Auth-MCP-Skill / Commerce). Checks are graded like the Cloudflare Agent-Ready scanner: each category yields a percentage, and the overall score (0-100, Commerce excluded as informational) maps to Level 0-3 (0 Unprepared / 1 Agent-Curious / 2 Agent-Aware / 3 Agent-Native). Only scanned domains with results are listed.

Args: level: filter to a single readiness level (0-3) min_score: only surfaces with overall score (0-100) >= this value discovered_via: candidate source filter. e.g. "tranco" / "majestic" / "manual" sort: "score" (default, highest readiness first) or "recent" (recently changed first, for level-up tracking) limit: number of results (default 20, max 100) offset: paging start position

Returns: {total, count, limit, offset, items[]} — each item has domain, score (0-100), level, level_label, categories[] (per-category pct + pass/fail breakdown), checks[] (every check with its HTTP status), llms_txt_url, discovered_via and timestamps.

List official government documents without their Markdown bodies.

Use country (for example "us", "jp", or "eu") and source to narrow results. Federal Register document types include "Rule", "Proposed Rule", and "Notice"; Japanese RSS sources use their configured update class as document_type. EU sources cover EUR-Lex legislation and case-law (document_number carries the CELEX number) and European Commission press releases. Call portal_get for a selected id when its full portal record is needed.

Return the most retrieved portal pages.

Args: window: rolling window such as "24h", "7d", "30d" or "90d". category: optional category prefix such as "news" or "security". limit: number of results (default 10, max 100 on the analytics service).

BM25 full-text search over items (no body returned, token-light).

Ranked by weighted BM25 (SQLite FTS5) over the title, the original-language summary, the English summary, sentence-free English search signals and — for items whose license permits redistribution — the body. Japanese text is morphologically segmented at index time, so Japanese queries match words that a substring search would miss. Results carry score (0-1), rank and a snippet of the matching passage. Use portal_get to read a matched item's body.

Args: q: keyword(s). space-separated terms are ANDed. e.g. "openai gpt" category: category prefix match. e.g. "news" or "security" status: filter by ingested/processed/enriched/published (all if omitted) source: feed identifier. e.g. "ghost-chinng-lab" lang: original language. e.g. "ja" limit: number of results (default 20, max 100) offset: paging start position mode: "bm25" (default, relevance-ranked) or "index" (substring match, newest first)

Returns: {total, count, limit, offset, query, mode, total_is_capped, items[]} — same license-gated item shape as portal_list (summary/summary_en and snippet omitted for link-only, omission reason and search signals retained), never the body. In bm25 mode each item adds score / rank / snippet, and total is an estimate capped for cost. If the BM25 index is not usable the call transparently falls back to mode "index" and reports why in degraded_reason.