파이썬 인스타그램 사진 다운로드 스크립트 만들기

파이썬 인스타그램 사진 다운로드 스크립트 만들기

인스타그램의 구조가 자주 바뀌고 공식 API를 쓰려면 앱 등록 및 토큰 발급 절차가 필요하기 때문에, 가장 안정적으로 사진을 다운로드할 수 있는 방법은 Instaloader 라이브러리를 사용하는 것입니다. 이 스크립트는 공개 계정은 로그인 없이, 비공개 계정은 로그인 후에 사진을 다운로드할 수 있도록 설계되어 있습니다.

아래 예제를 참고하시고, 필요에 따라 옵션을 조정하여 사용하세요.

# 먼저 Instaloader 설치
pip install instaloader

파이썬 인스타그램 사진 다운로드 스크립트 소스코드

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
instagram_downloader.py

Instaloader를 이용해 인스타그램 사진을 자동으로 다운로드하는 스크립트입니다.

Usage:
    # 공개 계정 다운로드
    python instagram_downloader.py --target naver

    # 비공개 계정 다운로드 (로그인 필요)
    python instagram_downloader.py --target your_private_account \
        --login --username your_id --password your_pw

    # 특정 게시물 URL만 다운로드
    python instagram_downloader.py --post-url https://www.instagram.com/p/CG0UU3PnR3Z/
"""

import os
import argparse
import instaloader

def download_profile(loader, username, output_dir):
    """프로필 전체 다운로드"""
    profile = instaloader.Profile.from_username(loader.context, username)
    target_dir = os.path.join(output_dir, username)
    os.makedirs(target_dir, exist_ok=True)

    print(f"[+] '{username}' 프로필에서 게시물 가져오는 중...")
    for post in profile.get_posts():
        print(f"    → {post.shortcode}", end=" ")
        loader.download_post(post, target=target_dir)
        print("완료")

def download_post(loader, post_url, output_dir):
    """단일 게시물 다운로드"""
    shortcode = post_url.rstrip("/").split("/")[-1]
    post = instaloader.Post.from_shortcode(loader.context, shortcode)
    target_dir = os.path.join(output_dir, shortcode)
    os.makedirs(target_dir, exist_ok=True)

    print(f"[+] 게시물 {shortcode} 다운로드 중...")
    loader.download_post(post, target=target_dir)
    print("완료")

def main():
    parser = argparse.ArgumentParser(
        description="Instaloader 기반 인스타그램 사진 다운로드 스크립트"
    )
    group = parser.add_mutually_exclusive_group(required=True)
    group.add_argument("--target",         help="사용자 계정명 (username)")
    group.add_argument("--post-url",       help="다운로드할 게시물 URL")
    parser.add_argument("--login",         action="store_true", help="비공개 계정 다운로드를 위해 로그인")
    parser.add_argument("--username",      help="인스타그램 로그인 아이디")
    parser.add_argument("--password",      help="인스타그램 로그인 비밀번호")
    parser.add_argument("--output-dir",    default="downloads", help="저장 폴더 (기본: downloads)")

    args = parser.parse_args()

    loader = instaloader.Instaloader(
        download_comments=False,
        save_metadata=False,
        post_metadata_txt_pattern="",  # 메타데이터 텍스트 파일 미생성
        dirname_pattern="{target}"     # 다운로드 디렉토리 패턴
    )

    # 로그인 처리
    if args.login:
        if not (args.username and args.password):
            parser.error("로그인을 사용하려면 --username 과 --password 를 모두 지정해야 합니다.")
        print("[*] 로그인 시도 중...")
        loader.login(args.username, args.password)
        print("[+] 로그인 성공")

    os.makedirs(args.output_dir, exist_ok=True)
    os.chdir(args.output_dir)

    # 실행 분기
    if args.post_url:
        download_post(loader, args.post_url, ".")
    else:
        download_profile(loader, args.target, ".")

if __name__ == "__main__":
    main()

사용방법 요약

1. Instaloader 설치
   • bashpip install instaloader
   • 복사편집
2. 스크립트 실행 권한 부여 (Linux/Mac)
   • bashchmod +x instagram_downloader.py
   • 복사편집
3. 공개 계정 전체 다운로드
   • bashpython instagram_downloader.py --target instagram_username
   • 복사편집
4. 비공개 계정 다운로드 (로그인 필요)
   • bashpython instagram_downloader.py --target private_username \ --login --username your_id --password your_pw
   • 복사편집
5. 특정 게시물(URL)만 다운로드
   • bashpython instagram_downloader.py --post-url https://www.instagram.com/p/게시물코드/
   • 복사편집

이 스크립트를 활용하면 간단한 명령어만으로 원하는 계정이나 게시물의 사진을 손쉽게 로컬에 저장할 수 있습니다. 필요에 따라 Instaloader의 추가 옵션(예: 동영상 포함, 스토리 다운로드 등)을 공식 문서에서 확인해 적용해 보세요.

o4-mini-high

나의 말:

[+] 게시물 DIgK0tCxApJ 다운로드 중...
python : Traceback (most recent call last):
위치 줄:1 문자:1
+ python instagram_downloader.py --post-url https://www.instagram.com/p ...
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : NotSpecified: (Traceback (most recent call last)::String) [], RemoteException
    + FullyQualifiedErrorId : NativeCommandError

  File "D:\WorkPY\InstaDownload\instagram_downloader.py", line 86, in <module>
    main()
    ~~~~^^
  File "D:\WorkPY\InstaDownload\instagram_downloader.py", line 81, in main
    download_post(loader, args.post_url, ".")
    ~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "D:\WorkPY\InstaDownload\instagram_downloader.py", line 44, in download_post
    loader.download_post(post, target=target_dir)
    ~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\hidec\AppData\Local\Programs\Python\Python313\Lib\site-packages\instaloader\instaloader.py", line 745, in download_post
    downloaded &= self.download_pic(filename=sidecar_filename, url=sidecar_node.display_url,
                  ~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
                                    mtime=post.date_local, filename_suffix=suffix)
                                    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\hidec\AppData\Local\Programs\Python\Python313\Lib\site-packages\instaloader\instaloader.py", line 97, in call
    return func(instaloader, *args, **kwargs)
  File "C:\Users\hidec\AppData\Local\Programs\Python\Python313\Lib\site-packages\instaloader\instaloader.py", line 356, in download_pic
    self.context.write_raw(resp, filename)
    ~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^
  File "C:\Users\hidec\AppData\Local\Programs\Python\Python313\Lib\site-packages\instaloader\instaloadercontext.py", line 657, in write_raw
    self.log(filename, end=' ', flush=True)
    ~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "C:\Users\hidec\AppData\Local\Programs\Python\Python313\Lib\site-packages\instaloader\instaloadercontext.py", line 141, in log
    print(*msg, sep=sep, end=end, flush=flush)
    ~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
UnicodeEncodeError: 'cp949' codec can't encode character '\u2024' in position 0: illegal multibyte sequence

ChatGPT의 말:

5초 동안 생각함

인코딩 문제는 Windows 콘솔의 기본 cp949 인코딩이 U+2024(․) 같은 유니코드 문자를 처리하지 못해서 발생하는 에러입니다. 가장 간단한 해결책은 스크립트 최상단에서 stdout/stderr 의 인코딩을 UTF-8 로 재구성해 주는 것입니다. 아래 패치를 적용해 보세요.

 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
 """
 instagram_downloader.py
@@
 import os
 import argparse
 import instaloader
+import sys

+### Windows 콘솔에서도 유니코드 깨짐 없이 출력되도록 stdout/stderr 인코딩 재구성 ###
+try:
+    # Python 3.7 이상
+    sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+    sys.stderr.reconfigure(encoding="utf-8", errors="replace")
+except AttributeError:
+    # 하위 호환
+    import io
+    sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding="utf-8", errors="replace")
+    sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding="utf-8", errors="replace")
+
 def download_profile(loader, username, output_dir):
     """프로필 전체 다운로드"""
     profile = instaloader.Profile.from_username(loader.context, username)

이렇게 하면 loader.context.log() 나 일반 print() 호출 시에도 UTF-8로 안전하게 출력되어 더 이상 cp949 codec 에러가 발생하지 않습니다.

–––

추가 팁

파이썬 실행 시 -X utf8 플래그를 주면(python -X utf8 instagram_downloader.py …) 전체 I/O에 UTF-8 모드를 강제로 사용할 수도 있습니다.

• Windows 터미널(또는 PowerShell)에서 chcp 65001 명령으로 콘솔 인코딩을 UTF-8 로 변경한 뒤 실행해도 동일한 효과를 볼 수 있습니다.