Skip to main content
Glama
telegram-ads-assistant

telegram-ads-assistant

by VKirill
README.md
# Telegram Ads Assistant

Telegram Ads Assistant combines a Chrome extension and local MCP tools for preparing, reading, and saving ads in an authenticated Telegram Ads cabinet. The repository also includes the `telegram-ads` agent skill for campaign planning, channel research, testing, and optimization.

The extension operates the cabinet through its page interface. Node.js runs the local bridge and MCP server; Python scripts support channel discovery and review exports. It is an independent tool and does not use a hosted service.

## Quick start

Install Node dependencies, start the local bridge, load this folder as an unpacked extension in Chrome, then open it from a Telegram Ads tab:

```sh
npm ci
npm start
```

Configure your MCP client to run `node` with the absolute path to `server/mcp.js`. The MCP process and local bridge run separately. See [Deployment](docs/deployment.md).

## Documentation

- [Overview](docs/overview.md)
- [Architecture](docs/architecture.md)
- [Cabinet operations and supported targets](docs/features/cabinet-operations.md)
- [Campaign method](docs/features/campaign-method.md)
- [Channel research](docs/features/channel-research.md)
- [MCP tools and HTTP routes](docs/api.md)
- [Local and research data](docs/data-model.md)
- [Deployment](docs/deployment.md)
- [Gotchas](docs/gotchas.md)
- [Decisions](docs/decisions.md)

See [VALIDATION.md](VALIDATION.md) for the package validation contract and [the example package](fixtures/example.json) for input shape.