Agent skill

Naver Mail Imap

by bam-bam-2 in bam-bam-2/solo-skills

밤밤의 네이버 메일(you@example.com)을 브라우저 없이 읽어야 할 때 사용. An agent skill from bam-bam-2/solo-skills.

MITAuto-check: notes

Install Naver Mail Imap

skills CLI
$ npx skills add bam-bam-2/solo-skills --skill naver-mail-imap -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install bam-bam-2/solo-skills naver-mail-imap --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/bam-bam-2/solo-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/naver-mail .claude/skills/naver-mail-imap && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
naver-mail-imap
GitHub stars
367
Token cost
~964 tokens
SKILL.md length
270 words
Files
2 (incl. scripts)
Skills in repo
38
Repo updated
First seen
Licence
MIT

At a glance

밤밤의 네이버 메일(you@example.com)을 브라우저 없이 읽어야 할 때 사용. An agent skill from bam-bam-2/solo-skills.

  • SKILL.md covers 자격증명 위치, 접속, 자주 쓰는 조회 and 첨부파일, plus 2 more sections
  • Runs Python scripts from its folder; reaches bigfile.mail.naver.com; needs NAVER_MAIL_APP_PASSWORD

What it does

Naver Mail Imap is an agent skill from bam-bam-2/solo-skills. 밤밤의 네이버 메일(you@example.com)을 브라우저 없이 읽어야 할 때 사용. 네이버 웹 세션이 만료돼 로그인 화면으로 튕기거나, 메일 본문·첨부파일(대용량 첨부 포함)을 그대로 받아와야 할 때. "메일 확인해줘", "회신 왔어?" 요청에서 웹 로그인이 막히면 이 경로로 우회한다.

Its SKILL.md is about 960 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/send_naver_mail.py`).

The repository describes itself as: 1인 사업가 생산성 키트 — 직원 없이 58개를 자동화했고, 그중 바로 쓸 수 있는 AI 에이전트 스킬 38개(+실행 스크립트 19개)를 공개합니다. The licence is MIT.

Example prompts

  • “/naver-mail-imap”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 0712439. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • bigfile.mail.naver.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • NAVER_MAIL_APP_PASSWORD

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Naver Mail Imap loads about 964 tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 270 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~45
When it runs · the whole SKILL.md, loaded when a task matches
~964

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:9
    > - 계정 정보는 `.env`에서만 읽습니다. 코드에 값을 넣지 말고, **애플리케이션 비밀번호**를 발급해 쓰세요.
  • NoteMentions a .env fileSKILL.md:15
    **앱 비밀번호가 이미 `.env`에 있으므로 IMAP으로 바로 붙는 게 빠르다.**
  • NoteMentions a .env fileSKILL.md:20
    ~/Projects/getback/운영/.env
  • NoteMentions a .env fileSKILL.md:21
    ~/Projects/getback/운영/서초aict-웰커밍데이/.env
  • NoteMentions a .env fileSKILL.md:37
    for p in [Path('.env'), Path('서초aict-웰커밍데이/.env')]:

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from bam-bam-2/solo-skills at commit 0712439, republished under its MIT licence (© bam-bam-2). 270 words, ~964 tokens.

Download SKILL.mdSave it as .claude/skills/naver-mail-imap/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
naver-mail-imap
description
밤밤의 네이버 메일(you@example.com)을 브라우저 없이 읽어야 할 때 사용. 네이버 웹 세션이 만료돼 로그인 화면으로 튕기거나, 메일 본문·첨부파일(대용량 첨부 포함)을 그대로 받아와야 할 때. "메일 확인해줘", "회신 왔어?" 요청에서 웹 로그인이 막히면 이 경로로 우회한다.

이 스킬이 시스템에 하는 일 (설치 전 확인)

  • 네이버 IMAP/SMTP 서버에 접속해 메일을 읽고 보냅니다.
  • 계정 정보는 .env에서만 읽습니다. 코드에 값을 넣지 말고, 애플리케이션 비밀번호를 발급해 쓰세요.
  • 자격증명을 출력하거나 다른 파일로 복사하지 않습니다.

네이버 메일 IMAP 읽기

네이버 웹메일은 세션이 자주 만료되고, 만료되면 저장된 비밀번호가 없어 로그인 화면에서 막힌다. 앱 비밀번호가 이미 .env에 있으므로 IMAP으로 바로 붙는 게 빠르다.

자격증명 위치

~/Projects/getback/운영/.env
~/Projects/getback/운영/서초aict-웰커밍데이/.env

키 이름: NAVER_MAIL_USER, NAVER_MAIL_APP_PASSWORD (GET100 레터 발송용으로 세팅된 것)

⚠️ 값을 출력하거나 다른 파일로 복사하지 말 것. 스크립트 안에서만 읽어 쓴다.

접속

imap.naver.com:993 SSL. 표준 imaplib이면 충분하다.

python
import imaplib, email
from email.header import decode_header
from pathlib import Path

env = {}
for p in [Path('.env'), Path('서초aict-웰커밍데이/.env')]:
    if p.exists():
        for line in p.read_text().splitlines():
            if '=' in line and not line.strip().startswith('#'):
                k, v = line.split('=', 1)
                env.setdefault(k.strip(), v.strip().strip('"').strip("'"))

M = imaplib.IMAP4_SSL('imap.naver.com', 993)
M.login(env['NAVER_MAIL_USER'], env['NAVER_MAIL_APP_PASSWORD'])
M.select('INBOX')

자주 쓰는 조회

python
# 발신자로 검색 (한글 검색어는 인코딩 이슈가 있으니 이메일 주소로 찾는 게 안전)
typ, data = M.search(None, 'FROM', '"someone@example.com"')
ids = data[0].split()

# 헤더만 빠르게 (읽음 처리 안 되게 BODY.PEEK)
typ, d = M.fetch(ids[-1], '(BODY.PEEK[HEADER.FIELDS (FROM SUBJECT DATE)])')

# 전문 + 첨부
typ, d = M.fetch(ids[-1], '(RFC822)')
msg = email.message_from_bytes(d[0][1])

제목·파일명은 반드시 decode_header로 디코드한다(MIME 인코딩).

첨부파일

일반 첨부는 part.get_filename() + part.get_payload(decode=True)로 바로 저장된다.

대용량 첨부(네이버 "대용량 첨부")는 본문에 안 들어 있다. HTML 파트에서 링크를 뽑아 따로 받아야 한다.

python
import re
fids = re.findall(r'bigfile\.mail\.naver\.com/download\?fid=([^"\'&<>\s]+)', html)
# 중복 제거 후 각각:
# https://bigfile.mail.naver.com/download?fid=<urlencode한 fid>

이 링크는 REPL 전역 fetch(사용자 쿠키 사용)로 받으면 200으로 그냥 떨어진다. fid 값에 +, /, = 가 들어가므로 반드시 encodeURIComponent로 감싼다. 파일 개수가 안 맞으면 HTML에서 fid를 다시 전부 뽑아 중복 제거할 것(같은 파일이 mybox 링크로도 중복 등장한다).

첨부파일 달아 답장 보내기 (SMTP)

브라우저 없이 바로 보낼 수 있다. 스레드로 묶으려면 원본의 Message-ID를 IMAP으로 먼저 가져와 In-Reply-To·References에 넣는다. 이걸 빼면 상대 메일함에서 별도 메일로 떨어진다.

python
import smtplib, ssl, mimetypes, imaplib, email
from email.message import EmailMessage
from email.utils import formataddr, make_msgid

# 1) 원본 Message-ID 확보
M.select('INBOX', readonly=True)
typ, d = M.fetch(uid, '(BODY.PEEK[HEADER.FIELDS (MESSAGE-ID)])')
orig_id = email.message_from_bytes(d[0][1]).get('Message-ID')

# 2) 메일 조립
msg = EmailMessage()
msg['From'] = formataddr(('밤밤', USER))
msg['To'] = '상대@example.com'
msg['Subject'] = '...'
msg['Message-ID'] = make_msgid(domain='naver.com')
msg['In-Reply-To'] = orig_id
msg['References'] = orig_id
msg.set_content(body)

data = att.read_bytes()
maintype, subtype = (mimetypes.guess_type(att.name)[0] or 'application/octet-stream').split('/', 1)
msg.add_attachment(data, maintype=maintype, subtype=subtype, filename=att.name)

# 3) 발송 — 네이버는 465(SSL)로 떨어진다
s = smtplib.SMTP_SSL('smtp.naver.com', 465, context=ssl.create_default_context(), timeout=30)
s.login(USER, PW); s.send_message(msg); s.quit()

보낸 뒤 보낸메일함("Sent Messages")을 열어 파트 구조를 확인한다. BODYSTRUCTURE 정규식은 한글 파일명을 놓치는 경우가 있으니, RFC822로 받아 msg.walk() 로 돌면서 get_filename() 과 바이트 수를 직접 본다. (2026-08-28 양주시 강의계획서 발송 시 실측)

주의

  • 읽기 전용으로 쓴다. 삭제·이동은 하지 않는다.
  • 큰 메일을 연속으로 RFC822 페치하면 socket error: EOF로 연결이 끊긴다. 목록은 BODY.PEEK[HEADER.FIELDS ...]로 훑고, 전문은 필요한 건만 받는다.
  • 글자수를 셀 때 wc -m을 쓰지 않는다. 비대화형 SSH엔 로케일이 없어 한글이 바이트로 세져 약 1.9배로 부풀린다. 파이썬 len()으로 쟴 것.
  • 웹 로그인이 필요한 작업(메일 쓰기 UI, 설정 변경)은 여전히 밤밤이 직접 로그인해야 한다.

© bam-bam-2, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in skills/naver-mail of bam-bam-2/solo-skills.

  • SKILL.md
  • scripts/send_naver_mail.py

Open the folder on GitHubat commit 0712439

Compare with similar skills

Naver Mail Imap next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Naver Mail Imap compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Naver Mail Imap this skillbam-bam-2/solo-skills367—~964Automated safety check: NotesMIT
Mails So AutomationComposioHQ/awesome-claude-skills77k3 repos~734Automated safety check: PassNone
Agent Mail AutomationComposioHQ/awesome-claude-skills77k3 repos~742Automated safety check: PassNone
Zoho Mail AutomationComposioHQ/awesome-claude-skills77k3 repos~738Automated safety check: PassNone
Apple Mailmitsuhiko/agent-stuff3.2k—~669Automated safety check: PassApache-2.0
Dingtalk MailDingTalk-Real-AI/dingtalk-workspace-cli3.2k—~1.4kAutomated safety check: PassApache-2.0

Similar skills

  • Mails So Automation

    ComposioHQ/awesome-claude-skills

    Automate Mails So tasks via Rube MCP (Composio). An agent skill from ComposioHQ/awesome-claude-skills.

    77k GitHub starsUsed in 3 repos~734 tokens
    Productivity & AutomationAuto-check passed
  • Agent Mail Automation

    ComposioHQ/awesome-claude-skills

    Automate Agent Mail tasks via Rube MCP (Composio). An agent skill from ComposioHQ/awesome-claude-skills.

    77k GitHub starsUsed in 3 repos~742 tokens
    Productivity & AutomationAuto-check passed
  • Zoho Mail Automation

    ComposioHQ/awesome-claude-skills

    Automate Zoho Mail tasks via Rube MCP (Composio). An agent skill from ComposioHQ/awesome-claude-skills.

    77k GitHub starsUsed in 3 repos~738 tokens
    Productivity & AutomationAuto-check passed
  • Apple Mail

    mitsuhiko/agent-stuff

    Search, read, and extract attachments from Apple Mail's local storage.

    3.2k GitHub stars~669 tokensUpdated 13 days ago
    Auto-check passed
  • Dingtalk Mail

    DingTalk-Real-AI/dingtalk-workspace-cli

    钉钉邮箱读写、搜索、回复与转发。Use when 用户说发邮件/查邮件/回邮件/转发邮件/未读邮件/邮件搜索/邮箱附件。一句话发邮件时先用 dingtalk-contact 解析并确认收件人,再由本 skill 发送;不做钉钉消息(走 dingtalk-chat)、紧急通知(走 dingtalk-misc)。命令前缀:dws mail。

    3.2k GitHub stars~1.4k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Send Mail

    hashgraph-online/awesome-codex-plugins

    Print and mail a real postcard or letter to a US address with Sendpaper, including USPS Certified Mail with tracking and a return receipt.

    1.3k GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed

More from bam-bam-2/solo-skills

All 38 skills in this repo
  • Computer Use

    bam-bam-2/solo-skills

    Use Orca's computer-use CLI to inspect and operate local desktop app windows through accessibility trees, screenshots, and safe UI actions.

    367 GitHub starsUsed in 1 repo~915 tokens
    Auto-check passed
  • Orchestration

    bam-bam-2/solo-skills

    Use Orca orchestration for structured multi-agent coordination: threaded messages, blocking ask/reply flows, task dispatch, workerdone/escalation waits, task DAGs, decision gates, coordinator loops…

    367 GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • Book PDF Pagedjs

    bam-bam-2/solo-skills

    마크다운 원고를 실제 책처럼 보이는 PDF/EPUB 전자책으로 만들 때 사용. An agent skill from bam-bam-2/solo-skills.

    367 GitHub stars~2.5k tokensUpdated 26 days ago
    Auto-check passed
  • Lecture Recording Captions

    bam-bam-2/solo-skills

    밤밤의 강연·라이브·기수 세션 녹화본(줌 클라우드·디스코드·맥 화면기록)을 자막판 영상으로 만들고 배포할 때 읽을 것.

    367 GitHub stars~1.4k tokensUpdated 26 days ago
    Auto-check passed
  • Style Skill Creator

    bam-bam-2/solo-skills

    Creative writing skill for creating style skills that teach Claude to write in specific styles.

    367 GitHub stars~935 tokensUpdated 26 days ago
    Auto-check passed
  • Threads Long Thread

    bam-bam-2/solo-skills

    밤밤 스레드 계정에 장문 연작 타래(13~30편)를 쓰고 이미지까지 붙여 임시저장·발행할 때 읽을 것. An agent skill from bam-bam-2/solo-skills.

    367 GitHub stars~2.9k tokensUpdated 26 days ago
    Auto-check passed

Questions about Naver Mail Imap

What does Naver Mail Imap do?

밤밤의 네이버 메일(you@example.com)을 브라우저 없이 읽어야 할 때 사용. An agent skill from bam-bam-2/solo-skills. Naver Mail Imap is an agent skill from bam-bam-2/solo-skills.com)을 브라우저 없이 읽어야 할 때 사용.

How do I install Naver Mail Imap in Claude Code?

Run `npx skills add bam-bam-2/solo-skills --skill naver-mail-imap -a claude-code`. Or copy the skill folder (skills/naver-mail in bam-bam-2/solo-skills) into .claude/skills/naver-mail-imap in your project. Claude Code loads it when a task matches its description.

How do I install Naver Mail Imap in Codex?

Run `npx skills add bam-bam-2/solo-skills --skill naver-mail-imap -a codex`. Or copy the skill folder (skills/naver-mail in bam-bam-2/solo-skills) into .agents/skills/naver-mail-imap in your project. Codex loads it when a task matches its description.

Can I use Naver Mail Imap in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add bam-bam-2/solo-skills --skill naver-mail-imap -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/naver-mail-imap, .gemini/skills/naver-mail-imap, .github/skills/naver-mail-imap and .opencode/skills/naver-mail-imap in your project.

What does Naver Mail Imap need to run?

Going by SKILL.md and its folder, Naver Mail Imap needs Python for the scripts in its folder and credentials named NAVER_MAIL_APP_PASSWORD. Our summary lists: Python 3.

Does Naver Mail Imap access the network?

SKILL.md names 1 domain. In commands or code: bigfile.mail.naver.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Naver Mail Imap safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Naver Mail Imap use?

Naver Mail Imap is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Naver Mail Imap use?

About 964 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Naver Mail Imap?

Skills that share tags, products or a category with Naver Mail Imap: Mails So Automation (ComposioHQ/awesome-claude-skills, 77k stars), Agent Mail Automation (ComposioHQ/awesome-claude-skills, 77k stars), Zoho Mail Automation (ComposioHQ/awesome-claude-skills, 77k stars) and Apple Mail (mitsuhiko/agent-stuff, 3.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Naver Mail Imap?

bam-bam-2 (a GitHub user) maintains it in bam-bam-2/solo-skills, which has 367 GitHub stars. The repository holds 38 skills in this directory. The repository was last updated on September 14, 2026.

Source: bam-bam-2/solo-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.