{
  "openapi": "3.1.0",
  "info": {
    "title": "Aion Marketing — narzędzia agentowe",
    "version": "0.1.0",
    "description": "Publiczne, tylko-do-odczytu narzędzia Aion dla agentów. Każda odpowiedź to koperta z danymi, źródłami, datą i linkiem do strony (utm_source=agent).",
    "x-limits": {
      "per_hour_per_ip": 60,
      "per_day_per_tool": 1000,
      "visibility_per_day_per_ip": 3,
      "window": "sliding",
      "retry_after": "seconds",
      "on_exceeded": 429
    }
  },
  "servers": [
    {
      "url": "https://aion-marketing.pl"
    }
  ],
  "paths": {
    "/api/public/v1/check_bot_access/": {
      "post": {
        "operationId": "check_bot_access",
        "summary": "Dostęp botów AI do strony",
        "description": "Use when sprawdzasz widoczność strony dla botów AI — czy wyszukujące boty (OAI-SearchBot, Claude-SearchBot, PerplexityBot, Googlebot…) mają dostęp wg robots.txt, czy jest llms.txt i czy treść jest widoczna bez JS. Wystarczy adres: narzędzie pobiera robots.txt, llms.txt i stronę (3 żądania GET, ochrona przed adresami prywatnymi); wklejona treść ma pierwszeństwo. Zwraca werdykt per bot, sygnały treści i stan pobrania każdego pliku. NIE zbiera danych kontaktowych, NIE indeksuje, NIE zapisuje pobranej treści.",
        "tags": [
          "narzedzia"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "url": {
                    "type": "string",
                    "format": "uri",
                    "description": "Adres strony. Wystarczy sam adres — brakujące pliki pobieramy z niego."
                  },
                  "robots_txt": {
                    "type": "string",
                    "description": "Surowe robots.txt (opcjonalne; zastępuje pobranie)."
                  },
                  "llms_txt": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Surowe llms.txt (opcjonalne)."
                  },
                  "html": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "HTML strony głównej (opcjonalne) — sygnały SSR."
                  }
                },
                "required": []
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Koperta z danymi",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Envelope"
                }
              }
            }
          },
          "400": {
            "description": "Błędne wejście"
          },
          "429": {
            "description": "Przekroczony limit (nagłówek Retry-After)"
          }
        }
      },
      "get": {
        "operationId": "check_bot_access_descriptor",
        "summary": "Dostęp botów AI do strony — opis i schemat",
        "responses": {
          "200": {
            "description": "Opis narzędzia i JSON Schema wejścia"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Envelope": {
        "type": "object",
        "required": [
          "data",
          "sources",
          "as_of",
          "method_url",
          "human_url",
          "attribution",
          "limits"
        ],
        "properties": {
          "data": {},
          "sources": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "title": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "retrieved_at": {
                  "type": [
                    "string",
                    "null"
                  ]
                }
              }
            }
          },
          "as_of": {
            "type": "string",
            "format": "date-time"
          },
          "method_url": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "human_url": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri"
          },
          "attribution": {
            "type": "object",
            "required": [
              "text",
              "url"
            ],
            "properties": {
              "text": {
                "type": "string"
              },
              "url": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "uri"
              }
            }
          },
          "limits": {
            "type": [
              "object",
              "null"
            ]
          }
        }
      },
      "check_bot_access": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Adres strony. Wystarczy sam adres — brakujące pliki pobieramy z niego."
          },
          "robots_txt": {
            "type": "string",
            "description": "Surowe robots.txt (opcjonalne; zastępuje pobranie)."
          },
          "llms_txt": {
            "type": [
              "string",
              "null"
            ],
            "description": "Surowe llms.txt (opcjonalne)."
          },
          "html": {
            "type": [
              "string",
              "null"
            ],
            "description": "HTML strony głównej (opcjonalne) — sygnały SSR."
          }
        },
        "required": []
      }
    }
  },
  "x-tools": [
    "check_bot_access"
  ]
}