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.
This server cannot be deployed
Maintenance
ActivityStale
ResponsivenessNo recent community issues