telegram-ads

ads.telegram.org용 에이전트 플러그인: 타입이 지정된 도구, Playwright 로그인, 읽기 전용 watcher.

에이전트에게 git URL을 주세요. 스스로 설치됩니다. MCP 서버를 호스팅하지 않습니다.

MCP는 로컬입니다

MCP 진입점은 에이전트가 시작하는 stdio 자식 프로세스입니다:

agent  --stdin/stdout JSON-RPC-->  python -m hermes_telegram_ads.mcp

공개 포트도, VPS 데몬도, 유지할 URL도 없습니다. Chromium은 에이전트와 같은 머신에서 실행됩니다. Playwright MCP와 동일한 규칙입니다.

Related MCP server: OpenAI Ads MCP

설치

Hermes Agent

hermes plugins install https://github.com/sh0tn1k/telegram-ads.git --enable

그런 다음 after-install.md를 따르세요 (venv pip, playwright install chromium, TELEGRAM_ADS_PHONE, 게이트웨이 재시작, telegram_ads_login_from_env + Telegram에서 수락).

읽기 전용 watcher가 채팅을 깨울 수 있도록 watcher inject를 허용하세요:

plugins:
  entries:
    telegram-ads:
      allow_gateway_injection: true

Claude Code

/plugin marketplace add https://github.com/sh0tn1k/telegram-ads.git
/plugin install telegram-ads@telegram-ads

환경에 TELEGRAM_ADS_PHONE을 설정하세요. 첫 번째 변경 호출은 Claude Code 자체 권한 프롬프트를 사용합니다 (Hermes의 한 번/세션/항상 카드는 Hermes에만 있습니다).

기타 MCP 에이전트 (Cursor, …)

pip install -e '.[mcp]'
python -m playwright install chromium

에이전트가 이 체크아웃을 가리키게 하세요:

{
  "mcpServers": {
    "telegram-ads": {
      "command": "python",
      "args": ["-m", "hermes_telegram_ads.mcp"]
    }
  }
}

첫 로그인 (모든 호스트)

1. 호스트 환경에 TELEGRAM_ADS_PHONE을 설정하세요 (git에는 절대 넣지 마세요).

2. telegram_ads_login_from_env를 호출하세요.

3. Telegram 앱에서 수락을 탭하세요.

4. 쿠키는 영구 Chromium 프로필에 유지됩니다 (TELEGRAM_ADS_HOME, 또는 Hermes가 있으면 ~/.hermes/data/telegram_ads, 그 외에는 ~/.telegram-ads).

안전

• 변경 작업은 호스트 승인이 필요합니다 (Hermes의 한 번/세션/항상/거부, 또는 MCP 클라이언트의 권한 UI). "yes"를 입력하여 확인하지 마세요.

• Watcher는 읽기 전용입니다. 동일한 Ads 프로필에서 두 번째 Playwright를 시작하지 마세요.

• 두 번째 Telegram getUpdates 폴러를 시작하지 마세요. 이 플러그인은 호스트 봇을 재사용합니다.

• hermes serve / MCP HTTP를 0.0.0.0에 바인딩하지 마세요.

이 플러그인에 포함되지 않는 것

Telegram 리서치(Telethon), GrokBot 아이덴티티, 채널 포트폴리오, /sessions. 이러한 것들은 운영자 호스트에 유지됩니다.

라이선스

MIT