{
  "specVersion": "1.0",
  "host": {
    "displayName": "Fish.bg – онлайн магазин за риболовни принадлежности",
    "identifier": "https://fish.bg",
    "documentationUrl": "https://fish.bg/wp-json/",
    "logoUrl": "https://fish.bg/wp-content/uploads/2024/10/fishbg-logo.svg"
  },
  "entries": [
    {
      "identifier": "urn:air:fish.bg:api:store-products",
      "displayName": "Fish.bg – продуктов каталог (WooCommerce Store API)",
      "type": "application/json",
      "url": "https://fish.bg/wp-json/wc/store/v1/products",
      "description": "Публичен REST endpoint без аутентикация, само за четене. Връща продуктите на магазина: име, slug, SKU, кратко и пълно описание, наличност (is_in_stock, stock_availability), цени в EUR (prices, currency_minor_unit 2), категории, атрибути, изображения, рейтинг и постоянен линк. Поддържа параметрите search, category, tag, brand, attributes, min_price, max_price, on_sale, featured, stock_status, rating, sku, slug, orderby, order, page, per_page и offset. Отделен продукт се чете по числов идентификатор или по slug. ВАЖНО за този магазин: полето brands е празно и параметърът brand не връща резултати – марката се съхранява като продуктов атрибут pa_marka (\"Марка\"), затова филтриране по марка става с attributes[0][attribute]=pa_marka и attributes[0][slug][0]=<term-slug>. Параметърът tag също е без ефект, защото продуктови етикети не се използват. Страниците на продуктите носят и schema.org разметка – Product, Offer, Brand, BreadcrumbList и UnitPriceSpecification.",
      "tags": [
        "ecommerce",
        "fishing-tackle",
        "product-catalog",
        "bulgaria",
        "woocommerce"
      ],
      "capabilities": [
        "ProductSearch",
        "PriceLookup",
        "StockCheck",
        "CategoryFilter",
        "AttributeFilter",
        "SkuLookup"
      ],
      "representativeQueries": [
        "намери воблери за щука с цена под 20 евро",
        "има ли налични въдици за морски риболов",
        "колко струват блесните в български онлайн магазин за риболов",
        "покажи примамки за костур, които са на намаление",
        "провери наличността на кука по каталожен номер"
      ],
      "version": "1.0.0",
      "updatedAt": "2026-09-26T00:00:00Z",
      "metadata": {
        "currency": "EUR",
        "language": "bg-BG",
        "authentication": "none",
        "readOnly": true,
        "productCount": 10193,
        "topCategories": "Аксесоари; Примамки; Риби; Спининг риболов; Воблери; Блесни; Куки; Морски риболов; Влакна; Въдици",
        "singleProductBySlug": "https://fish.bg/wp-json/wc/store/v1/products/<slug>",
        "brandFilter": "attributes[0][attribute]=pa_marka&attributes[0][slug][0]=<term-slug>",
        "brandsTaxonomyEmpty": true,
        "tagsTaxonomyEmpty": true
      }
    },
    {
      "identifier": "urn:air:fish.bg:api:store-taxonomy",
      "displayName": "Fish.bg – категории и продуктови атрибути",
      "type": "application/json",
      "url": "https://fish.bg/wp-json/wc/store/v1/products/categories",
      "description": "Публични taxonomy endpoint-и на Store API, без аутентикация и само за четене, с които агент подрежда каталога преди да търси продукти. /products/categories връща плосък списък от 164 категории с полета id, name, slug, parent и count – по 100 на страница, така че е нужно листване по page. /products/attributes изброява петте използвани атрибута: pa_marka (\"Марка\", id 4), pa_czvyat (\"Цвят\", id 18), pa_vid-riba (\"Вид риба\", id 6), pa_vid-ribolov (\"Вид риболов\", id 5) и pa_aromat (\"Аромат\", id 23); термините се четат от /products/attributes/<id>/terms. Списъкът с марките в този магазин се взема от /products/attributes/4/terms, а не от /products/brands – този endpoint съществува, но връща празен масив, както и /products/tags. /products/collection-data връща агрегати за текущата селекция – ценови диапазон в EUR, брой по атрибут, брой по рейтинг и брой по наличност.",
      "tags": [
        "taxonomy",
        "faceted-search",
        "product-catalog",
        "woocommerce"
      ],
      "capabilities": [
        "CategoryList",
        "AttributeList",
        "AttributeTermList",
        "PriceRangeFacets"
      ],
      "representativeQueries": [
        "какви категории риболовни принадлежности се предлагат",
        "дай списък с марките, които се продават в магазина",
        "в кой раздел да търся принадлежности за фидер риболов",
        "какъв е ценовият диапазон на воблерите"
      ],
      "version": "1.0.0",
      "updatedAt": "2026-09-26T00:00:00Z",
      "metadata": {
        "authentication": "none",
        "readOnly": true,
        "categoryCount": 164,
        "categoriesPerPage": 100,
        "brandListEndpoint": "https://fish.bg/wp-json/wc/store/v1/products/attributes/4/terms",
        "relatedEndpoints": "/wp-json/wc/store/v1/products/attributes; /wp-json/wc/store/v1/products/attributes/<id>/terms; /wp-json/wc/store/v1/products/collection-data",
        "emptyEndpoints": "/wp-json/wc/store/v1/products/brands; /wp-json/wc/store/v1/products/tags"
      }
    },
    {
      "identifier": "urn:air:fish.bg:api:store-schema",
      "displayName": "Fish.bg – машинно четимо описание на Store API",
      "type": "application/json",
      "url": "https://fish.bg/wp-json/wc/store/v1",
      "description": "Индексът на namespace wc/store/v1. Изброява всички маршрути на Store API с позволените HTTP методи и пълния списък аргументи за всеки от тях, така че агент може да състави валидна заявка без предварително знание за магазина. Това не е OpenAPI документ, а собственият формат за описание на маршрути на WordPress REST API. Общият корен на откриването е https://fish.bg/wp-json/ с 48 регистрирани namespace-а.",
      "tags": [
        "api-discovery",
        "schema",
        "woocommerce",
        "wordpress"
      ],
      "capabilities": [
        "RouteDiscovery",
        "ParameterSchema"
      ],
      "representativeQueries": [
        "какви API маршрути предоставя магазинът fish.bg",
        "как да заявя продукти програмно от този сайт",
        "къде е описанието на параметрите на Store API"
      ],
      "version": "1.0.0",
      "updatedAt": "2026-09-26T00:00:00Z",
      "metadata": {
        "authentication": "none",
        "format": "WordPress REST API route index (not OpenAPI)",
        "discoveryRoot": "https://fish.bg/wp-json/"
      }
    },
    {
      "identifier": "urn:air:fish.bg:api:store-cart",
      "displayName": "Fish.bg – количка (WooCommerce Store API, изисква Nonce)",
      "type": "application/json",
      "url": "https://fish.bg/wp-json/wc/store/v1/cart",
      "description": "GET /cart е публичен и не изисква нищо. ВСИЧКИ променящи заявки обаче изискват хедър Nonce – без него отговорът е HTTP 401 woocommerce_rest_missing_nonce. Работният ред е: GET /cart, прочитане на хедърите Nonce, Nonce-Timestamp и Cart-Token от отговора, след което всяка следваща заявка носи Nonce и Cart-Token. Съществуващи маршрути: add-item, update-item, remove-item, items, apply-coupon, remove-coupon, coupons, select-shipping-rate, update-customer и checkout. Nonce-ът има ограничен срок на валидност и се подновява през нов GET /cart. Умишлено ограничение: магазинът НЕ поддържа агентски плащания – няма x402, ACP, UCP, MPP или друг протокол за плащане от агент, а GET /checkout също връща 401 без Nonce. Плащането се завършва от човек в браузъра, затова агент може да подготви количка и да предаде линк, но не може да плати.",
      "tags": [
        "cart",
        "ecommerce",
        "woocommerce"
      ],
      "capabilities": [
        "CartRead",
        "CartAdd",
        "CartUpdate",
        "CouponApply",
        "ShippingRates"
      ],
      "representativeQueries": [
        "добави този воблер в количката",
        "колко ще струва доставката на риболовна поръчка",
        "приложи код за отстъпка в кошницата",
        "покажи общата сума на моята количка"
      ],
      "version": "1.0.0",
      "updatedAt": "2026-09-26T00:00:00Z",
      "metadata": {
        "currency": "EUR",
        "authentication": "GET /cart: none. All writes and /checkout: Nonce header REQUIRED (401 woocommerce_rest_missing_nonce without it), plus Cart-Token for session continuity",
        "nonceSource": "Nonce and Cart-Token response headers on GET /wp-json/wc/store/v1/cart",
        "agenticPayments": "not supported",
        "paymentCompletion": "human in browser"
      }
    },
    {
      "identifier": "urn:air:fish.bg:api:wp-content",
      "displayName": "Fish.bg – редакционно съдържание (WordPress REST API)",
      "type": "application/json",
      "url": "https://fish.bg/wp-json/wp/v2/",
      "description": "Ядрото на WordPress REST API с публичен достъп за четене до /wp/v2/posts (460 публикации) и /wp/v2/pages (22 страници). Съдържанието е на български и обхваща видове риби, български водоеми и техния режим, сезонни тактики и кулинарни статии. Всеки запис връща заглавие, HTML съдържание, дата и постоянен линк. Поддържа search, categories, tags, per_page, page, orderby и _fields.",
      "tags": [
        "editorial",
        "articles",
        "fishing-knowledge",
        "bulgaria",
        "wordpress"
      ],
      "capabilities": [
        "ArticleSearch",
        "SpeciesInfo",
        "FishingSpotInfo",
        "SeasonalAdvice"
      ],
      "representativeQueries": [
        "каква риба се лови във Варненско езеро",
        "статия за риболов през октомври",
        "информация за вида сарпа в български води",
        "как се приготвя рибена чорба от улова"
      ],
      "version": "1.0.0",
      "updatedAt": "2026-09-26T00:00:00Z",
      "metadata": {
        "language": "bg-BG",
        "authentication": "none for reading",
        "readOnly": true,
        "postCount": 460,
        "pageCount": 22
      }
    },
    {
      "identifier": "urn:air:fish.bg:content:llms-txt",
      "displayName": "Fish.bg – llms.txt",
      "type": "text/plain",
      "url": "https://fish.bg/llms.txt",
      "description": "Пълен индекс на сайта за езикови модели, генериран от Rank Math SEO. Съдържа името на сайта, връзка към XML картата и анотирани списъци – заглавие, адрес и кратко резюме на български – в секции Публикации, Страници, Продукти, Категории продукти, Марка и Вид риболов. Преобладаващата част е продуктовият списък. Внимание за размера: файлът е около 3.6 MB и над 12 000 реда, затова за целеви заявки Store API е по-подходящ. Структурата е Markdown, но файлът се отдава с Content-Type text/plain; charset=utf-8, затова тук е обявен като text/plain.",
      "tags": [
        "llms-txt",
        "site-overview",
        "content-index"
      ],
      "capabilities": [
        "SiteOverview",
        "ContentIndex"
      ],
      "representativeQueries": [
        "обобщи какво съдържа сайтът fish.bg",
        "кои са основните статии и страници на магазина",
        "дай списък със статиите за риби и български водоеми"
      ],
      "version": "1.0.0",
      "updatedAt": "2026-09-26T00:00:00Z",
      "metadata": {
        "generator": "Rank Math SEO",
        "structure": "Markdown",
        "httpContentType": "text/plain; charset=utf-8",
        "language": "bg-BG",
        "approxSizeBytes": 3593691,
        "sections": "Sitemaps; Публикации; Страници; Продукти; Категории продукти; Марка; Вид риболов"
      }
    },
    {
      "identifier": "urn:air:fish.bg:content:sitemap",
      "displayName": "Fish.bg – XML карта на сайта",
      "type": "text/xml",
      "url": "https://fish.bg/sitemap_index.xml",
      "description": "Индекс по стандарта sitemaps.org с десет подкарти: post-sitemap.xml, page-sitemap.xml, product-sitemap1.xml и product-sitemap2.xml, category-sitemap.xml, product_cat-sitemap.xml и filters-sitemap1..4.xml. Изходната точка за пълно обхождане на индексируемото съдържание. Отдава се с Content-Type text/xml; charset=UTF-8.",
      "tags": [
        "sitemap",
        "crawling",
        "discovery"
      ],
      "capabilities": [
        "UrlDiscovery",
        "CrawlSeed"
      ],
      "representativeQueries": [
        "дай пълния списък с адреси на fish.bg",
        "кои страници на магазина са индексируеми",
        "намери картата на сайта за обхождане"
      ],
      "version": "1.0.0",
      "updatedAt": "2026-09-26T00:00:00Z",
      "metadata": {
        "standard": "sitemaps.org sitemapindex",
        "httpContentType": "text/xml; charset=UTF-8",
        "childSitemaps": 10
      }
    }
  ]
}