InstaDownload — Telegram用Instagramダウンローダー
概要
InstaDownloadは、TelegramのWebhookを利用してInstagramの公開メディア(リール、投稿、ストーリーなど)をダウンロードしてユーザーに返すことを目的とした軽量なボット実装です。メインは単一のPHPスクリプトで構成されており、シンプルなアーキテクチャで素早くデプロイできる点が特徴です。外部ライブラリや複雑なセットアップを最小限に抑え、セルフホストや小規模な環境でも運用しやすく設計されています。
リポジトリの統計情報
- スター数: 2
- フォーク数: 0
- ウォッチャー数: 2
- コミット数: 5
- ファイル数: 3
- メインの言語: PHP
主な特徴
- TelegramのWebhookを利用した軽量なボット(PHP単一ファイルで完結)。
- Instagramの公開メディア(Reels、投稿、ストーリーなど)を解析してダウンロード。
- 最小限の依存で自己ホストしやすい設計。
- シンプルなコードベースでカスタマイズや拡張が容易。
技術的なポイント
InstaDownloadはシンプルさを優先した設計です。bot.phpがWebhookからの更新(メッセージやURL)を受け取り、受信したInstagramリンクからメディアの取得処理を行います。メディア取得はInstagramの公開ページをパースするか、公開APIに相当するエンドポイントからメタ情報(動画/画像の直リンク)を抽出するパターンが想定されます。PHP実装のため、標準的なHTTPクライアント(file_get_contentsやcURL)を用いたネットワークリクエストで外部リソースにアクセスします。
Telegram側とはBot APIを通して通信し、取得したメディアはBot APIのsendMessage/sendMediaGroup/sendVideoなど適切なエンドポイントを使ってユーザーに返します。Webhook方式により常時ポーリングする必要がなく、HTTPS対応の公開URLがあれば即座に利用可能です。実装が最小限であるため、追加のキャッシュや並列ダウンロード、再試行ロジックは標準で含まれていない場合が多く、拡張によって安定性やスループットを改善できます。
運用面では、HTTPS(有効なTLS証明書)を持つサーバ、Botトークンや必要に応じてプロキシ設定、タイムアウトやユーザー入力のバリデーションが求められます。またInstagramの仕様変更やアクセス制限に弱いため、取得ロジックは保守が必要です。ライセンスはリポジトリ内に含まれており、コードをベースに改修・再配布する際の条件を確認してください。
使い方とデプロイのポイント
- 必要環境:PHPが動作するWebサーバ(Apache/Nginx + PHP-FPM等)とHTTPS対応の公開ドメイン。
- 設定手順(概略):
- GitHubからリポジトリをクローンまたはファイルをアップロード。
- bot.php内にBotトークンや必要な設定(Webhookのシークレットなど)を反映。
- TelegramのsetWebhook APIでbot.phpを指すHTTPS URLを登録。
- テスト用にTelegramでBotにInstagramの公開URLを送信して動作確認。
- 推奨デプロイ先:小規模なら共有ホスティングやVPS、堅牢性が必要ならクラウドVM。HTTPS必須なので、Let’s Encrypt等で証明書を取得してください。
- 拡張ポイント:メディアキャッシュ(同じURLの再取得を避ける)、並列ダウンロード、ファイルサイズチェック、ユーザーごとの利用制限(レートリミット)などを実装すると運用が安定します。
制限と注意点
- Instagramの非公開アカウントのメディアは取得できません(ログイン必須の挙動は含まれていないため)。
- Instagramの仕様変更やアクセス制限(Bot対策)により突発的に動作が停止する可能性があります。
- 法的・利用規約上の制約:コンテンツのダウンロードは投稿者の権利やInstagramの利用規約に抵触する場合があります。運用前に利用規約と法的リスクを確認してください。
- セキュリティ:Webhookのエンドポイントは公開されるため、Botトークンの管理、入力のバリデーション、過度なリクエスト防止(レート制御)が必要です。
プロジェクトの構成
主要なファイルとディレクトリ:
- LICENSE: file
- README.md: file
- bot.php: file
まとめ
シンプルで導入が容易なTelegram向けInstagramダウンロードボット。自己ホストに向く設計。
リポジトリ情報:
- 名前: InstaDownload
- 説明: Telegram webhook bot for downloading Instagram reels, posts, and stories. Minimalistic and easy to use.
- スター数: 2
- 言語: PHP
- URL: https://github.com/ismoiloffS/InstaDownload
- オーナー: ismoiloffS
- アバター: https://avatars.githubusercontent.com/u/100704809?v=4
READMEの抜粋:
Instagram Downloader telegram bot
A Telegram webhook-based bot designed to download Instagram reels, posts, stories, and additional media. Developed with a simple, efficient architecture.
@instaISMbot
📜 ChangeLog
·