AIエージェント向けニュース・脆弱性・政府文書ポータル / Agent-Readiness Directory
以下の機能を持っています。
- ニュース記事 — 要約・英訳・エンティティ・関連記事を付与
- CVE/脆弱性アドバイザリ — パッケージやOSの脆弱性情報を索引化
- 政府文書 — 日本の官庁・米Federal Register・EU(EUR-Lex・欧州委員会)をprovenance付きで提供
- Agent-Readiness Directory — 他サイトのllms.txt・MCP・API catalog対応度を採点
本文・要約の公開範囲は、記事ごとのlicense_noteに従います。
エージェントの接続方法
Remote MCP(streamable-http)を公開しています。まず portal_list で
要約・エンティティを見て取捨選択し、必要な記事だけ portal_get で取得してください。
政府文書は portal_list_government で国・機関・文書種別を指定できます。
# MCP エンドポイント
https://portal.chinng-lab-srv.dev/mcp
# クライアント登録例(非HTTPS の LAN では --allow-http を付与)
npx -y mcp-remote https://portal.chinng-lab-srv.dev/mcp --transport http-only
全文検索(BM25)
GET /api/search?q=<キーワード>(認証不要・読取専用)。SQLite FTS5 の
重み付き BM25 で、タイトル / 原文要約 / 英語要約 / 本文(再配布可能な記事のみ)を横断します。
日本語は索引時に形態素解析済みなので、部分一致では拾えない語も当たります
(「渋谷」で「東京都渋谷区」に命中)。
- パラメータ:
q(必須)/category/status/source/lang/limit(既定20・上限100)/offset/mode(bm25既定・indexで従来の部分一致) - 各ヒットに
score(0〜1)・rank(1起点)・snippetが付きます。 並べ替えはscoreではなくrankを使ってください — BM25 の性質上、識別力のない語ではscoreが 0 になるため、一致有無の判定には使えません - MCP からは
portal_searchが同じ索引を引きます(引数は JSON 文字列なのでエンコード不要) - レートリミットあり。成功時にも
RateLimit/RateLimit-Policyヘッダを 返すので、残量を見てペースを調整できます
日本語で引くときは q をパーセントエンコードしてください。
生の非 ASCII をリクエストラインに置くのは HTTP として不正で、
400 Invalid HTTP request received.(JSON ではない平文)が返ります。
通常の HTTP クライアントは自動でエンコードしますが、手打ちの curl はしません。
curl -sS -G --data-urlencode "q=脆弱性" --data-urlencode "limit=3" \
https://portal.chinng-lab-srv.dev/api/search
# 等価
https://portal.chinng-lab-srv.dev/api/search?q=%E8%84%86%E5%BC%B1%E6%80%A7&limit=3
ディスカバリ
- /llms.txt — カテゴリ別の入口地図(要約1行つき)
- /llms-full.txt — 公開記事を
license_noteで分岐して連結(自前=本文込み / 第三者=リンク+エンティティのみ) - /directory.md — Agent-Readiness ディレクトリ(他サイトのllms.txt/MCP/API catalog対応度スコア)
- /sitemap.xml — 公開記事の一覧
- /robots.txt — クロール方針(Content Signals)
- /ai.txt — コンテンツ利用・検索・RAG・要約・学習に関するAI利用方針
- /.well-known/mcp/server-card.json — MCP Server Card
- /.well-known/api-catalog — API catalog(RFC 9727 linkset)
- Agent Plugin 公開リポジトリ
ニュースは /news/...、脆弱性は /security/...、政府文書は
/government/{country}/YYYY/MM/DD/{id}.md のcanonical URLで
Markdownを直接取得できます(text/markdown)。
カテゴリ別統合ファイル
カテゴリごとの公開項目をまとめた Markdown です。巡回や一覧取得の入口として利用できます。