Svodka — Bulgarian News

Семантично търсене в агрегирани български новини от водещите издания (dnes.bg, news.bg, dariknews.bg, trud.bg, blitz.bg). Use for any question about current events, people, places, or topics in Bulgaria. Returns the most relevant summarized stories with their source outlets and canonical links. Queries work best in Bulgarian.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 2,
      "maxLength": 200,
      "description": "Search query, ideally in Bulgarian (e.g. 'магистрала Тракия', 'избори', 'НАП')"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "Maximum number of stories to return (default 10)"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Връща водещите новини за деня в България — an importance-ranked leaderboard of stories clustered across outlets. Use when asked what the top, leading, or breaking news in Bulgaria is right now. Each entry includes a short reason it is leading and how many outlets cover it.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12,
      "description": "Maximum number of leading stories to return (default 8)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Връща пълното резюме на конкретна новина по нейния числов идентификатор (id), заедно с всички източници. Use after search_bulgarian_news or get_leading_news to expand one story by the id shown in its link.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Numeric article id (from a search/leads result link, e.g. 1234 in /news/1234-...)"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Връща най-новите новини в хронологичен ред (newest first), with cursor pagination. Use to browse the latest headlines rather than search a specific topic.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30,
      "description": "How many stories to return (default 15)"
    },
    "cursor": {
      "type": "string",
      "description": "ISO timestamp from a previous call's nextCursor, to page to older stories"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}