# 面向 AI 智能体的新闻、漏洞与政府文件门户 / Agent-Readiness Directory

本门户提供以下资源：

- **新闻** — 摘要、英文翻译、实体和相关文章
- **CVE 与漏洞公告** — 软件包和操作系统漏洞信息索引
- **政府文件** — 日本政府机关、美国 Federal Register 以及欧盟（EUR-Lex、欧盟委员会）的文件，并保留来源信息
- **Agent-Readiness Directory** — 评估其他网站对 llms.txt、MCP 和 API catalog 的支持程度

每个项目公开的正文和摘要范围由其 `license_note` 决定。

## 通过 MCP 连接

Remote MCP 端点使用 streamable HTTP。请先调用 `portal_list` 查看摘要和实体，再仅对需要的项目调用 `portal_get`。政府文件可通过 `portal_list_government` 按国家、机构和文件类型筛选。

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

## 全文搜索（BM25）

无需认证即可使用只读端点 `GET /api/search?q=<关键词>`。该端点使用 SQLite FTS5 加权 BM25，搜索标题、原文摘要、英文摘要以及允许再分发的正文。

- 参数：`q`（必填）、`category`、`status`、`source`、`lang`、`limit`（默认20，最大100）、`offset`、`mode`（默认 `bm25`；`index` 为旧版子字符串匹配）
- 请按 `rank` 而非 `score` 排序；区分度低的词即使匹配，分数也可能为零
- MCP 的 `portal_search` 使用同一索引
- 请遵守响应中的 `RateLimit` 和 `RateLimit-Policy` 标头

非 ASCII 查询文本必须进行百分号编码。大多数 HTTP 客户端会自动处理。

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

## 发现入口

- 带分类摘要的门户地图：`/llms.txt`
- 按 `license_note` 合并的公开内容：`/llms-full.txt`
- Agent-Readiness Directory：`/directory.md`
- 站点地图：`/sitemap.xml`
- 抓取政策与 Content Signals：`/robots.txt`
- AI 使用政策：`/ai.txt`
- MCP Server Card：`/.well-known/mcp/server-card.json`
- API catalog：`/.well-known/api-catalog`
- Agent Plugin 公开仓库：[chinng-inta/portal4agents-plugin](https://github.com/chinng-inta/portal4agents-plugin)

新闻的规范 Markdown URL 使用 `/news/...`，漏洞使用 `/security/...`，政府文件使用 `/government/{country}/YYYY/MM/DD/{id}.md`。

## 政策

- [隐私政策](/zh-cn/privacy.md)
- [使用条款](/zh-cn/terms.md)

## 按分类合并的文件

### 新闻

- [商业 (`business.md`)](/feeds/news/business.md)
- [地区 (`local.md`)](/feeds/news/local.md)
- [灾害 (`disaster.md`)](/feeds/news/disaster.md)
- [政治 (`politics.md`)](/feeds/news/politics.md)
- [日本国内 (`domestic.md`)](/feeds/news/domestic.md)
- [科学 (`science.md`)](/feeds/news/science.md)
- [娱乐 (`entertainment.md`)](/feeds/news/entertainment.md)
- [体育 (`sports.md`)](/feeds/news/sports.md)
- [综合 (`general.md`)](/feeds/news/general.md)
- [技术 (`tech.md`)](/feeds/news/tech.md)
- [健康 (`health.md`)](/feeds/news/health.md)
- [国际 (`world.md`)](/feeds/news/world.md)
- [生活 (`life.md`)](/feeds/news/life.md)

### 漏洞

- [软件库 (`library.md`)](/feeds/security/library.md)
- [操作系统 (`os.md`)](/feeds/security/os.md)

### 政府文件

- [日本 (`jp.md`)](/feeds/government/jp.md)
- [美国 (`us.md`)](/feeds/government/us.md)
- [欧盟 (`eu.md`)](/feeds/government/eu.md)

### Agent-Readiness

- [网站列表 (`site.md`)](/feeds/site.md)

语言：[日本語](/?lang=ja) / [English](/en-us/) / 简体中文