# NVNB API & Service Full Specification for AI Agents and Developers > Canonical URL: https://nvnb.blossomsarchive.com/ > Context document for AI models, autonomous agents, RAG engines, and automated security bots. ## 1. Overview NVNB (New Vulnerability Notification from BlossomsArchive) is a high-availability, real-time vulnerability aggregation platform designed to collect, index, and structure security alerts from official Japanese cybersecurity organizations. All endpoints are free to access without authentication, strictly read-only, and provide CORS headers allowing client-side calls. --- ## 2. Endpoints ### 2.1. REST API - **Endpoint**: `https://nvnb.blossomsarchive.com/api.php` - **HTTP Method**: `GET` - **Content-Type**: `application/json; charset=utf-8` - **Cache**: FastCGI edge-cached for 30–60 seconds. #### Request Parameters | Parameter | Type | Default | Max | Description | |:---|:---|:---|:---|:---| | `page` | integer | `1` | `1000` | Page number for pagination. | | `limit` | integer | `20` | `1000` | Number of items per page. On-demand ticker typically requests 100. | | `source` | string | `null` | - | Filter by provider ID: `ipa`, `jpcert`, `jvn`, `jvn-ipedia` (or `jvn_ipedia`), `nvnb`. | | `q` | string | `null` | 100 chars | Keyword search. Supports whitespace-separated multiple keywords (AND condition). Matches article title. | | `period` | string | `null` | - | Relative date filter: `24h`, `1w` (or `7d`), `1m` (or `30d`), `1y` (or `365d`), `custom`. | | `within24h`| integer| `0` | `1` | Shortcut flag for `period=24h`. Useful for breaking news and ticker feeds. | | `from` | string | `null` | `YYYY-MM-DD` | Start date when `period=custom`. | | `to` | string | `null` | `YYYY-MM-DD` | End date when `period=custom`. | #### Response Schema (JSON) ```json { "status": "success", "page": 1, "limit": 20, "total_count": 273, "total_pages": 14, "sources": [ { "source_id": "ipa", "source_name": "IPA" }, { "source_id": "jpcert", "source_name": "JPCERT/CC" }, { "source_id": "jvn", "source_name": "JVN" }, { "source_id": "jvn-ipedia", "source_name": "JVN iPedia" }, { "source_id": "nvnb", "source_name": "NVNB Original" } ], "data": [ { "guid": "unique-identifier-string", "source_id": "jvn-ipedia", "source_name": "JVN iPedia", "title": "Vulnerability Title", "link": "https://example.com/advisory-url", "pub_date": "2026-11-17 12:00:00" } ] } ``` --- ### 2.2. RSS 2.0 Feed - **Endpoint**: `https://nvnb.blossomsarchive.com/feed/` - **Optional Query**: `?source=` - **HTTP Method**: `GET` - **Content-Type**: `application/rss+xml; charset=utf-8` - **Content**: The 50 latest security alerts with sanitized CDATA and publication dates formatted in RFC 822 (`D, d M Y H:i:s O`). --- ## 3. Tool Calling / Function Calling Schema (for OpenAI / Anthropic / Gemini SDKs) ```json { "name": "search_vulnerabilities", "description": "Search cybersecurity vulnerability alerts in Japan from official authorities (JVN, IPA, JPCERT/CC, JVN iPedia, NVNB Original).", "parameters": { "type": "object", "properties": { "q": { "type": "string", "description": "Keywords to search in Japanese or English (e.g. 'Apache', 'WordPress', 'Windows'). Supports space-separated multiple keywords." }, "source": { "type": "string", "enum": ["ipa", "jpcert", "jvn", "jvn-ipedia", "nvnb"], "description": "Filter by official source authority." }, "period": { "type": "string", "enum": ["24h", "1w", "1m", "1y", "custom"], "description": "Filter advisories published within this timeframe." }, "within24h": { "type": "integer", "enum": [0, 1], "description": "Set to 1 to fetch recent advisories from the last 24 hours." }, "page": { "type": "integer", "default": 1, "description": "Page number (1-indexed)." }, "limit": { "type": "integer", "default": 20, "maximum": 1000, "description": "Number of advisories to retrieve per page." } } } } ``` --- ## 4. Code Examples ### cURL ```bash # Retrieve recent 24-hour vulnerabilities (up to 100) curl -s "https://nvnb.blossomsarchive.com/api.php?within24h=1&limit=100" # Search vulnerabilities related to "OpenSSL" curl -s "https://nvnb.blossomsarchive.com/api.php?q=OpenSSL&limit=20" ``` ### Python ```python import urllib.request import urllib.parse import json def fetch_nvnb_vulnerabilities(query=None, source=None, within24h=False, limit=20): params = {"limit": limit} if query: params["q"] = query if source: params["source"] = source if within24h: params["within24h"] = 1 url = f"https://nvnb.blossomsarchive.com/api.php?{urllib.parse.urlencode(params)}" req = urllib.request.Request(url, headers={"User-Agent": "NVNB-AI-Agent/1.0"}) with urllib.request.urlopen(req) as resp: return json.loads(resp.read().decode("utf-8")) # Example usage: data = fetch_nvnb_vulnerabilities(query="WordPress", limit=10) for item in data.get("data", []): print(f"[{item['source_name']}] {item['title']} -> {item['link']}") ``` --- ## 5. Security & Rate Limiting Guidelines - NVNB is a public security utility provided for the community. - Please respect edge caching (cache responses locally for at least 30 seconds). - All links are strictly validated against malicious URI schemes (`javascript:` etc. are stripped).