Tg Search

Search public Telegram channels and groups by keyword, returning up to 50 matching results as JSON using an authorized Telethon session.

Audits

Pending

Install

openclaw skills install tg-search

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.