تخطَّ إلى المحتوى
TakoAPI
العودة إلى المهارات

telegram-history

بواسطة rhlsthrm

Browser & Automation
1.2kالتنزيلات وفق ما يذكره clawskills.sh
1النجوم
0المشاهدات
لا إعجاباتسجّل الدخول للإعجاب بهذه المهارة
—لم يُقيَّم بعد
تقييمك

موجز

Fetch Telegram chat message history via MTProto user API (Telethon)

الوصف

ما الذي تفعله هذه المهارة

Fetches message history from Telegram chats, groups, and forum topics using the MTProto user API via Telethon. The Telegram Bot API cannot read chat history, so this skill authenticates as a user account instead. Supports filtering by topic, pagination by message ID, and JSON output.

Unlike the Bot API, MTProto user authentication gives read access to any chat the account belongs to, including history the bot endpoint blocks entirely.

متى تستخدمها

  • Archiving old messages from a private Telegram group
  • Exporting a forum topic thread before it gets deleted
  • Paginating through thousands of messages in a large channel
  • Pulling chat logs into a local database for search
  • Reviewing message history in a group the bot API cannot access

مثال على سير العمل

الإدخال

User asks: Fetch the last 50 messages from group -1001234567890 as JSON

الوكيل
  1. 1

    Load api_id and api_hash from api_credentials.json in the skill directory

  2. 2

    Resume the saved Telethon session for the authenticated user account

  3. 3

    Call tg_history.py with the chat ID, --limit 50, and --json flags

  4. 4

    Resolve sender display names for each message

  5. 5

    Return the formatted JSON array

الإخراج

A JSON array of 50 messages with sender names, timestamps, and message text

المتطلبات

  • Telegram API credentials (api_id and api_hash) from https://my.telegram.org/apps
  • Telegram account phone number for one-time login

التثبيت

clawhub install rhlsthrm/telegram-history

شغّل أمر واجهة سطر الأوامر، أو الصق النص في Claude Code أو Cursor أو Codex أو أي وكيل برمجة تستخدمه.

الروابط