Instaloader: Instagram 다운로더 완전 가이드 - 사진, 동영상, 메타데이터까지
⏱️ 예상 읽기 시간: 16분
개요
Instaloader는 Instagram 콘텐츠를 효율적으로 다운로드할 수 있는 Python 기반 오픈소스 도구입니다. GitHub 10.5k개의 스타를 받은 이 도구는 사진, 동영상뿐만 아니라 캡션, 댓글, 지오태그, 메타데이터까지 포괄적으로 수집할 수 있어 연구, 백업, OSINT 등 다양한 목적으로 활용됩니다.
🎯 Instaloader의 핵심 가치
- 포괄적 다운로드: 사진, 동영상, 스토리, 하이라이트, 메타데이터 수집
- 자동화: 중단된 다운로드 재개, 프로필 이름 변경 자동 감지
- 유연성: 세밀한 필터링과 저장 위치 커스터마이징
- 안정성: MIT 라이선스의 안정적인 오픈소스 프로젝트
- 확장성: Python API로 커스텀 스크립트 개발 가능
Instaloader란 무엇인가?
🚀 Instagram 데이터 수집의 완전한 솔루션
Instaloader는 단순한 이미지 다운로더를 넘어선 종합적인 Instagram 데이터 수집 플랫폼입니다:
Instagram 콘텐츠 → Instaloader 수집 → 구조화된 로컬 저장 → 분석/백업/연구
🏗️ 현대적 아키텍처
Python 기반 설계:
- 크로스 플랫폼 지원 (Windows, macOS, Linux)
- Requests 라이브러리 기반 안정적인 HTTP 통신
- JSON 기반 메타데이터 저장
지능적 다운로드 시스템:
- 중복 다운로드 방지
- 네트워크 오류 자동 재시도
- 속도 제한 자동 조절
📊 지원하는 콘텐츠 유형
| 콘텐츠 유형 | 설명 | 지원 여부 |
|---|---|---|
| 프로필 게시물 | 공개/비공개 프로필의 모든 게시물 | ✅ |
| 스토리 | 24시간 임시 콘텐츠 (로그인 필요) | ✅ |
| 하이라이트 | 저장된 스토리 모음 | ✅ |
| 해시태그 | 특정 해시태그의 인기/최신 게시물 | ✅ |
| 위치 태그 | 지역별 게시물 | ✅ |
| 피드 | 개인 피드 (로그인 필요) | ✅ |
| 저장된 게시물 | 북마크한 게시물 (로그인 필요) | ✅ |
시스템 요구사항
🖥️ 기본 환경
필수 요구사항:
- Python: 3.8 이상 (3.10+ 권장)
- pip: Python 패키지 관리자
- 인터넷 연결: 안정적인 네트워크 환경
- 저장 공간: 다운로드할 콘텐츠 양에 따라 가변
권장 환경:
- 메모리: 4GB 이상 (대량 다운로드 시)
- CPU: 멀티코어 (병렬 처리 최적화)
- 네트워크: 고속 인터넷 (다운로드 속도 향상)
🐍 Python 환경 확인
# Python 버전 확인 (3.8 이상 필요)
python3 --version
# pip 버전 확인
pip3 --version
# 가상 환경 생성 (권장)
python3 -m venv instaloader-env
source instaloader-env/bin/activate # macOS/Linux
# instaloader-env\Scripts\activate # Windows
설치 및 초기 설정
1단계: Instaloader 설치
pip를 통한 설치 (권장):
# 최신 안정 버전 설치
pip3 install instaloader
# 개발 버전 설치 (고급 사용자)
pip3 install git+https://github.com/instaloader/instaloader.git
패키지 관리자를 통한 설치:
# Homebrew (macOS)
brew install instaloader
# Arch Linux
yay -S instaloader
# Ubuntu/Debian (snap)
sudo snap install instaloader
2단계: 설치 확인
# 설치 확인
instaloader --version
# 기본 도움말 확인
instaloader --help
# 사용 가능한 옵션 전체 보기
instaloader --help | less
3단계: 작업 디렉토리 설정
# 전용 작업 디렉토리 생성
mkdir -p ~/Instagram-Downloads
cd ~/Instagram-Downloads
# 다운로드 구조 확인
ls -la
핵심 기능 상세 가이드
📷 기본 프로필 다운로드
공개 프로필 다운로드
# 기본 사용법
instaloader username
# 예시: Instagram 공식 계정 다운로드
instaloader instagram
# 여러 프로필 동시 다운로드
instaloader profile1 profile2 profile3
다운로드 구조:
username/
├── 2025-08-15_12-30-45_UTC.jpg # 이미지 파일
├── 2025-08-15_12-30-45_UTC.mp4 # 비디오 파일
├── 2025-08-15_12-30-45_UTC.txt # 캡션 텍스트
├── 2025-08-15_12-30-45_UTC.json.xz # 메타데이터 (압축)
└── profile_pic.jpg # 프로필 사진
프로필 업데이트
# 빠른 업데이트 (첫 기존 파일까지만)
instaloader --fast-update username
# 타임스탬프 기반 업데이트
instaloader --latest-stamps -- username
# 특정 날짜 이후 게시물만
instaloader --post-filter="date_utc >= datetime(2024, 1, 1)" username
🔐 비공개 프로필 및 고급 기능
로그인 및 인증
# 로그인하여 다운로드
instaloader --login=your_username target_username
# 2단계 인증 지원
# SMS 또는 앱 인증 코드 입력
# 세션 파일 위치 확인
ls ~/.config/instaloader/
# 또는
ls /tmp/instaloader_*
고화질 다운로드
# 로그인 시 고화질 이미지 다운로드
instaloader --login=your_username --fast-update instagram
# 원본 해상도 강제 다운로드
instaloader --no-compress --login=your_username profile
📱 스토리 및 하이라이트
스토리 다운로드
# 특정 사용자의 현재 스토리
instaloader --stories username
# 내 피드의 모든 스토리
instaloader --login=your_username :stories
# 스토리만 다운로드 (게시물 제외)
instaloader --stories --no-posts username
하이라이트 다운로드
# 사용자의 모든 하이라이트
instaloader --highlights username
# 특정 하이라이트만
instaloader --highlights --highlight-title="Travel" username
🏷️ 해시태그 및 위치 기반 다운로드
해시태그 다운로드
# 인기 해시태그 게시물
instaloader "#nature"
# 최신 해시태그 게시물
instaloader --post-filter="not post.is_sponsored" "#travel"
# 다중 해시태그
instaloader "#photography" "#landscape" "#sunset"
위치 기반 다운로드
# 특정 위치의 게시물 (location ID 필요)
instaloader %location_id
# 예시: 에펠탑 (ID: 6889842)
instaloader %6889842
🎯 고급 필터링
날짜 기반 필터링
# 특정 날짜 범위
instaloader --post-filter="datetime(2024,1,1) <= date_utc < datetime(2024,12,31)" username
# 최근 30일
instaloader --post-filter="date_utc >= datetime.now() - timedelta(days=30)" username
# 특정 연도만
instaloader --post-filter="date_utc.year == 2024" username
콘텐츠 유형 필터링
# 비디오만 다운로드
instaloader --post-filter="post.is_video" username
# 이미지만 다운로드
instaloader --post-filter="not post.is_video" username
# 특정 좋아요 수 이상
instaloader --post-filter="post.likes >= 1000" username
# 캐러셀 게시물만
instaloader --post-filter="post.typename == 'GraphSidecar'" username
macOS에서 실제 테스트 결과
실제로 macOS에서 Instaloader를 테스트한 결과를 공유합니다.
테스트 환경
# 시스템 정보
macOS: Sonoma 14.0+
Python: 3.12.8
pip: 24.3.1
Instaloader: 4.14.2
실행 결과
설치 과정:
$ pip3 install instaloader
Collecting instaloader
Downloading instaloader-4.14.2-py3-none-any.whl (67 kB)
Successfully installed instaloader-4.14.2
다운로드 테스트:
$ cd ~/instaloader-test
$ instaloader --count=12 instagram
# 실행 결과
Stored ID 25025320 for profile instagram.
[1/1] Downloading profile instagram
# 다운로드된 파일들
이미지 파일: 30개
비디오 파일: 16개
메타데이터 파일: 13개
# 샘플 캡션 내용
$ cat instagram/2025-08-04_18-59-37_UTC.txt
Unbothered, in my lane.
#InTheMoment
Video by @colettekomm
Music by @hauteandfreddy
파일 구조:
instagram/
├── 2022-05-16_16-00-20_UTC_profile_pic.jpg
├── 2025-08-14_15-57-53_UTC.jpg
├── 2025-08-14_15-57-53_UTC.mp4
├── 2025-08-14_15-57-53_UTC.txt
├── 2025-08-14_15-57-53_UTC.json.xz
└── ...
테스트 자동화 스크립트
#!/bin/bash
# instaloader-test.sh
echo "🚀 Instaloader 테스트 스크립트"
echo "=============================="
# 1. 환경 확인
echo "📋 환경 확인..."
python3 --version
pip3 --version
# 2. Instaloader 설치 확인
if command -v instaloader &> /dev/null; then
echo "✅ Instaloader 설치됨: $(instaloader --version)"
else
echo "📦 Instaloader 설치 중..."
pip3 install instaloader
fi
# 3. 테스트 디렉토리 생성
TEST_DIR="$HOME/instaloader-test-$(date +%Y%m%d-%H%M%S)"
mkdir -p "$TEST_DIR"
cd "$TEST_DIR"
echo "📁 테스트 디렉토리: $TEST_DIR"
# 4. 공개 프로필 테스트 (소량)
echo "🔍 공개 프로필 테스트 시작..."
timeout 120 instaloader --count=5 instagram 2>&1 | tee download.log
# 5. 결과 분석
if [ -d "instagram" ]; then
echo "✅ 다운로드 성공!"
echo "📊 다운로드 통계:"
echo " 이미지: $(find instagram/ -name "*.jpg" | wc -l)개"
echo " 비디오: $(find instagram/ -name "*.mp4" | wc -l)개"
echo " 메타데이터: $(find instagram/ -name "*.json.xz" | wc -l)개"
# 샘플 파일 정보
echo "📄 샘플 캡션:"
find instagram/ -name "*.txt" | head -1 | xargs cat
else
echo "❌ 다운로드 실패"
cat download.log
fi
echo ""
echo "🎉 테스트 완료!"
echo "디렉토리: $TEST_DIR"
실전 활용 예제
예제 1: 백업 자동화
#!/usr/bin/env python3
# backup_instagram.py
import instaloader
from datetime import datetime, timedelta
import os
class InstagramBackup:
def __init__(self, username, password=None):
self.loader = instaloader.Instaloader()
self.username = username
if password:
self.loader.login(username, password)
def backup_profile(self, target_profile, days_back=30):
"""특정 프로필을 백업"""
try:
profile = instaloader.Profile.from_username(
self.loader.context, target_profile
)
# 최근 N일간의 게시물만 다운로드
since = datetime.now() - timedelta(days=days_back)
print(f"📥 {target_profile} 백업 시작...")
for post in profile.get_posts():
if post.date_utc < since:
break
print(f"다운로드 중: {post.date_utc}")
self.loader.download_post(post, target=target_profile)
print(f"✅ {target_profile} 백업 완료")
except Exception as e:
print(f"❌ 오류: {e}")
def backup_stories(self, target_profile):
"""스토리 백업"""
try:
profile = instaloader.Profile.from_username(
self.loader.context, target_profile
)
print(f"📱 {target_profile} 스토리 백업 중...")
for story in self.loader.get_stories([profile.userid]):
for item in story.get_items():
self.loader.download_storyitem(item, target=target_profile)
print(f"✅ 스토리 백업 완료")
except Exception as e:
print(f"❌ 스토리 백업 오류: {e}")
# 사용 예시
if __name__ == "__main__":
# 백업 인스턴스 생성
backup = InstagramBackup("your_username", "your_password")
# 특정 프로필 백업
backup.backup_profile("target_profile", days_back=7)
# 스토리 백업
backup.backup_stories("target_profile")
예제 2: 해시태그 모니터링
#!/usr/bin/env python3
# hashtag_monitor.py
import instaloader
import json
from datetime import datetime
class HashtagMonitor:
def __init__(self):
self.loader = instaloader.Instaloader()
def monitor_hashtag(self, hashtag, max_posts=50):
"""해시태그 모니터링 및 분석"""
hashtag_obj = instaloader.Hashtag.from_name(
self.loader.context, hashtag
)
posts_data = []
print(f"🏷️ #{hashtag} 모니터링 시작...")
for index, post in enumerate(hashtag_obj.get_posts()):
if index >= max_posts:
break
post_info = {
'shortcode': post.shortcode,
'date': post.date_utc.isoformat(),
'likes': post.likes,
'comments': post.comments,
'caption': post.caption[:100] if post.caption else '',
'owner': post.owner_username,
'is_video': post.is_video,
'url': f"https://instagram.com/p/{post.shortcode}/"
}
posts_data.append(post_info)
print(f"[{index+1}/{max_posts}] @{post.owner_username}: {post.likes} likes")
# JSON 파일로 저장
filename = f"hashtag_{hashtag}_{datetime.now().strftime('%Y%m%d_%H%M%S')}.json"
with open(filename, 'w', encoding='utf-8') as f:
json.dump(posts_data, f, ensure_ascii=False, indent=2)
print(f"✅ 데이터 저장됨: {filename}")
# 간단한 통계
total_likes = sum(post['likes'] for post in posts_data)
total_comments = sum(post['comments'] for post in posts_data)
video_count = sum(1 for post in posts_data if post['is_video'])
print(f"""
📊 #{hashtag} 통계:
- 총 게시물: {len(posts_data)}개
- 총 좋아요: {total_likes:,}개
- 총 댓글: {total_comments:,}개
- 비디오: {video_count}개 ({video_count/len(posts_data)*100:.1f}%)
- 평균 좋아요: {total_likes/len(posts_data):.1f}개
""")
# 사용 예시
if __name__ == "__main__":
monitor = HashtagMonitor()
monitor.monitor_hashtag("photography", max_posts=100)
예제 3: 콘텐츠 분석 대시보드
#!/usr/bin/env python3
# content_analyzer.py
import instaloader
import matplotlib.pyplot as plt
import pandas as pd
from datetime import datetime, timedelta
from collections import Counter
class ContentAnalyzer:
def __init__(self):
self.loader = instaloader.Instaloader()
def analyze_profile(self, username, max_posts=100):
"""프로필 콘텐츠 분석"""
profile = instaloader.Profile.from_username(
self.loader.context, username
)
posts_data = []
print(f"📊 @{username} 분석 시작...")
for index, post in enumerate(profile.get_posts()):
if index >= max_posts:
break
posts_data.append({
'date': post.date_utc,
'likes': post.likes,
'comments': post.comments,
'is_video': post.is_video,
'caption_length': len(post.caption) if post.caption else 0,
'hashtag_count': post.caption.count('#') if post.caption else 0
})
df = pd.DataFrame(posts_data)
# 기본 통계
print(f"""
📈 @{username} 기본 통계:
- 분석된 게시물: {len(df)}개
- 평균 좋아요: {df['likes'].mean():.1f}개
- 평균 댓글: {df['comments'].mean():.1f}개
- 비디오 비율: {(df['is_video'].sum() / len(df) * 100):.1f}%
- 평균 캡션 길이: {df['caption_length'].mean():.1f}자
""")
# 시각화
self.create_visualizations(df, username)
def create_visualizations(self, df, username):
"""데이터 시각화"""
fig, axes = plt.subplots(2, 2, figsize=(15, 10))
fig.suptitle(f'@{username} Content Analysis', fontsize=16)
# 1. 시간별 좋아요 추이
df_sorted = df.sort_values('date')
axes[0, 0].plot(df_sorted['date'], df_sorted['likes'])
axes[0, 0].set_title('Likes Over Time')
axes[0, 0].tick_params(axis='x', rotation=45)
# 2. 좋아요 vs 댓글 상관관계
axes[0, 1].scatter(df['likes'], df['comments'], alpha=0.6)
axes[0, 1].set_xlabel('Likes')
axes[0, 1].set_ylabel('Comments')
axes[0, 1].set_title('Likes vs Comments')
# 3. 콘텐츠 유형별 성과
video_likes = df[df['is_video']]['likes'].mean()
photo_likes = df[~df['is_video']]['likes'].mean()
axes[1, 0].bar(['Photos', 'Videos'], [photo_likes, video_likes])
axes[1, 0].set_title('Average Likes by Content Type')
axes[1, 0].set_ylabel('Average Likes')
# 4. 캡션 길이 분포
axes[1, 1].hist(df['caption_length'], bins=20, alpha=0.7)
axes[1, 1].set_title('Caption Length Distribution')
axes[1, 1].set_xlabel('Caption Length (characters)')
axes[1, 1].set_ylabel('Frequency')
plt.tight_layout()
# 파일 저장
filename = f"{username}_analysis_{datetime.now().strftime('%Y%m%d_%H%M%S')}.png"
plt.savefig(filename, dpi=300, bbox_inches='tight')
print(f"📊 분석 차트 저장됨: {filename}")
plt.show()
# 사용 예시
if __name__ == "__main__":
analyzer = ContentAnalyzer()
analyzer.analyze_profile("instagram", max_posts=50)
고급 설정 및 최적화
성능 튜닝
# ~/.config/instaloader/settings.json
{
"download_comments": true,
"download_geotags": true,
"save_metadata": true,
"compress_json": true,
"max_connection_attempts": 3,
"request_timeout": 300,
"rate_controller": "default"
}
커스텀 파일명 패턴
# custom_naming.py
import instaloader
loader = instaloader.Instaloader(
filename_pattern='{date_utc:%Y-%m-%d}_{profile}_{shortcode}',
dirname_pattern='{profile}/{date_utc:%Y}/{date_utc:%m}'
)
# 결과: profile/2025/08/2025-08-15_username_ABC123.jpg
프록시 및 네트워크 설정
# proxy_setup.py
import instaloader
# 프록시 설정
session = instaloader.requests.Session()
session.proxies = {
'http': 'http://proxy.example.com:8080',
'https': 'https://proxy.example.com:8080'
}
loader = instaloader.Instaloader(session=session)
zshrc Aliases 설정
개발 효율성을 높이기 위한 유용한 alias들을 설정해보겠습니다:
# ~/.zshrc에 추가할 Instaloader 관련 alias들
# 기본 다운로드 단축 명령어
alias il="instaloader"
alias ilfast="instaloader --fast-update"
alias illogin="instaloader --login"
# 자주 사용하는 옵션 조합
alias il-stories="instaloader --stories"
alias il-highlights="instaloader --highlights"
alias il-recent="instaloader --count=10"
alias il-metadata="instaloader --metadata-json"
# 특화 기능들
alias il-hashtag='function _hashtag(){ instaloader "#$1"; }; _hashtag'
alias il-backup='function _backup(){ instaloader --login=$USER "$1"; }; _backup'
alias il-update='function _update(){ instaloader --fast-update "$1"; }; _update'
# 프로젝트 관리
alias il-dir="cd ~/Instagram-Downloads"
alias il-clean="find ~/Instagram-Downloads -name '*.tmp' -delete"
alias il-stats='function _stats(){ find "$1" -name "*.jpg" | wc -l | xargs echo "Images:"; find "$1" -name "*.mp4" | wc -l | xargs echo "Videos:"; }; _stats'
# 로그 및 모니터링
alias il-log="tail -f ~/Instagram-Downloads/instaloader.log"
alias il-size="du -sh ~/Instagram-Downloads/*"
alias il-errors="grep -r ERROR ~/Instagram-Downloads/ | tail -10"
# 유용한 조합 함수들
alias il-profile-info='function _info(){ instaloader --profile-info-only "$1"; }; _info'
alias il-count='function _count(){ instaloader --count="$1" "$2"; }; _count'
alias il-since='function _since(){ instaloader --post-filter="date_utc >= datetime(2024,$1,1)" "$2"; }; _since'
alias 적용 및 사용법
# 1. zshrc 파일 편집
nano ~/.zshrc
# 2. 위의 alias들을 파일 끝에 추가
# 3. 변경사항 적용
source ~/.zshrc
# 4. alias 사용 예시
il-recent instagram # 최근 10개 게시물
il-hashtag travel # #travel 해시태그
il-backup username # 로그인하여 백업
il-stats ~/Instagram-Downloads/username # 통계 확인
보안 및 윤리적 고려사항
중요한 보안 주의사항
1. 계정 보안:
# 강력한 2단계 인증 사용
# 세션 파일 보안 관리
chmod 600 ~/.config/instaloader/session-*
# 정기적인 세션 갱신
rm ~/.config/instaloader/session-*
2. 개인정보 보호:
# 다운로드한 데이터 암호화
zip -e backup.zip ~/Instagram-Downloads/username/
# 메타데이터에서 개인정보 제거
jq 'del(.location)' metadata.json > clean_metadata.json
윤리적 사용 가이드라인
- 저작권 준수: 다운로드한 콘텐츠의 개인적 사용만
- 프라이버시 존중: 타인의 사생활 침해 금지
- 플랫폼 정책: Instagram 이용약관 준수
- 적절한 사용: 연구, 백업, 아카이빙 목적으로만 사용
트러블슈팅
자주 발생하는 문제들
1. 로그인 실패
# 해결 방법
# 1. 2단계 인증 설정 확인
# 2. 앱 비밀번호 사용
# 3. 세션 파일 삭제 후 재로그인
rm ~/.config/instaloader/session-*
2. 다운로드 속도 저하
# 원인: Instagram 속도 제한
# 해결 방법:
instaloader --slide=10 username # 요청 간격 증가
3. 403/401 오류
# 원인: 과도한 요청 또는 IP 제한
# 해결 방법:
# 1. 잠시 대기 (15-30분)
# 2. 프록시 사용
# 3. 요청 빈도 줄이기
4. 메모리 부족
# 대용량 프로필 다운로드 시
instaloader --no-metadata-json --no-captions username
결론
Instaloader는 Instagram 콘텐츠 수집과 백업을 위한 가장 강력하고 포괄적인 도구 중 하나입니다. 단순한 이미지 다운로더를 넘어서 메타데이터, 댓글, 스토리까지 포함한 완전한 아카이빙 솔루션을 제공하며, Python의 확장성을 통해 무한한 커스터마이징이 가능합니다.
🎯 핵심 장점 요약
- 포괄적 수집: 모든 유형의 Instagram 콘텐츠 지원
- 높은 안정성: 중단 재개, 오류 처리, 속도 제한 대응
- 메타데이터 보존: 완전한 컨텍스트 정보 보관
- 확장 가능성: Python API를 통한 무제한 커스터마이징
🚀 활용 분야
- 개인 백업: 소중한 추억과 콘텐츠 보관
- 연구 분야: 소셜 미디어 분석 및 학술 연구
- 마케팅: 경쟁사 분석 및 트렌드 파악
- OSINT: 공개 정보 수집 및 조사
⚖️ 책임감 있는 사용
Instaloader는 강력한 도구인 만큼 윤리적이고 법적인 사용이 중요합니다. 개인정보 보호, 저작권 존중, 플랫폼 정책 준수를 통해 건전한 디지털 환경 조성에 기여해야 합니다.
지금 바로 Instaloader를 설치해서 Instagram 콘텐츠 수집의 새로운 차원을 경험해보세요! 🚀
관련 글: