SKILL.md

# tg_search

Search public Telegram channels and groups by keyword using an already-authorized Telethon session on this VPS.

## What it does
- Runs global Telegram search for public channels/groups matching a query
- Returns up to `limit` results as JSON

## Command executed
`/usr/local/bin/tg_search "<query>" <limit>`

## Inputs
- query (string, required): e.g. "crypto", "здоровье", "ai agents"
- limit (int, optional, default 10, max 50)

## Output (JSON)
[
  { "type": "channel|group", "title": "...", "username": "...", "id": 123456789 },
  ...
]

## Notes / limitations
- Only public channels/groups discoverable by Telegram search.
- No access to private groups/chats without an invite.
- `username` can be null if there is no public @username.