# Tg Search

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

- Skill: `modbender/tg-search` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add modbender/tg-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/tg-search/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/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.