{
  "openapi": "3.1.0",
  "info": {
    "title": "zavod-stanki.ru API — Каменский станкостроительный завод",
    "description": "API для AI-агентов: поиск станков, характеристики, изображения, FAQ, заказы. Plan-Act-Check архитектура.",
    "version": "1.0.0",
    "x-aeo-score": "90%",
    "x-agent-flow": "initial_state → [plan → check] → desired_state"
  },
  "servers": [
    {
      "url": "https://zavod-stanki.ru",
      "description": "Production"
    }
  ],
  "x-mcp-servers": {
    "catalog": {
      "url": "https://zavod-stanki.ru/.well-known/mcp.json"
    }
  },
  "paths": {
    "/api/v1/machine-info": {
      "get": {
        "summary": "Поиск станков по названию",
        "description": "Plan-Act-Check: ACT — поиск в каталоге",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Поисковый запрос: модель, материал, размер"
          },
          {
            "name": "category",
            "in": "query",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Массив станков с id, name, price, image"
          }
        }
      }
    },
    "/api/v1/ai-meta/{id}": {
      "get": {
        "summary": "SSR-страница товара для AI-краулеров",
        "description": "Plan-Act-Check: CHECK — верификация данных. HTML с JSON-LD, OG, alt, BreadcrumbList",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "User-Agent",
            "in": "header",
            "schema": {
              "type": "string",
              "example": "ChatGPT-User"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "HTML страница с schema.org Product"
          }
        }
      }
    },
    "/api/v1/faq": {
      "get": {
        "summary": "FAQ с FAQPage JSON-LD",
        "description": "Plan-Act-Check: PLAN — получить ответы на вопросы клиента",
        "responses": {
          "200": {
            "description": "12 вопросов с FAQPage schema"
          }
        }
      }
    },
    "/api/v1/ai-images": {
      "get": {
        "summary": "Все изображения станков с alt и caption",
        "description": "Plan-Act-Check: ACT — найти изображения для ответа",
        "responses": {
          "200": {
            "description": "661 изображение с alt-тегами"
          }
        }
      }
    },
    "/api/v1/ai-changelog": {
      "get": {
        "summary": "История изменений для AI-агентов",
        "description": "Plan-Act-Check: PLAN — узнать что уже сделано",
        "responses": {
          "200": {
            "description": "16 entries"
          }
        }
      }
    },
    "/api/v1/ai-todo": {
      "get": {
        "summary": "TODO list для AI-агентов",
        "description": "Plan-Act-Check: PLAN — понять что нужно сделать",
        "responses": {
          "200": {
            "description": "17 done, 8 pending"
          }
        }
      }
    },
    "/api/v1/ai-tools": {
      "get": {
        "summary": "Manifest всех AI инструментов",
        "description": "Plan-Act-Check: PLAN — discovery доступных функций",
        "responses": {
          "200": {
            "description": "8 инструментов"
          }
        }
      }
    },
    "/.well-known/llms.txt": {
      "get": {
        "summary": "LLMs.txt — описание компании и каталога",
        "description": "Plan-Act-Check: PLAN — загрузить контекст о компании",
        "responses": {
          "200": {
            "description": "Каталог 50 станков + FAQ + контакты"
          }
        }
      }
    },
    "/image-sitemap.xml": {
      "get": {
        "summary": "Image sitemap — все изображения",
        "description": "Plan-Act-Check: ACT — найти изображения для ответа",
        "responses": {
          "200": {
            "description": "661 изображение"
          }
        }
      }
    }
  }
}