{
  "name": "This Week in NET",
  "version": "1.0.0",
  "description": "This Week in NET (TWiN) is a weekly video and podcast show covering Internet trends, AI, security, and technology, hosted by João Tomé and produced by Cloudflare. Agents can discover and retrieve episode data, search episodes, and access show information.",
  "url": "https://thisweekinnet.com",
  "supportedInterfaces": [
    {
      "type": "http",
      "url": "https://twin-popular-api.joaotome.workers.dev",
      "transport": "HTTP/REST"
    }
  ],
  "capabilities": {
    "search": true,
    "streaming": false,
    "authentication": false
  },
  "skills": [
    {
      "id": "get-latest-episodes",
      "name": "Get Latest Episodes",
      "description": "Retrieve the most recently published TWiN episodes sorted by publish date",
      "input": {
        "type": "object",
        "properties": {
          "limit": {
            "type": "integer",
            "description": "Number of episodes to return (default 10, max 100)"
          }
        }
      },
      "output": {
        "type": "array",
        "description": "Array of episode objects with id, title, publishedAt, url, thumb, views"
      },
      "examples": [
        {
          "input": { "limit": 5 },
          "endpoint": "GET https://twin-popular-api.joaotome.workers.dev/latest?limit=5"
        }
      ]
    },
    {
      "id": "get-popular-episodes",
      "name": "Get Most Popular Episodes",
      "description": "Retrieve the most-viewed TWiN episodes sorted by view count",
      "input": {
        "type": "object",
        "properties": {
          "limit": {
            "type": "integer",
            "description": "Number of episodes to return (default 25, max 100)"
          }
        }
      },
      "output": {
        "type": "array",
        "description": "Array of episode objects sorted by view count descending"
      },
      "examples": [
        {
          "input": { "limit": 10 },
          "endpoint": "GET https://twin-popular-api.joaotome.workers.dev/latest?limit=10"
        }
      ]
    },
    {
      "id": "search-episodes",
      "name": "Search Episodes",
      "description": "Full-text search across all TWiN episode titles",
      "input": {
        "type": "object",
        "properties": {
          "q": {
            "type": "string",
            "description": "Search query string"
          },
          "limit": {
            "type": "integer",
            "description": "Max results (default 10)"
          }
        },
        "required": ["q"]
      },
      "output": {
        "type": "object",
        "description": "Object with `results` array of matching episodes"
      },
      "examples": [
        {
          "input": { "q": "DDoS security", "limit": 5 },
          "endpoint": "GET https://twin-popular-api.joaotome.workers.dev/search?q=DDoS+security&limit=5"
        }
      ]
    }
  ],
  "contact": {
    "email": "thisweekinnet@cloudflare.com",
    "url": "https://joaotome.com"
  },
  "provider": {
    "name": "Cloudflare",
    "url": "https://www.cloudflare.com"
  }
}