id: feed_first_epss
name: FIRST EPSS Feed
version: 1.0.0
description: "FIRST EPSS (Exploit Prediction Scoring System) feed connector — pull the CVEs with the highest probability of being exploited in the next 30 days and emit normalized IOCs (CVE + type, with EPSS score and percentile) for import into the Threat Indicator Manager. Free public API, no authentication required; stdlib-only, no extra Python dependencies."
changelog: "1.0.0 — Initial release: fetch top-EPSS CVEs from the FIRST EPSS API."
category: feed

# The FIRST EPSS API is free and served over HTTPS. No key required.
config_schema:
  properties:
    min_epss:
      type: string
      description: "Optional: only return CVEs with EPSS score greater than this (0-1, e.g. 0.5)"
    insecure:
      type: boolean
      description: "Trust any TLS certificate (not secure)"
      default: false
  required: []

commands:
  - id: fetch_indicators
    name: feed-first-epss-fetch-indicators
    description: "Fetch top-EPSS CVEs and return normalized indicators."
    risk: read
    inputs_schema:
      properties:
        min_epss: { type: string, description: "Only CVEs with EPSS > this value (overrides config)" }
        max_indicators: { type: number, description: "Max indicators to return (default 100, max 1000)" }
      required: []
    outputs_schema: { properties: {} }

  - id: test_connection
    name: feed-first-epss-test-connection
    description: "Verify the FIRST EPSS API is reachable (used by the Test button)."
    risk: read
    inputs_schema:
      properties: {}
      required: []
    outputs_schema: { properties: {} }