{
  "openapi": "3.1.0",
  "info": {
    "title": "SCP-001 Residential Web-to-Markdown Oracle (x402)",
    "version": "1.0.0",
    "description": "Residential IP Web Extractor for AI Agents. Bypasses datacenter IP blocks and converts any webpage into clean LLM-ready Markdown + JSON-LD metadata. First 3 calls free, then x402 USDC on Base."
  },
  "servers": [
    {
      "url": "https://reader.cryptofolio.it"
    }
  ],
  "paths": {
    "/v1/extract": {
      "get": {
        "operationId": "extractWebpageResidential",
        "summary": "Extract clean Markdown and structured metadata from any URL via a genuine Residential IP",
        "parameters": [
          {
            "name": "url",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Full http/https URL of the webpage to read"
          }
        ],
        "responses": {
          "200": {
            "description": "Extracted Markdown and metadata"
          },
          "402": {
            "description": "x402 Payment Required (0.02 USDC on Base Mainnet)"
          }
        }
      }
    }
  }
}