send-media について
tg-cli.ts を使い、個人の Telegram アカウントからファイルやメディアを送信するスキルです。一般的なメディアとドキュメントに対応し、送信前に認証状態を確認します。コマンドラインのキャプションはプレーンテキストのみです。
主な機能
- 01Telegram セッションの認証確認
- 02ユーザー名、電話番号、チャット ID へのファイル送信
- 03写真、動画、音声、ドキュメントの送信
- 04ボイスメッセージや動画メッセージの送信
- 05プレーンテキストのキャプション追加
活用シーン
- 01Telegram チャットに写真やドキュメントを送信
- 02音声をボイスメッセージとして送信
- 03メディア圧縮なしで動画を送信
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/send-mediaを入力して読み込まれたか確認します。
詳細
Telegram でメディアを送信する
個人の Telegram アカウントからファイル、写真、動画、ボイスメッセージ、ドキュメントを送信します。
自己進化型スキル：このスキルは使用するほど改善されます。手順が誤っている場合、パラメーターにずれが生じている場合、または回避策が必要だった場合は、先延ばしにせず、すぐにこのファイルを修正してください。実際に再現できる問題がある場合にのみ更新します。
事前確認
セッションが存在するだけでなく、認証済みであることを確認します。
bun "$SCRIPT" check-auth
EXPIRED の場合は、最初に /tlg:setup を実行します（3 ステップの非対話型認証パターンを使用します）。
使い方：tg-cli.ts（簡単なケース）
/usr/bin/env bash << 'EOF'
ROOT="$(cc-plugin-root tlg)"
SCRIPT="$ROOT/scripts/tg-cli.ts"
# Send a photo/image (auto-detected)
bun "$SCRIPT" send-file @username /path/to/photo.jpg
# Send with caption (plain text only)
bun "$SCRIPT" send-file -1003958083153 /path/to/image.png -c "Check this out"
# Force send as document (no preview)
bun "$SCRIPT" send-file @username /path/to/image.png --document
# Send voice note
bun "$SCRIPT" send-file -1003958083153 /path/to/audio.ogg --voice
# Send round video
bun "$SCRIPT" send-file @username /path/to/video.mp4 --video-note
EOF
既知の制限：CLI 経由のキャプションはプレーンテキストのみです（HTML は使用できません）。書式付きキャプションを使う場合は、draft スキルで「Saved Messages」にメッセージを作成し、対象のチャットにコピーしてから、手動でファイルを添付してください。
パラメーター（tg-cli.ts）
| パラメーター | 型 | 説明 |
|---|---|---|
| recipient | string/int | ユーザー名、電話番号、またはチャット ID |
| file | path | ローカルファイルのパス |
-c/--caption | string | キャプションテキスト（CLI 経由ではプレーンテキストのみ） |
--voice | flag | ボイスメッセージとして送信 |
--video-note | flag | 円形動画として送信 |
--document | flag | ドキュメントとして送信（メディアプレビューなし） |
対応フォーマット
GramJS は拡張子からメディアの種類を自動検出します。フラグで上書きできます。
| 種類 | 拡張子 | 備考 |
|---|---|---|
| 写真 | jpg, png, webp | Telegram により圧縮されます |
| 動画 | mp4, mov, avi | 圧縮を避けるには --document を使用します |
| 音声 | mp3, m4a, flac | オーディオプレーヤーとして送信されます |
| ボイス | ogg (opus) | --voice フラグが必要です |
| ドキュメント | pdf, zip, md, any | ファイル添付として送信されます |
アンチパターン（絶対にしないでください）
| アンチパターン | 失敗する理由 |
|---|---|
認証を先に確認せず bun "$SCRIPT" を実行する | セッションの有効期限が切れている場合、認証に失敗します |
-c キャプションに書式付きテキストを使用する | CLI のキャプションはプレーンテキストのみです。書式付きキャプションには draft スキルを使用してください |
| 事前確認でセッションファイルの存在だけを確認する | セッションファイルが存在しても、有効期限が切れている場合があります。check-auth で確認する必要があります |
実行後の振り返り
このスキルの処理が完了したら、終了する前に確認してください。
- コマンドは成功しましたか？ — 成功しなかった場合は、失敗の原因となった手順またはエラーテーブルを修正します。
- パラメーターや出力に変更はありましたか？ — tg-cli.ts のインターフェースにずれが生じている場合は、使い方の例とパラメーターテーブルを実際に合わせて更新します。
- 回避策は必要でしたか？ — 臨機応変な対応（異なるフラグや追加手順）が必要だった場合は、次回同じ回避策が不要になるように、この SKILL.md を更新します。
実際に再現できる問題がある場合にのみ更新してください。推測による更新はしないでください。
コメント
Markdown 対応