download-media について
Telegram のメッセージから写真、動画、ドキュメントなどをダウンロードするスキルです。Telegram CLI でメディア付きメッセージを探し、ファイルを保存する手順を案内します。
主な機能
- 01メッセージを確認してメディアを検索
- 02メッセージ ID によるメディアのダウンロード
- 03出力先ディレクトリの指定
- 04メッセージやメディアが見つからない場合の対処
- 05再現可能な問題に応じた手順の更新
活用シーン
- 01Telegram チャットの写真の保存
- 02メッセージ ID を指定したドキュメントのダウンロード
- 03最近のメッセージからメディアを検索
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ terrylica/ cc-skills --skill download-mediaインストール後、Claude Code で/download-mediaを入力して読み込まれたか確認します。
詳細
Telegram メディアのダウンロード
Telegram のメッセージから写真、動画、ドキュメント、その他のメディアをダウンロードします。
自己進化型スキル:このスキルは使用を重ねることで改善されます。指示が誤っている場合、パラメーターにずれが生じた場合、または回避策が必要だった場合は、後回しにせず、このファイルをすぐに修正してください。実際に再現可能な問題がある場合のみ更新してください。
事前確認
- セッションが存在する必要があります:
~/.local/share/gramjs/<profile>.session- 存在しない場合は、先に
/tlg:setupを実行してください
- 存在しない場合は、先に
使用方法
/usr/bin/env bash << 'EOF'
ROOT="$(cc-plugin-root tlg)"
SCRIPT="$ROOT/scripts/tg-cli.ts"
# Step 1: Find message ID with media
bun "$SCRIPT" read <chat> -n 10
# Step 2: Download by message ID
bun "$SCRIPT" download <chat> <message_id>
# Download to specific directory
bun "$SCRIPT" download 2124832490 471931 -o ./downloads
EOF
パラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| chat | string/int | メッセージを含むチャット |
| message_id | int | メディアを含むメッセージの ID |
-o/--output | path | 出力ディレクトリ(デフォルト:現在のディレクトリ) |
ワークフロー
read <chat> -n Nを使ってメッセージを確認し、ID を探します- メディアを含むメッセージでは、テキストに
[media/service]が表示されます download <chat> <id>を使ってファイルを保存します
エラー処理
| エラー | 原因 | 対処方法 |
|---|---|---|
message not found | 無効なメッセージ ID | 先に read で確認してください |
has no media | テキストのみのメッセージ | メディアを含むメッセージを選んでください |
実行後の振り返り
このスキルの実行後、終了する前に確認してください。
- コマンドは成功しましたか? — 成功しなかった場合は、失敗の原因となった指示またはエラーテーブルを修正してください。
- パラメーターや出力に変更はありましたか? — tg-cli.ts のインターフェースにずれが生じていた場合は、使用例とパラメーターテーブルを合わせて更新してください。
- 回避策が必要でしたか? — 別のフラグや追加の手順などで対応した場合は、次回同じ回避策が不要になるよう、この SKILL.md を更新してください。
実際に再現可能な問題がある場合のみ更新してください。推測に基づく更新はしないでください。
コメント
Markdown 対応