{
  "openapi": "3.1.0",
  "info": {
    "title": "ShowBuild Agent API",
    "version": "1.0.0",
    "description": "Machine-readable API, endpoints, and specifications for AI agents (Grok bot, Hermes, OpenClaw, Meta Muse, OpenAI Dots, Claude Duet, Gemini Sparks) to discover, inspect, search, and submit indie maker products to ShowBuild."
  },
  "servers": [
    {
      "url": "https://showbuild.co",
      "description": "Production server"
    }
  ],
  "paths": {
    "/?submit=1": {
      "get": {
        "summary": "Generate a pre-filled submission link for 1-click launch",
        "description": "AI agents can construct this URL to launch a pre-filled submission form on ShowBuild. When the user or agent visits the URL, the title, tagline, description, category, and preview are pre-populated automatically.",
        "parameters": [
          {
            "name": "submit",
            "in": "query",
            "required": true,
            "schema": { "type": "string", "enum": ["1"] },
            "description": "Must be set to 1 to trigger the submission modal."
          },
          {
            "name": "url",
            "in": "query",
            "required": true,
            "schema": { "type": "string", "format": "uri" },
            "description": "The product website URL to submit (e.g. https://myproject.com)."
          },
          {
            "name": "title",
            "in": "query",
            "required": false,
            "schema": { "type": "string" },
            "description": "The name of the product or application."
          },
          {
            "name": "tagline",
            "in": "query",
            "required": false,
            "schema": { "type": "string" },
            "description": "A concise one-liner under 100 characters describing what the product does."
          },
          {
            "name": "description",
            "in": "query",
            "required": false,
            "schema": { "type": "string" },
            "description": "Detailed description of the product, key features, and problem solved."
          },
          {
            "name": "tag",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": ["marketing", "development", "design", "for sale", "personal life", "business"]
            },
            "description": "The product category on ShowBuild."
          }
        ],
        "responses": {
          "200": {
            "description": "Opens the ShowBuild board with the submission modal pre-filled and ready for 1-click confirmation."
          }
        }
      }
    },
    "/api/md/_catalog": {
      "get": {
        "summary": "Get JSON catalog of all markdown routes",
        "description": "Returns a machine-readable JSON list of all available pages, categories, builds, and guides rendered in clean Markdown.",
        "responses": {
          "200": {
            "description": "JSON catalog object containing route metadata and count.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "site": { "type": "string" },
                    "origin": { "type": "string" },
                    "total": { "type": "integer" },
                    "routes": { "type": "array" }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/builds/{slug}.md": {
      "get": {
        "summary": "Fetch build specifications in Markdown",
        "description": "Returns full product specifications, quick take, target audience, pricing model, tech stack, and community comments in clean Markdown.",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": { "type": "string" },
            "description": "The unique slug of the build."
          }
        ],
        "responses": {
          "200": {
            "description": "Clean markdown document of the build showcase.",
            "content": {
              "text/markdown": {
                "schema": { "type": "string" }
              }
            }
          }
        }
      }
    },
    "/categories/{slug}.md": {
      "get": {
        "summary": "Fetch category overview and top tools in Markdown",
        "description": "Returns category comparison table, full list of builds, and category FAQs in clean Markdown.",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": ["marketing", "development", "design", "for-sale", "personal-life", "business"]
            },
            "description": "Category slug."
          }
        ],
        "responses": {
          "200": {
            "description": "Clean markdown document of the category.",
            "content": {
              "text/markdown": {
                "schema": { "type": "string" }
              }
            }
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "summary": "LLM Site Index",
        "description": "Standard llmstxt.org index file pointing to markdown resources.",
        "responses": {
          "200": {
            "description": "Plaintext LLM index."
          }
        }
      }
    },
    "/llms-full.txt": {
      "get": {
        "summary": "Full LLM Corpus",
        "description": "Concatenated full-content markdown corpus covering all core pages, top builds, categories, and guides.",
        "responses": {
          "200": {
            "description": "Plaintext LLM full corpus."
          }
        }
      }
    },
    "/.well-known/mcp.json": {
      "get": {
        "summary": "Model Context Protocol Tool Manifest",
        "description": "Tool definitions for Model Context Protocol (MCP) clients like Claude Desktop, Cursor, and Hermes.",
        "responses": {
          "200": {
            "description": "MCP tool manifest JSON."
          }
        }
      }
    }
  }
}
