# AI-Agent News, Vulnerability, and Government Document Portal / Agent-Readiness Directory

This portal provides the following resources:

- **News** — summaries, English translations, entities, and related items
- **CVE and vulnerability advisories** — indexed vulnerability information for packages and operating systems
- **Government documents** — documents from Japanese agencies, the U.S. Federal Register, and the EU (EUR-Lex and the European Commission), with provenance
- **Agent-Readiness Directory** — scores other websites' support for llms.txt, MCP, and API catalogs

The amount of article text or summary made available is controlled by each item's `license_note`.

## Connect through MCP

The Remote MCP endpoint uses streamable HTTP. Start with `portal_list` to review summaries and entities, then call `portal_get` only for the items you need. Use `portal_list_government` to filter government documents by country, organization, and document type.

- MCP endpoint: `https://portal.chinng-lab-srv.dev/mcp`
- MCP Server Card: `/.well-known/mcp/server-card.json`
- Agent Skills: `/.well-known/agent-skills/index.json`

## Full-text search (BM25)

Use `GET /api/search?q=<keyword>` without authentication. The read-only endpoint searches titles, original summaries, English summaries, and redistributable article text using weighted SQLite FTS5 BM25.

- Parameters: `q` (required), `category`, `status`, `source`, `lang`, `limit` (default 20, maximum 100), `offset`, and `mode` (`bm25` by default or `index` for legacy substring matching)
- Sort results by `rank`, not `score`; a non-discriminating term can produce a score of zero even when it matches
- `portal_search` exposes the same index through MCP
- Observe the `RateLimit` and `RateLimit-Policy` response headers

Encode non-ASCII query text. Most HTTP clients do this automatically.

```bash
curl -sS -G --data-urlencode "q=vulnerability" --data-urlencode "limit=3" \
  https://portal.chinng-lab-srv.dev/api/search
```

## Discovery

- Portal map with category summaries: `/llms.txt`
- Combined public content subject to `license_note`: `/llms-full.txt`
- Agent-Readiness Directory: `/directory.md`
- Sitemap: `/sitemap.xml`
- Crawling policy and Content Signals: `/robots.txt`
- AI use policy: `/ai.txt`
- MCP Server Card: `/.well-known/mcp/server-card.json`
- API catalog: `/.well-known/api-catalog`
- Agent Plugin repository: [chinng-inta/portal4agents-plugin](https://github.com/chinng-inta/portal4agents-plugin)

Canonical Markdown URLs use `/news/...` for news, `/security/...` for vulnerabilities, and `/government/{country}/YYYY/MM/DD/{id}.md` for government documents.

## Policies

- [Privacy Policy](/en-us/privacy.md)
- [Terms of Use](/en-us/terms.md)

## Combined category files

### News

- [Business (`business.md`)](/feeds/news/business.md)
- [Local (`local.md`)](/feeds/news/local.md)
- [Disaster (`disaster.md`)](/feeds/news/disaster.md)
- [Politics (`politics.md`)](/feeds/news/politics.md)
- [Domestic (`domestic.md`)](/feeds/news/domestic.md)
- [Science (`science.md`)](/feeds/news/science.md)
- [Entertainment (`entertainment.md`)](/feeds/news/entertainment.md)
- [Sports (`sports.md`)](/feeds/news/sports.md)
- [General (`general.md`)](/feeds/news/general.md)
- [Technology (`tech.md`)](/feeds/news/tech.md)
- [Health (`health.md`)](/feeds/news/health.md)
- [World (`world.md`)](/feeds/news/world.md)
- [Life (`life.md`)](/feeds/news/life.md)

### Vulnerabilities

- [Libraries (`library.md`)](/feeds/security/library.md)
- [Operating systems (`os.md`)](/feeds/security/os.md)

### Government documents

- [Japan (`jp.md`)](/feeds/government/jp.md)
- [United States (`us.md`)](/feeds/government/us.md)
- [European Union (`eu.md`)](/feeds/government/eu.md)

### Agent-Readiness

- [Sites (`site.md`)](/feeds/site.md)

Languages: [日本語](/?lang=ja) / English / [简体中文](/zh-cn/)