Telegram-MCP/integrat.yaml at main · plagness/Telegram-MCP · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
# yaml-language-server: $schema=https://raw.githubusercontent.com/plagness/Integrat/main/spec/integrat.schema.json
# Integrat — плагин telegram-chat-data
# Полные данные из Telegram-чатов: участники, сообщения, реакции, события, статистика

plugin:
  slug: telegram-chat-data
  name: Telegram Chat Data
  description: "Полные данные из Telegram-чатов: участники, сообщения, реакции, события, статистика"
  version: "2026.02.23"
  icon: "💬"
  homepage: https://github.com/plagness/Telegram-MCP

provider:
  base_url: "${TELEGRAM_API_URL:-http://tgapi-service.ns-telegram.svc.cluster.local:8081}"
  health_path: /health

endpoints:
  - slug: chat.info
    name: "Информация о чате"
    description: "Метаданные чата: название, описание, количество участников, аватарка, Hub-настройки"
    path: /v1/chat-data/{chat_id}/info
    method: GET
    access: gated
    cache_ttl: 300
    data_type: basic
    params_schema:
      type: object
      properties:
        chat_id:
          type: string
          description: "Telegram chat ID"
      required: [chat_id]

  - slug: chat.members
    name: "Участники чата"
    description: "Список известных участников с профилями, статусами, аватарками"
    path: /v1/chat-data/{chat_id}/members
    method: GET
    access: gated
    cache_ttl: 120
    data_type: medium
    params_schema:
      type: object
      properties:
        chat_id:
          type: string
          description: "Telegram chat ID"
        limit:
          type: integer
          minimum: 1
          maximum: 500
          default: 100
        offset:
          type: integer
          default: 0
        status:
          type: string
          description: "Фильтр: member, administrator, creator, left, kicked"
        search:
          type: string
          description: "Поиск по username или имени"
      required: [chat_id]

  - slug: chat.messages
    name: "Сообщения чата"
    description: "Сообщения с фильтрацией по дате, автору, типу медиа, текстовому поиску"
    path: /v1/chat-data/{chat_id}/messages
    method: GET
    access: gated
    cache_ttl: 60
    data_type: complex
    params_schema:
      type: object
      properties:
        chat_id:
          type: string
        limit:
          type: integer
          minimum: 1
          maximum: 500
          default: 100
        offset:
          type: integer
          default: 0
        date_from:
          type: string
          description: "ISO date/datetime начала"
        date_to:
          type: string
          description: "ISO date/datetime конца"
        user_id:
          type: string
          description: "Фильтр по автору"
        media_type:
          type: string
          description: "photo, video, document, audio, voice, sticker..."
        search:
          type: string
          description: "Текстовый поиск (ILIKE)"
      required: [chat_id]

  - slug: chat.reactions
    name: "Реакции чата"
    description: "Реакции на сообщения с агрегацией по типу"
    path: /v1/chat-data/{chat_id}/reactions
    method: GET
    access: gated
    cache_ttl: 120
    data_type: medium
    params_schema:
      type: object
      properties:
        chat_id:
          type: string
        telegram_message_id:
          type: integer
          description: "Фильтр по конкретному сообщению"
        user_id:
          type: string
        aggregate:
          type: boolean
          default: true
          description: "Добавить группировку по типу реакции"
        limit:
          type: integer
          default: 100
        offset:
          type: integer
          default: 0
      required: [chat_id]

  - slug: chat.events
    name: "События чата"
    description: "Лог системных событий: вступления, выходы, закрепления, смена фото/названия"
    path: /v1/chat-data/{chat_id}/events
    method: GET
    access: gated
    cache_ttl: 60
    data_type: medium
    params_schema:
      type: object
      properties:
        chat_id:
          type: string
        event_type:
          type: string
          description: "Фильтр: join, leave, kick, pin, unpin, new_photo, delete_photo, title_change, migrate"
        date_from:
          type: string
        date_to:
          type: string
        user_id:
          type: string
        limit:
          type: integer
          default: 100
        offset:
          type: integer
          default: 0
      required: [chat_id]

  - slug: chat.stats
    name: "Статистика чата"
    description: "Агрегированная статистика: активность по дням, топ авторы, распределение медиа, тренды"
    path: /v1/chat-data/{chat_id}/stats
    method: GET
    access: gated
    cache_ttl: 300
    data_type: complex
    params_schema:
      type: object
      properties:
        chat_id:
          type: string
        period:
          type: string
          description: "7d, 30d, 90d, all"
          default: "30d"
      required: [chat_id]

config_fields:
  - slug: default_chat_id
    label: "Chat ID по умолчанию"
    type: string
    required: false
    help: "ID чата для запросов без явного chat_id"

  - slug: sync_on_subscribe
    label: "Синхронизация при подписке"
    type: boolean
    required: false
    default: true
    help: "Автоматически синхронизировать данные чата при первом подключении плагина"